@ttt-productions/q-core 0.1.3 → 0.1.5

package/dist/paths/collection-refs.js

@@ -23,6 +23,7 @@ export const COLLECTION_REFS = {
     signedWaivers: () => [COLLECTIONS.SIGNED_WAIVERS],
     hardwareLoanContracts: () => [COLLECTIONS.HARDWARE_LOAN_CONTRACTS],
     awardDefinitions: () => [COLLECTIONS.AWARD_DEFINITIONS],
+    awardGroupGrants: () => [COLLECTIONS.AWARD_GROUP_GRANTS],
     statsValidationReports: () => [COLLECTIONS.STATS_VALIDATION_REPORTS],
     statsOperations: () => [COLLECTIONS.STATS_OPERATIONS],
     migrationActionRuns: () => [COLLECTIONS.MIGRATION_ACTION_RUNS],

package/dist/paths/collection-refs.js.map

@@ -1 +1 @@
-{"version":3,"file":"collection-refs.js","sourceRoot":"","sources":["../../src/paths/collection-refs.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,8DAA8D;AAC9D,kEAAkE;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;IACzD,WAAW,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACvD,oBAAoB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC;IAC1E,kBAAkB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC;IACrE,oBAAoB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC;IAC1E,YAAY,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;IACzD,WAAW,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACvD,kBAAkB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC;IACtE,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC;IAClE,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC;IAClE,qBAAqB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC;IAC5E,UAAU,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC;IACrD,aAAa,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC;IAC3D,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,aAAa,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC;IAC3D,qBAAqB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC;IAC5E,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC;IACjE,sBAAsB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC;IAC9E,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,mBAAmB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC;IACxE,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,YAAY,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;IACzD,kBAAkB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC;IACrE,WAAW,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACvD,wBAAwB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC;IAClF,wBAAwB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC;IAClF,sBAAsB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC;IAC7E,0BAA0B,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC;CAC/E,CAAC","sourcesContent":["// Collection reference builders — for collection-level operations.\n//\n// Frontend: collection(db, ...COLLECTION_REFS.userProfiles())\n// Backend:  db.collection(toPath(COLLECTION_REFS.userProfiles()))\n\nimport { COLLECTIONS } from './collections.js';\n\nexport const COLLECTION_REFS = {\n  userProfiles: (): [string] => [COLLECTIONS.USER_PROFILES],\n  publicUsers: (): [string] => [COLLECTIONS.PUBLIC_USERS],\n  statusReconcileQueue: (): [string] => [COLLECTIONS.STATUS_RECONCILE_QUEUE],\n  registrationStarts: (): [string] => [COLLECTIONS.REGISTRATION_STARTS],\n  reservedDisplayNames: (): [string] => [COLLECTIONS.RESERVED_DISPLAY_NAMES],\n  sportLeagues: (): [string] => [COLLECTIONS.SPORT_LEAGUES],\n  leagueTeams: (): [string] => [COLLECTIONS.LEAGUE_TEAMS],\n  leagueTeamContacts: (): [string] => [COLLECTIONS.LEAGUE_TEAM_CONTACTS],\n  teamMemberships: (): [string] => [COLLECTIONS.TEAM_MEMBERSHIPS],\n  teamInvitations: (): [string] => [COLLECTIONS.TEAM_INVITATIONS],\n  teamJoinRequests: (): [string] => [COLLECTIONS.TEAM_JOIN_REQUESTS],\n  leagueFreeAgents: (): [string] => [COLLECTIONS.LEAGUE_FREE_AGENTS],\n  membershipRosterSyncs: (): [string] => [COLLECTIONS.MEMBERSHIP_ROSTER_SYNCS],\n  sportGames: (): [string] => [COLLECTIONS.SPORT_GAMES],\n  gameLocations: (): [string] => [COLLECTIONS.GAME_LOCATIONS],\n  waiverTemplates: (): [string] => [COLLECTIONS.WAIVER_TEMPLATES],\n  signedWaivers: (): [string] => [COLLECTIONS.SIGNED_WAIVERS],\n  hardwareLoanContracts: (): [string] => [COLLECTIONS.HARDWARE_LOAN_CONTRACTS],\n  awardDefinitions: (): [string] => [COLLECTIONS.AWARD_DEFINITIONS],\n  statsValidationReports: (): [string] => [COLLECTIONS.STATS_VALIDATION_REPORTS],\n  statsOperations: (): [string] => [COLLECTIONS.STATS_OPERATIONS],\n  migrationActionRuns: (): [string] => [COLLECTIONS.MIGRATION_ACTION_RUNS],\n  galleryPictures: (): [string] => [COLLECTIONS.GALLERY_PICTURES],\n  pendingMedia: (): [string] => [COLLECTIONS.PENDING_MEDIA],\n  pictureRetirements: (): [string] => [COLLECTIONS.PICTURE_RETIREMENTS],\n  auditEvents: (): [string] => [COLLECTIONS.AUDIT_EVENTS],\n  activeAdminNotifications: (): [string] => [COLLECTIONS.ACTIVE_ADMIN_NOTIFICATIONS],\n  adminNotificationHistory: (): [string] => [COLLECTIONS.ADMIN_NOTIFICATION_HISTORY],\n  notificationDeliveries: (): [string] => [COLLECTIONS.NOTIFICATION_DELIVERIES],\n  notificationArchiveAllJobs: (): [string] => [COLLECTIONS.NOTIFICATION_ARCHIVE_ALL_JOBS],\n} as const;\n"]}
+{"version":3,"file":"collection-refs.js","sourceRoot":"","sources":["../../src/paths/collection-refs.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,8DAA8D;AAC9D,kEAAkE;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,YAAY,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;IACzD,WAAW,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACvD,oBAAoB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC;IAC1E,kBAAkB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC;IACrE,oBAAoB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC;IAC1E,YAAY,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;IACzD,WAAW,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACvD,kBAAkB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC;IACtE,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC;IAClE,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC;IAClE,qBAAqB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC;IAC5E,UAAU,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC;IACrD,aAAa,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC;IAC3D,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,aAAa,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC;IAC3D,qBAAqB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC;IAC5E,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,iBAAiB,CAAC;IACjE,gBAAgB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,kBAAkB,CAAC;IAClE,sBAAsB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,wBAAwB,CAAC;IAC9E,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,mBAAmB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC;IACxE,eAAe,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,gBAAgB,CAAC;IAC/D,YAAY,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,aAAa,CAAC;IACzD,kBAAkB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,mBAAmB,CAAC;IACrE,WAAW,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,YAAY,CAAC;IACvD,wBAAwB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC;IAClF,wBAAwB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC;IAClF,sBAAsB,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,uBAAuB,CAAC;IAC7E,0BAA0B,EAAE,GAAa,EAAE,CAAC,CAAC,WAAW,CAAC,6BAA6B,CAAC;CAC/E,CAAC","sourcesContent":["// Collection reference builders — for collection-level operations.\n//\n// Frontend: collection(db, ...COLLECTION_REFS.userProfiles())\n// Backend:  db.collection(toPath(COLLECTION_REFS.userProfiles()))\n\nimport { COLLECTIONS } from './collections.js';\n\nexport const COLLECTION_REFS = {\n  userProfiles: (): [string] => [COLLECTIONS.USER_PROFILES],\n  publicUsers: (): [string] => [COLLECTIONS.PUBLIC_USERS],\n  statusReconcileQueue: (): [string] => [COLLECTIONS.STATUS_RECONCILE_QUEUE],\n  registrationStarts: (): [string] => [COLLECTIONS.REGISTRATION_STARTS],\n  reservedDisplayNames: (): [string] => [COLLECTIONS.RESERVED_DISPLAY_NAMES],\n  sportLeagues: (): [string] => [COLLECTIONS.SPORT_LEAGUES],\n  leagueTeams: (): [string] => [COLLECTIONS.LEAGUE_TEAMS],\n  leagueTeamContacts: (): [string] => [COLLECTIONS.LEAGUE_TEAM_CONTACTS],\n  teamMemberships: (): [string] => [COLLECTIONS.TEAM_MEMBERSHIPS],\n  teamInvitations: (): [string] => [COLLECTIONS.TEAM_INVITATIONS],\n  teamJoinRequests: (): [string] => [COLLECTIONS.TEAM_JOIN_REQUESTS],\n  leagueFreeAgents: (): [string] => [COLLECTIONS.LEAGUE_FREE_AGENTS],\n  membershipRosterSyncs: (): [string] => [COLLECTIONS.MEMBERSHIP_ROSTER_SYNCS],\n  sportGames: (): [string] => [COLLECTIONS.SPORT_GAMES],\n  gameLocations: (): [string] => [COLLECTIONS.GAME_LOCATIONS],\n  waiverTemplates: (): [string] => [COLLECTIONS.WAIVER_TEMPLATES],\n  signedWaivers: (): [string] => [COLLECTIONS.SIGNED_WAIVERS],\n  hardwareLoanContracts: (): [string] => [COLLECTIONS.HARDWARE_LOAN_CONTRACTS],\n  awardDefinitions: (): [string] => [COLLECTIONS.AWARD_DEFINITIONS],\n  awardGroupGrants: (): [string] => [COLLECTIONS.AWARD_GROUP_GRANTS],\n  statsValidationReports: (): [string] => [COLLECTIONS.STATS_VALIDATION_REPORTS],\n  statsOperations: (): [string] => [COLLECTIONS.STATS_OPERATIONS],\n  migrationActionRuns: (): [string] => [COLLECTIONS.MIGRATION_ACTION_RUNS],\n  galleryPictures: (): [string] => [COLLECTIONS.GALLERY_PICTURES],\n  pendingMedia: (): [string] => [COLLECTIONS.PENDING_MEDIA],\n  pictureRetirements: (): [string] => [COLLECTIONS.PICTURE_RETIREMENTS],\n  auditEvents: (): [string] => [COLLECTIONS.AUDIT_EVENTS],\n  activeAdminNotifications: (): [string] => [COLLECTIONS.ACTIVE_ADMIN_NOTIFICATIONS],\n  adminNotificationHistory: (): [string] => [COLLECTIONS.ADMIN_NOTIFICATION_HISTORY],\n  notificationDeliveries: (): [string] => [COLLECTIONS.NOTIFICATION_DELIVERIES],\n  notificationArchiveAllJobs: (): [string] => [COLLECTIONS.NOTIFICATION_ARCHIVE_ALL_JOBS],\n} as const;\n"]}

package/dist/paths/collections.d.ts

@@ -19,6 +19,7 @@ export declare const COLLECTIONS: {
     readonly SIGNED_WAIVERS: "signedWaivers";
     readonly HARDWARE_LOAN_CONTRACTS: "hardwareLoanContracts";
     readonly AWARD_DEFINITIONS: "awardDefinitions";
+    readonly AWARD_GROUP_GRANTS: "awardGroupGrants";
     readonly SPORT_HALL_OF_FAME: "sportHallOfFame";
     readonly STATS_VALIDATION_REPORTS: "statsValidationReports";
     readonly STATS_OPERATIONS: "statsOperations";
@@ -51,6 +52,10 @@ export declare const SPORT_GAME_SUBCOLLECTIONS: {
 export declare const WAIVER_TEMPLATE_SUBCOLLECTIONS: {
     readonly WAIVER_TEMPLATE_VERSIONS: "waiverTemplateVersions";
 };
+/** Subcollections of `awardGroupGrants/{grantId}`. */
+export declare const AWARD_GROUP_GRANT_SUBCOLLECTIONS: {
+    readonly AWARD_GROUP_GRANT_PEOPLE: "awardGroupGrantPeople";
+};
 /** Static document IDs for fixed-ID documents. */
 export declare const SPECIAL_DOCS: {
     readonly APP_CONFIG: "app";

package/dist/paths/collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/paths/collections.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8Ed,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE5E,iDAAiD;AACjD,eAAO,MAAM,2BAA2B;;;CAM9B,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB;;;;CAO5B,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B;;CAGjC,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,YAAY;;;;;;CAgBf,CAAC"}
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/paths/collections.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFd,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAE5E,iDAAiD;AACjD,eAAO,MAAM,2BAA2B;;;CAM9B,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,yBAAyB;;;;CAO5B,CAAC;AAEX,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B;;CAGjC,CAAC;AAEX,sDAAsD;AACtD,eAAO,MAAM,gCAAgC;;CAGnC,CAAC;AAEX,kDAAkD;AAClD,eAAO,MAAM,YAAY;;;;;;CAgBf,CAAC"}

package/dist/paths/collections.js

@@ -45,6 +45,9 @@ export const COLLECTIONS = {
     HARDWARE_LOAN_CONTRACTS: 'hardwareLoanContracts',
     // Awards and derived stats
     AWARD_DEFINITIONS: 'awardDefinitions',
+    // One decision on one award for one group — a team, or a whole league — granted or taken back a
+    // page of people at a time, id `buildAwardGroupGrantId`. Backend-only.
+    AWARD_GROUP_GRANTS: 'awardGroupGrants',
     SPORT_HALL_OF_FAME: 'sportHallOfFame',
     STATS_VALIDATION_REPORTS: 'statsValidationReports',
     // One logical run of a stats action: its status, its resume position, and the hold it places on
@@ -99,6 +102,11 @@ export const WAIVER_TEMPLATE_SUBCOLLECTIONS = {
     // One immutable document per published wording, id `buildWaiverTemplateVersionId(version)`.
     WAIVER_TEMPLATE_VERSIONS: 'waiverTemplateVersions',
 };
+/** Subcollections of `awardGroupGrants/{grantId}`. */
+export const AWARD_GROUP_GRANT_SUBCOLLECTIONS = {
+    // One document per person the grant reached, id = the userId, recorded before their profile changed.
+    AWARD_GROUP_GRANT_PEOPLE: 'awardGroupGrantPeople',
+};
 /** Static document IDs for fixed-ID documents. */
 export const SPECIAL_DOCS = {
     // _appConfig — public read

package/dist/paths/collections.js.map

@@ -1 +1 @@
-{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/paths/collections.ts"],"names":[],"mappings":"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","sourcesContent":["// Firestore collection, subcollection, and fixed-document name constants for Q-Sports.\n//\n// Every collection value is compound camelCase — it says what the documents are, never a single\n// bare word (guarded by __tests__/collections.test.ts). The three underscore buckets hold fixed-ID\n// system documents and are placed by who reads them; every one of them is callable-only for writes\n// (BACKEND-108). An admin-only document is server-only, read by an admin through a callable:\n//   _appConfig   public read\n//   _systemData  signed-in read\n//   _serverData  no client access\n\nexport const COLLECTIONS = {\n  // People\n  USER_PROFILES: 'userProfiles',\n  PUBLIC_USERS: 'publicUsers',\n  // One document per taken display name, keyed by its normalized form — the uniqueness lock.\n  RESERVED_DISPLAY_NAMES: 'reservedDisplayNames',\n  // One entry per account owed a post-commit Firebase Auth effect, id = the userId: a status\n  // change's sign-in half, or a failed role-claim write. Backend-only.\n  STATUS_RECONCILE_QUEUE: 'statusReconcileQueue',\n  // One document per login whose registration started, id = the userId: the orphan-login cleanup's\n  // work list. Backend-only.\n  REGISTRATION_STARTS: 'registrationStarts',\n  // One document per scheduled pass that keeps a rolling cursor, id = its `SWEEP_STATE_NAMES` name.\n  // Backend-only.\n  SWEEP_STATE: 'sweepState',\n\n  // Leagues, teams, membership\n  SPORT_LEAGUES: 'sportLeagues',\n  LEAGUE_TEAMS: 'leagueTeams',\n  // One admin-only document per team, id = the team id: how the league reaches the team. The team\n  // itself is publicly readable, so no contact detail lives on it (BACKEND-105); a league's contacts\n  // are one query on `leagueId`.\n  LEAGUE_TEAM_CONTACTS: 'leagueTeamContacts',\n  TEAM_MEMBERSHIPS: 'teamMemberships',\n  TEAM_INVITATIONS: 'teamInvitations',\n  TEAM_JOIN_REQUESTS: 'teamJoinRequests',\n  LEAGUE_FREE_AGENTS: 'leagueFreeAgents',\n  // One document per team membership, id = the membership's id: the durable obligation to bring\n  // that membership's open game rosters in line with it. Backend-only.\n  MEMBERSHIP_ROSTER_SYNCS: 'membershipRosterSyncs',\n\n  // Games\n  SPORT_GAMES: 'sportGames',\n  GAME_LOCATIONS: 'gameLocations',\n\n  // Waivers and hardware\n  WAIVER_TEMPLATES: 'waiverTemplates',\n  SIGNED_WAIVERS: 'signedWaivers',\n  HARDWARE_LOAN_CONTRACTS: 'hardwareLoanContracts',\n\n  // Awards and derived stats\n  AWARD_DEFINITIONS: 'awardDefinitions',\n  SPORT_HALL_OF_FAME: 'sportHallOfFame',\n  STATS_VALIDATION_REPORTS: 'statsValidationReports',\n  // One logical run of a stats action: its status, its resume position, and the hold it places on\n  // a game. Admin read; written only by the stats cores.\n  STATS_OPERATIONS: 'statsOperations',\n\n  // One document per cutover action, id = the action id: where its latest real run stands, its\n  // last preview, and what it reported. Admin read; written only by the migration console.\n  MIGRATION_ACTION_RUNS: 'migrationActionRuns',\n\n  // One document per picture in a league, team, or landing page gallery. Public read; written only\n  // by the picture core.\n  GALLERY_PICTURES: 'galleryPictures',\n  // One accepted picture upload, id = its staging id = the picture id. Read by its uploader and\n  // admins; written only by the accept core (the upload callable and the picture carry), the\n  // processing trigger, and the maintenance sweep's stale-upload pass; never deleted.\n  PENDING_MEDIA: 'pendingMedia',\n  // The durable obligation to delete a picture's files, or a deleted owner's whole gallery. No\n  // client access; carried out by the media maintenance sweep.\n  PICTURE_RETIREMENTS: 'pictureRetirements',\n\n  // Append-only record of sensitive actions. No client access; written only by Cloud Functions.\n  AUDIT_EVENTS: 'auditEvents',\n\n  // Admin notifications, all written only by Cloud Functions. The shared cards every admin reads and\n  // their archived history are admin read; the delivery ledger the owning callables write each\n  // occurrence into, and each admin's archive-all job, have no client access.\n  ACTIVE_ADMIN_NOTIFICATIONS: 'activeAdminNotifications',\n  ADMIN_NOTIFICATION_HISTORY: 'adminNotificationHistory',\n  NOTIFICATION_DELIVERIES: 'notificationDeliveries',\n  NOTIFICATION_ARCHIVE_ALL_JOBS: 'notificationArchiveAllJobs',\n\n  // Fixed-ID system document buckets\n  APP_CONFIG: '_appConfig',\n  SYSTEM_DATA: '_systemData',\n  SERVER_DATA: '_serverData',\n} as const;\n\nexport type CollectionName = (typeof COLLECTIONS)[keyof typeof COLLECTIONS];\n\n/** Subcollections of `userProfiles/{userId}`. */\nexport const USER_PROFILE_SUBCOLLECTIONS = {\n  // One document per sport key: pre-Q-Sports career totals folded into lifetime recalculation.\n  HISTORICAL_STATS: 'historicalStats',\n  // One owner-only document, id = the userId: email and contact details. The profile itself is\n  // publicly readable, so nothing personal lives on it (BACKEND-105).\n  PRIVATE_DATA: 'privateData',\n} as const;\n\n/** Subcollections of `sportGames/{gameId}`. */\nexport const SPORT_GAME_SUBCOLLECTIONS = {\n  // Who participated in the game: one entry per team per person, id `buildGameRosterPlayerId`.\n  GAME_ROSTER_PLAYERS: 'gameRosterPlayers',\n  // One stat event per document, keyed by the event id minted at the tap.\n  GAME_STAT_EVENTS: 'gameStatEvents',\n  // A completed game's finalized record, in pages, id `buildStatHistoryPageId`.\n  GAME_STAT_HISTORY: 'gameStatHistory',\n} as const;\n\n/** Subcollections of `waiverTemplates/{waiverTemplateId}`. */\nexport const WAIVER_TEMPLATE_SUBCOLLECTIONS = {\n  // One immutable document per published wording, id `buildWaiverTemplateVersionId(version)`.\n  WAIVER_TEMPLATE_VERSIONS: 'waiverTemplateVersions',\n} as const;\n\n/** Static document IDs for fixed-ID documents. */\nexport const SPECIAL_DOCS = {\n  // _appConfig — public read\n  // The app-wide operational levers: version gate, maintenance mode, registration switch, banner.\n  APP_CONFIG: 'app',\n  LANDING_PAGE: 'landingPage',\n  // Public because signed-out spectators follow it for live updates.\n  STATS_BEACON: 'statsBeacon',\n\n  // _systemData — signed-in read\n  // The admin and referee rosters — source of truth for the `admin` / `referee` custom claims.\n  ADMIN_LIST: 'adminList',\n\n  // _serverData — no client access\n  // The migration console: the cutover marker and the lock that keeps two actions from running at\n  // once.\n  MIGRATION_CONSOLE: 'migrationConsole',\n} as const;\n"]}
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/paths/collections.ts"],"names":[],"mappings":"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","sourcesContent":["// Firestore collection, subcollection, and fixed-document name constants for Q-Sports.\n//\n// Every collection value is compound camelCase — it says what the documents are, never a single\n// bare word (guarded by __tests__/collections.test.ts). The three underscore buckets hold fixed-ID\n// system documents and are placed by who reads them; every one of them is callable-only for writes\n// (BACKEND-108). An admin-only document is server-only, read by an admin through a callable:\n//   _appConfig   public read\n//   _systemData  signed-in read\n//   _serverData  no client access\n\nexport const COLLECTIONS = {\n  // People\n  USER_PROFILES: 'userProfiles',\n  PUBLIC_USERS: 'publicUsers',\n  // One document per taken display name, keyed by its normalized form — the uniqueness lock.\n  RESERVED_DISPLAY_NAMES: 'reservedDisplayNames',\n  // One entry per account owed a post-commit Firebase Auth effect, id = the userId: a status\n  // change's sign-in half, or a failed role-claim write. Backend-only.\n  STATUS_RECONCILE_QUEUE: 'statusReconcileQueue',\n  // One document per login whose registration started, id = the userId: the orphan-login cleanup's\n  // work list. Backend-only.\n  REGISTRATION_STARTS: 'registrationStarts',\n  // One document per scheduled pass that keeps a rolling cursor, id = its `SWEEP_STATE_NAMES` name.\n  // Backend-only.\n  SWEEP_STATE: 'sweepState',\n\n  // Leagues, teams, membership\n  SPORT_LEAGUES: 'sportLeagues',\n  LEAGUE_TEAMS: 'leagueTeams',\n  // One admin-only document per team, id = the team id: how the league reaches the team. The team\n  // itself is publicly readable, so no contact detail lives on it (BACKEND-105); a league's contacts\n  // are one query on `leagueId`.\n  LEAGUE_TEAM_CONTACTS: 'leagueTeamContacts',\n  TEAM_MEMBERSHIPS: 'teamMemberships',\n  TEAM_INVITATIONS: 'teamInvitations',\n  TEAM_JOIN_REQUESTS: 'teamJoinRequests',\n  LEAGUE_FREE_AGENTS: 'leagueFreeAgents',\n  // One document per team membership, id = the membership's id: the durable obligation to bring\n  // that membership's open game rosters in line with it. Backend-only.\n  MEMBERSHIP_ROSTER_SYNCS: 'membershipRosterSyncs',\n\n  // Games\n  SPORT_GAMES: 'sportGames',\n  GAME_LOCATIONS: 'gameLocations',\n\n  // Waivers and hardware\n  WAIVER_TEMPLATES: 'waiverTemplates',\n  SIGNED_WAIVERS: 'signedWaivers',\n  HARDWARE_LOAN_CONTRACTS: 'hardwareLoanContracts',\n\n  // Awards and derived stats\n  AWARD_DEFINITIONS: 'awardDefinitions',\n  // One decision on one award for one group — a team, or a whole league — granted or taken back a\n  // page of people at a time, id `buildAwardGroupGrantId`. Backend-only.\n  AWARD_GROUP_GRANTS: 'awardGroupGrants',\n  SPORT_HALL_OF_FAME: 'sportHallOfFame',\n  STATS_VALIDATION_REPORTS: 'statsValidationReports',\n  // One logical run of a stats action: its status, its resume position, and the hold it places on\n  // a game. Admin read; written only by the stats cores.\n  STATS_OPERATIONS: 'statsOperations',\n\n  // One document per cutover action, id = the action id: where its latest real run stands, its\n  // last preview, and what it reported. Admin read; written only by the migration console.\n  MIGRATION_ACTION_RUNS: 'migrationActionRuns',\n\n  // One document per picture in a league, team, or landing page gallery. Public read; written only\n  // by the picture core.\n  GALLERY_PICTURES: 'galleryPictures',\n  // One accepted picture upload, id = its staging id = the picture id. Read by its uploader and\n  // admins; written only by the accept core (the upload callable and the picture carry), the\n  // processing trigger, and the maintenance sweep's stale-upload pass; never deleted.\n  PENDING_MEDIA: 'pendingMedia',\n  // The durable obligation to delete a picture's files, or a deleted owner's whole gallery. No\n  // client access; carried out by the media maintenance sweep.\n  PICTURE_RETIREMENTS: 'pictureRetirements',\n\n  // Append-only record of sensitive actions. No client access; written only by Cloud Functions.\n  AUDIT_EVENTS: 'auditEvents',\n\n  // Admin notifications, all written only by Cloud Functions. The shared cards every admin reads and\n  // their archived history are admin read; the delivery ledger the owning callables write each\n  // occurrence into, and each admin's archive-all job, have no client access.\n  ACTIVE_ADMIN_NOTIFICATIONS: 'activeAdminNotifications',\n  ADMIN_NOTIFICATION_HISTORY: 'adminNotificationHistory',\n  NOTIFICATION_DELIVERIES: 'notificationDeliveries',\n  NOTIFICATION_ARCHIVE_ALL_JOBS: 'notificationArchiveAllJobs',\n\n  // Fixed-ID system document buckets\n  APP_CONFIG: '_appConfig',\n  SYSTEM_DATA: '_systemData',\n  SERVER_DATA: '_serverData',\n} as const;\n\nexport type CollectionName = (typeof COLLECTIONS)[keyof typeof COLLECTIONS];\n\n/** Subcollections of `userProfiles/{userId}`. */\nexport const USER_PROFILE_SUBCOLLECTIONS = {\n  // One document per sport key: pre-Q-Sports career totals folded into lifetime recalculation.\n  HISTORICAL_STATS: 'historicalStats',\n  // One owner-only document, id = the userId: email and contact details. The profile itself is\n  // publicly readable, so nothing personal lives on it (BACKEND-105).\n  PRIVATE_DATA: 'privateData',\n} as const;\n\n/** Subcollections of `sportGames/{gameId}`. */\nexport const SPORT_GAME_SUBCOLLECTIONS = {\n  // Who participated in the game: one entry per team per person, id `buildGameRosterPlayerId`.\n  GAME_ROSTER_PLAYERS: 'gameRosterPlayers',\n  // One stat event per document, keyed by the event id minted at the tap.\n  GAME_STAT_EVENTS: 'gameStatEvents',\n  // A completed game's finalized record, in pages, id `buildStatHistoryPageId`.\n  GAME_STAT_HISTORY: 'gameStatHistory',\n} as const;\n\n/** Subcollections of `waiverTemplates/{waiverTemplateId}`. */\nexport const WAIVER_TEMPLATE_SUBCOLLECTIONS = {\n  // One immutable document per published wording, id `buildWaiverTemplateVersionId(version)`.\n  WAIVER_TEMPLATE_VERSIONS: 'waiverTemplateVersions',\n} as const;\n\n/** Subcollections of `awardGroupGrants/{grantId}`. */\nexport const AWARD_GROUP_GRANT_SUBCOLLECTIONS = {\n  // One document per person the grant reached, id = the userId, recorded before their profile changed.\n  AWARD_GROUP_GRANT_PEOPLE: 'awardGroupGrantPeople',\n} as const;\n\n/** Static document IDs for fixed-ID documents. */\nexport const SPECIAL_DOCS = {\n  // _appConfig — public read\n  // The app-wide operational levers: version gate, maintenance mode, registration switch, banner.\n  APP_CONFIG: 'app',\n  LANDING_PAGE: 'landingPage',\n  // Public because signed-out spectators follow it for live updates.\n  STATS_BEACON: 'statsBeacon',\n\n  // _systemData — signed-in read\n  // The admin and referee rosters — source of truth for the `admin` / `referee` custom claims.\n  ADMIN_LIST: 'adminList',\n\n  // _serverData — no client access\n  // The migration console: the cutover marker and the lock that keeps two actions from running at\n  // once.\n  MIGRATION_CONSOLE: 'migrationConsole',\n} as const;\n"]}

package/dist/paths/path-builders.d.ts

@@ -32,6 +32,9 @@ export declare const PATH_BUILDERS: {
     readonly signedWaiver: (leagueId: string, userId: string) => [string, string];
     readonly hardwareLoanContract: (contractId: string) => [string, string];
     readonly awardDefinition: (awardId: string) => [string, string];
+    readonly awardGroupGrant: (grantId: string) => [string, string];
+    readonly awardGroupGrantPerson: (grantId: string, userId: string) => [string, string, string, string];
+    readonly awardGroupGrantPeople: (grantId: string) => [string, string, string];
     readonly sportHallOfFame: (sportKey: SportKey) => [string, string];
     readonly statsValidationReport: (reportId: string) => [string, string];
     readonly statsOperation: (operationId: string) => [string, string];

package/dist/paths/path-builders.d.ts.map

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

package/dist/paths/path-builders.js

@@ -6,7 +6,7 @@
 // A singular name builds a document path; its plural builds the parent collection path where the
 // parent is a subcollection (top-level collections are in COLLECTION_REFS). A compound document ID
 // is assembled here through its one builder in ../ids — never at a call site.
-import { COLLECTIONS, SPORT_GAME_SUBCOLLECTIONS, SPECIAL_DOCS, USER_PROFILE_SUBCOLLECTIONS, WAIVER_TEMPLATE_SUBCOLLECTIONS, } from './collections.js';
+import { AWARD_GROUP_GRANT_SUBCOLLECTIONS, COLLECTIONS, SPORT_GAME_SUBCOLLECTIONS, SPECIAL_DOCS, USER_PROFILE_SUBCOLLECTIONS, WAIVER_TEMPLATE_SUBCOLLECTIONS, } from './collections.js';
 import { buildGameRosterPlayerId, buildLeagueFreeAgentId, buildTeamMembershipId, buildSignedWaiverId, } from '../ids/compound-ids.js';
 import { buildWaiverTemplateVersionId } from '../ids/waiver-template-ids.js';
 import { toReservedDisplayNameKey } from '../utils/display-name.js';
@@ -118,6 +118,18 @@ export const PATH_BUILDERS = {
     ],
     // Awards and derived stats
     awardDefinition: (awardId) => [COLLECTIONS.AWARD_DEFINITIONS, awardId],
+    awardGroupGrant: (grantId) => [COLLECTIONS.AWARD_GROUP_GRANTS, grantId],
+    awardGroupGrantPerson: (grantId, userId) => [
+        COLLECTIONS.AWARD_GROUP_GRANTS,
+        grantId,
+        AWARD_GROUP_GRANT_SUBCOLLECTIONS.AWARD_GROUP_GRANT_PEOPLE,
+        userId,
+    ],
+    awardGroupGrantPeople: (grantId) => [
+        COLLECTIONS.AWARD_GROUP_GRANTS,
+        grantId,
+        AWARD_GROUP_GRANT_SUBCOLLECTIONS.AWARD_GROUP_GRANT_PEOPLE,
+    ],
     sportHallOfFame: (sportKey) => [COLLECTIONS.SPORT_HALL_OF_FAME, sportKey],
     statsValidationReport: (reportId) => [
         COLLECTIONS.STATS_VALIDATION_REPORTS,

package/dist/paths/path-builders.js.map

@@ -1 +1 @@
-{"version":3,"file":"path-builders.js","sourceRoot":"","sources":["../../src/paths/path-builders.ts"],"names":[],"mappings":"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","sourcesContent":["// Document path builders — segment tuples, the one path family.\n//\n// Frontend: doc(db, ...PATH_BUILDERS.userProfile(userId))\n// Backend:  db.doc(toPath(PATH_BUILDERS.userProfile(userId)))\n//\n// A singular name builds a document path; its plural builds the parent collection path where the\n// parent is a subcollection (top-level collections are in COLLECTION_REFS). A compound document ID\n// is assembled here through its one builder in ../ids — never at a call site.\n\nimport {\n  COLLECTIONS,\n  SPORT_GAME_SUBCOLLECTIONS,\n  SPECIAL_DOCS,\n  USER_PROFILE_SUBCOLLECTIONS,\n  WAIVER_TEMPLATE_SUBCOLLECTIONS,\n} from './collections.js';\nimport type { SweepStateName } from '../constants/scheduled-jobs.js';\nimport {\n  buildGameRosterPlayerId,\n  buildLeagueFreeAgentId,\n  buildTeamMembershipId,\n  buildSignedWaiverId,\n} from '../ids/compound-ids.js';\nimport { buildWaiverTemplateVersionId } from '../ids/waiver-template-ids.js';\nimport type { SportKey } from '../types/sports.js';\nimport { toReservedDisplayNameKey } from '../utils/display-name.js';\n\nexport const PATH_BUILDERS = {\n  // People\n  userProfile: (userId: string): [string, string] => [COLLECTIONS.USER_PROFILES, userId],\n  userPrivateData: (userId: string): [string, string, string, string] => [\n    COLLECTIONS.USER_PROFILES,\n    userId,\n    USER_PROFILE_SUBCOLLECTIONS.PRIVATE_DATA,\n    userId,\n  ],\n  historicalStat: (userId: string, sportKey: SportKey): [string, string, string, string] => [\n    COLLECTIONS.USER_PROFILES,\n    userId,\n    USER_PROFILE_SUBCOLLECTIONS.HISTORICAL_STATS,\n    sportKey,\n  ],\n  historicalStats: (userId: string): [string, string, string] => [\n    COLLECTIONS.USER_PROFILES,\n    userId,\n    USER_PROFILE_SUBCOLLECTIONS.HISTORICAL_STATS,\n  ],\n  publicUser: (userId: string): [string, string] => [COLLECTIONS.PUBLIC_USERS, userId],\n  statusReconcileQueueEntry: (userId: string): [string, string] => [COLLECTIONS.STATUS_RECONCILE_QUEUE, userId],\n  registrationStart: (userId: string): [string, string] => [COLLECTIONS.REGISTRATION_STARTS, userId],\n  sweepState: (name: SweepStateName): [string, string] => [COLLECTIONS.SWEEP_STATE, name],\n  reservedDisplayName: (displayName: string): [string, string] => [\n    COLLECTIONS.RESERVED_DISPLAY_NAMES,\n    toReservedDisplayNameKey(displayName),\n  ],\n\n  // Leagues, teams, membership\n  sportLeague: (leagueId: string): [string, string] => [COLLECTIONS.SPORT_LEAGUES, leagueId],\n  leagueTeam: (teamId: string): [string, string] => [COLLECTIONS.LEAGUE_TEAMS, teamId],\n  leagueTeamContact: (teamId: string): [string, string] => [COLLECTIONS.LEAGUE_TEAM_CONTACTS, teamId],\n  teamMembership: (leagueId: string, teamId: string, userId: string): [string, string] => [\n    COLLECTIONS.TEAM_MEMBERSHIPS,\n    buildTeamMembershipId(leagueId, teamId, userId),\n  ],\n  membershipRosterSync: (leagueId: string, teamId: string, userId: string): [string, string] => [\n    COLLECTIONS.MEMBERSHIP_ROSTER_SYNCS,\n    buildTeamMembershipId(leagueId, teamId, userId),\n  ],\n  teamInvitation: (inviteId: string): [string, string] => [COLLECTIONS.TEAM_INVITATIONS, inviteId],\n  teamJoinRequest: (requestId: string): [string, string] => [COLLECTIONS.TEAM_JOIN_REQUESTS, requestId],\n  leagueFreeAgent: (leagueId: string, userId: string): [string, string] => [\n    COLLECTIONS.LEAGUE_FREE_AGENTS,\n    buildLeagueFreeAgentId(leagueId, userId),\n  ],\n\n  // Games\n  sportGame: (gameId: string): [string, string] => [COLLECTIONS.SPORT_GAMES, gameId],\n  gameRosterPlayer: (gameId: string, teamId: string, userId: string): [string, string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_ROSTER_PLAYERS,\n    buildGameRosterPlayerId(teamId, userId),\n  ],\n  gameRosterPlayers: (gameId: string): [string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_ROSTER_PLAYERS,\n  ],\n  gameStatEvent: (gameId: string, eventId: string): [string, string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_EVENTS,\n    eventId,\n  ],\n  gameStatEvents: (gameId: string): [string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_EVENTS,\n  ],\n  gameStatHistoryPage: (gameId: string, pageId: string): [string, string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_HISTORY,\n    pageId,\n  ],\n  gameStatHistory: (gameId: string): [string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_HISTORY,\n  ],\n  gameLocation: (gameLocationId: string): [string, string] => [COLLECTIONS.GAME_LOCATIONS, gameLocationId],\n\n  // Waivers and hardware\n  waiverTemplate: (waiverTemplateId: string): [string, string] => [\n    COLLECTIONS.WAIVER_TEMPLATES,\n    waiverTemplateId,\n  ],\n  waiverTemplateVersion: (waiverTemplateId: string, version: number): [string, string, string, string] => [\n    COLLECTIONS.WAIVER_TEMPLATES,\n    waiverTemplateId,\n    WAIVER_TEMPLATE_SUBCOLLECTIONS.WAIVER_TEMPLATE_VERSIONS,\n    buildWaiverTemplateVersionId(version),\n  ],\n  waiverTemplateVersions: (waiverTemplateId: string): [string, string, string] => [\n    COLLECTIONS.WAIVER_TEMPLATES,\n    waiverTemplateId,\n    WAIVER_TEMPLATE_SUBCOLLECTIONS.WAIVER_TEMPLATE_VERSIONS,\n  ],\n  signedWaiver: (leagueId: string, userId: string): [string, string] => [\n    COLLECTIONS.SIGNED_WAIVERS,\n    buildSignedWaiverId(leagueId, userId),\n  ],\n  hardwareLoanContract: (contractId: string): [string, string] => [\n    COLLECTIONS.HARDWARE_LOAN_CONTRACTS,\n    contractId,\n  ],\n\n  // Awards and derived stats\n  awardDefinition: (awardId: string): [string, string] => [COLLECTIONS.AWARD_DEFINITIONS, awardId],\n  sportHallOfFame: (sportKey: SportKey): [string, string] => [COLLECTIONS.SPORT_HALL_OF_FAME, sportKey],\n  statsValidationReport: (reportId: string): [string, string] => [\n    COLLECTIONS.STATS_VALIDATION_REPORTS,\n    reportId,\n  ],\n  statsOperation: (operationId: string): [string, string] => [COLLECTIONS.STATS_OPERATIONS, operationId],\n  migrationActionRun: (actionId: string): [string, string] => [COLLECTIONS.MIGRATION_ACTION_RUNS, actionId],\n\n  galleryPicture: (pictureId: string): [string, string] => [COLLECTIONS.GALLERY_PICTURES, pictureId],\n  pendingMedia: (pendingMediaId: string): [string, string] => [COLLECTIONS.PENDING_MEDIA, pendingMediaId],\n  // A picture's retirement is keyed by the picture id; a whole gallery's by `buildGalleryRetirementId`.\n  pictureRetirement: (retirementId: string): [string, string] => [\n    COLLECTIONS.PICTURE_RETIREMENTS,\n    retirementId,\n  ],\n\n  auditEvent: (auditEventId: string): [string, string] => [COLLECTIONS.AUDIT_EVENTS, auditEventId],\n\n  // Admin notifications. A card's id is notification-core's; the others come from ../ids.\n  activeAdminNotification: (notificationId: string): [string, string] => [\n    COLLECTIONS.ACTIVE_ADMIN_NOTIFICATIONS,\n    notificationId,\n  ],\n  adminNotificationHistoryEntry: (historyId: string): [string, string] => [\n    COLLECTIONS.ADMIN_NOTIFICATION_HISTORY,\n    historyId,\n  ],\n  notificationDelivery: (deliveryId: string): [string, string] => [COLLECTIONS.NOTIFICATION_DELIVERIES, deliveryId],\n  notificationArchiveAllJob: (jobId: string): [string, string] => [COLLECTIONS.NOTIFICATION_ARCHIVE_ALL_JOBS, jobId],\n\n  // Fixed-ID system documents\n  landingPageConfig: (): [string, string] => [COLLECTIONS.APP_CONFIG, SPECIAL_DOCS.LANDING_PAGE],\n  appConfig: (): [string, string] => [COLLECTIONS.APP_CONFIG, SPECIAL_DOCS.APP_CONFIG],\n  statsBeacon: (): [string, string] => [COLLECTIONS.APP_CONFIG, SPECIAL_DOCS.STATS_BEACON],\n  adminList: (): [string, string] => [COLLECTIONS.SYSTEM_DATA, SPECIAL_DOCS.ADMIN_LIST],\n  migrationConsole: (): [string, string] => [COLLECTIONS.SERVER_DATA, SPECIAL_DOCS.MIGRATION_CONSOLE],\n} as const;\n"]}
+{"version":3,"file":"path-builders.js","sourceRoot":"","sources":["../../src/paths/path-builders.ts"],"names":[],"mappings":"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","sourcesContent":["// Document path builders — segment tuples, the one path family.\n//\n// Frontend: doc(db, ...PATH_BUILDERS.userProfile(userId))\n// Backend:  db.doc(toPath(PATH_BUILDERS.userProfile(userId)))\n//\n// A singular name builds a document path; its plural builds the parent collection path where the\n// parent is a subcollection (top-level collections are in COLLECTION_REFS). A compound document ID\n// is assembled here through its one builder in ../ids — never at a call site.\n\nimport {\n  AWARD_GROUP_GRANT_SUBCOLLECTIONS,\n  COLLECTIONS,\n  SPORT_GAME_SUBCOLLECTIONS,\n  SPECIAL_DOCS,\n  USER_PROFILE_SUBCOLLECTIONS,\n  WAIVER_TEMPLATE_SUBCOLLECTIONS,\n} from './collections.js';\nimport type { SweepStateName } from '../constants/scheduled-jobs.js';\nimport {\n  buildGameRosterPlayerId,\n  buildLeagueFreeAgentId,\n  buildTeamMembershipId,\n  buildSignedWaiverId,\n} from '../ids/compound-ids.js';\nimport { buildWaiverTemplateVersionId } from '../ids/waiver-template-ids.js';\nimport type { SportKey } from '../types/sports.js';\nimport { toReservedDisplayNameKey } from '../utils/display-name.js';\n\nexport const PATH_BUILDERS = {\n  // People\n  userProfile: (userId: string): [string, string] => [COLLECTIONS.USER_PROFILES, userId],\n  userPrivateData: (userId: string): [string, string, string, string] => [\n    COLLECTIONS.USER_PROFILES,\n    userId,\n    USER_PROFILE_SUBCOLLECTIONS.PRIVATE_DATA,\n    userId,\n  ],\n  historicalStat: (userId: string, sportKey: SportKey): [string, string, string, string] => [\n    COLLECTIONS.USER_PROFILES,\n    userId,\n    USER_PROFILE_SUBCOLLECTIONS.HISTORICAL_STATS,\n    sportKey,\n  ],\n  historicalStats: (userId: string): [string, string, string] => [\n    COLLECTIONS.USER_PROFILES,\n    userId,\n    USER_PROFILE_SUBCOLLECTIONS.HISTORICAL_STATS,\n  ],\n  publicUser: (userId: string): [string, string] => [COLLECTIONS.PUBLIC_USERS, userId],\n  statusReconcileQueueEntry: (userId: string): [string, string] => [COLLECTIONS.STATUS_RECONCILE_QUEUE, userId],\n  registrationStart: (userId: string): [string, string] => [COLLECTIONS.REGISTRATION_STARTS, userId],\n  sweepState: (name: SweepStateName): [string, string] => [COLLECTIONS.SWEEP_STATE, name],\n  reservedDisplayName: (displayName: string): [string, string] => [\n    COLLECTIONS.RESERVED_DISPLAY_NAMES,\n    toReservedDisplayNameKey(displayName),\n  ],\n\n  // Leagues, teams, membership\n  sportLeague: (leagueId: string): [string, string] => [COLLECTIONS.SPORT_LEAGUES, leagueId],\n  leagueTeam: (teamId: string): [string, string] => [COLLECTIONS.LEAGUE_TEAMS, teamId],\n  leagueTeamContact: (teamId: string): [string, string] => [COLLECTIONS.LEAGUE_TEAM_CONTACTS, teamId],\n  teamMembership: (leagueId: string, teamId: string, userId: string): [string, string] => [\n    COLLECTIONS.TEAM_MEMBERSHIPS,\n    buildTeamMembershipId(leagueId, teamId, userId),\n  ],\n  membershipRosterSync: (leagueId: string, teamId: string, userId: string): [string, string] => [\n    COLLECTIONS.MEMBERSHIP_ROSTER_SYNCS,\n    buildTeamMembershipId(leagueId, teamId, userId),\n  ],\n  teamInvitation: (inviteId: string): [string, string] => [COLLECTIONS.TEAM_INVITATIONS, inviteId],\n  teamJoinRequest: (requestId: string): [string, string] => [COLLECTIONS.TEAM_JOIN_REQUESTS, requestId],\n  leagueFreeAgent: (leagueId: string, userId: string): [string, string] => [\n    COLLECTIONS.LEAGUE_FREE_AGENTS,\n    buildLeagueFreeAgentId(leagueId, userId),\n  ],\n\n  // Games\n  sportGame: (gameId: string): [string, string] => [COLLECTIONS.SPORT_GAMES, gameId],\n  gameRosterPlayer: (gameId: string, teamId: string, userId: string): [string, string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_ROSTER_PLAYERS,\n    buildGameRosterPlayerId(teamId, userId),\n  ],\n  gameRosterPlayers: (gameId: string): [string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_ROSTER_PLAYERS,\n  ],\n  gameStatEvent: (gameId: string, eventId: string): [string, string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_EVENTS,\n    eventId,\n  ],\n  gameStatEvents: (gameId: string): [string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_EVENTS,\n  ],\n  gameStatHistoryPage: (gameId: string, pageId: string): [string, string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_HISTORY,\n    pageId,\n  ],\n  gameStatHistory: (gameId: string): [string, string, string] => [\n    COLLECTIONS.SPORT_GAMES,\n    gameId,\n    SPORT_GAME_SUBCOLLECTIONS.GAME_STAT_HISTORY,\n  ],\n  gameLocation: (gameLocationId: string): [string, string] => [COLLECTIONS.GAME_LOCATIONS, gameLocationId],\n\n  // Waivers and hardware\n  waiverTemplate: (waiverTemplateId: string): [string, string] => [\n    COLLECTIONS.WAIVER_TEMPLATES,\n    waiverTemplateId,\n  ],\n  waiverTemplateVersion: (waiverTemplateId: string, version: number): [string, string, string, string] => [\n    COLLECTIONS.WAIVER_TEMPLATES,\n    waiverTemplateId,\n    WAIVER_TEMPLATE_SUBCOLLECTIONS.WAIVER_TEMPLATE_VERSIONS,\n    buildWaiverTemplateVersionId(version),\n  ],\n  waiverTemplateVersions: (waiverTemplateId: string): [string, string, string] => [\n    COLLECTIONS.WAIVER_TEMPLATES,\n    waiverTemplateId,\n    WAIVER_TEMPLATE_SUBCOLLECTIONS.WAIVER_TEMPLATE_VERSIONS,\n  ],\n  signedWaiver: (leagueId: string, userId: string): [string, string] => [\n    COLLECTIONS.SIGNED_WAIVERS,\n    buildSignedWaiverId(leagueId, userId),\n  ],\n  hardwareLoanContract: (contractId: string): [string, string] => [\n    COLLECTIONS.HARDWARE_LOAN_CONTRACTS,\n    contractId,\n  ],\n\n  // Awards and derived stats\n  awardDefinition: (awardId: string): [string, string] => [COLLECTIONS.AWARD_DEFINITIONS, awardId],\n  awardGroupGrant: (grantId: string): [string, string] => [COLLECTIONS.AWARD_GROUP_GRANTS, grantId],\n  awardGroupGrantPerson: (grantId: string, userId: string): [string, string, string, string] => [\n    COLLECTIONS.AWARD_GROUP_GRANTS,\n    grantId,\n    AWARD_GROUP_GRANT_SUBCOLLECTIONS.AWARD_GROUP_GRANT_PEOPLE,\n    userId,\n  ],\n  awardGroupGrantPeople: (grantId: string): [string, string, string] => [\n    COLLECTIONS.AWARD_GROUP_GRANTS,\n    grantId,\n    AWARD_GROUP_GRANT_SUBCOLLECTIONS.AWARD_GROUP_GRANT_PEOPLE,\n  ],\n  sportHallOfFame: (sportKey: SportKey): [string, string] => [COLLECTIONS.SPORT_HALL_OF_FAME, sportKey],\n  statsValidationReport: (reportId: string): [string, string] => [\n    COLLECTIONS.STATS_VALIDATION_REPORTS,\n    reportId,\n  ],\n  statsOperation: (operationId: string): [string, string] => [COLLECTIONS.STATS_OPERATIONS, operationId],\n  migrationActionRun: (actionId: string): [string, string] => [COLLECTIONS.MIGRATION_ACTION_RUNS, actionId],\n\n  galleryPicture: (pictureId: string): [string, string] => [COLLECTIONS.GALLERY_PICTURES, pictureId],\n  pendingMedia: (pendingMediaId: string): [string, string] => [COLLECTIONS.PENDING_MEDIA, pendingMediaId],\n  // A picture's retirement is keyed by the picture id; a whole gallery's by `buildGalleryRetirementId`.\n  pictureRetirement: (retirementId: string): [string, string] => [\n    COLLECTIONS.PICTURE_RETIREMENTS,\n    retirementId,\n  ],\n\n  auditEvent: (auditEventId: string): [string, string] => [COLLECTIONS.AUDIT_EVENTS, auditEventId],\n\n  // Admin notifications. A card's id is notification-core's; the others come from ../ids.\n  activeAdminNotification: (notificationId: string): [string, string] => [\n    COLLECTIONS.ACTIVE_ADMIN_NOTIFICATIONS,\n    notificationId,\n  ],\n  adminNotificationHistoryEntry: (historyId: string): [string, string] => [\n    COLLECTIONS.ADMIN_NOTIFICATION_HISTORY,\n    historyId,\n  ],\n  notificationDelivery: (deliveryId: string): [string, string] => [COLLECTIONS.NOTIFICATION_DELIVERIES, deliveryId],\n  notificationArchiveAllJob: (jobId: string): [string, string] => [COLLECTIONS.NOTIFICATION_ARCHIVE_ALL_JOBS, jobId],\n\n  // Fixed-ID system documents\n  landingPageConfig: (): [string, string] => [COLLECTIONS.APP_CONFIG, SPECIAL_DOCS.LANDING_PAGE],\n  appConfig: (): [string, string] => [COLLECTIONS.APP_CONFIG, SPECIAL_DOCS.APP_CONFIG],\n  statsBeacon: (): [string, string] => [COLLECTIONS.APP_CONFIG, SPECIAL_DOCS.STATS_BEACON],\n  adminList: (): [string, string] => [COLLECTIONS.SYSTEM_DATA, SPECIAL_DOCS.ADMIN_LIST],\n  migrationConsole: (): [string, string] => [COLLECTIONS.SERVER_DATA, SPECIAL_DOCS.MIGRATION_CONSOLE],\n} as const;\n"]}

package/dist/schemas/admin-notifications.d.ts

@@ -27,8 +27,8 @@ export declare const AdminGetNotificationArchiveAllStatusInputSchema: z.ZodObjec
 export type AdminGetNotificationArchiveAllStatusInput = z.infer<typeof AdminGetNotificationArchiveAllStatusInputSchema>;
 export declare const AdminGetNotificationArchiveAllStatusResultSchema: z.ZodObject<{
     state: z.ZodEnum<{
-        failed: "failed";
         complete: "complete";
+        failed: "failed";
         "in-progress": "in-progress";
         incomplete: "incomplete";
     }>;

package/dist/schemas/awards.d.ts

@@ -2,8 +2,6 @@ import { z } from 'zod';
 export declare const AdminUpdateAwardGrantsInputSchema: z.ZodObject<{
     awardId: z.ZodString;
     grantUserIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    grantTeamIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    grantLeagueIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
     revokeUserIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 export type AdminUpdateAwardGrantsInput = z.infer<typeof AdminUpdateAwardGrantsInputSchema>;
@@ -30,6 +28,100 @@ export declare const AdminUpdateAwardGrantsResultSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type AdminUpdateAwardGrantsResult = z.infer<typeof AdminUpdateAwardGrantsResultSchema>;
+export declare const AwardGroupSchema: z.ZodObject<{
+    groupType: z.ZodEnum<{
+        team: "team";
+        league: "league";
+    }>;
+    groupId: z.ZodString;
+}, z.core.$strict>;
+export type AwardGroup = z.infer<typeof AwardGroupSchema>;
+export declare const AdminUpdateAwardGroupGrantInputSchema: z.ZodObject<{
+    awardId: z.ZodString;
+    action: z.ZodEnum<{
+        grant: "grant";
+        revoke: "revoke";
+    }>;
+    group: z.ZodObject<{
+        groupType: z.ZodEnum<{
+            team: "team";
+            league: "league";
+        }>;
+        groupId: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AdminUpdateAwardGroupGrantInput = z.infer<typeof AdminUpdateAwardGroupGrantInputSchema>;
+export declare const AwardGroupGrantProgressSchema: z.ZodObject<{
+    grantId: z.ZodString;
+    action: z.ZodEnum<{
+        grant: "grant";
+        revoke: "revoke";
+    }>;
+    decision: z.ZodNumber;
+    status: z.ZodEnum<{
+        pending: "pending";
+        complete: "complete";
+    }>;
+    peopleReached: z.ZodNumber;
+    attemptCount: z.ZodNumber;
+    lastError: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodNumber;
+    completedAt: z.ZodNullable<z.ZodNumber>;
+}, z.core.$strict>;
+export type AwardGroupGrantProgress = z.infer<typeof AwardGroupGrantProgressSchema>;
+export declare const AdminUpdateAwardGroupGrantResultSchema: z.ZodObject<{
+    awardId: z.ZodString;
+    opened: z.ZodBoolean;
+    grant: z.ZodNullable<z.ZodObject<{
+        grantId: z.ZodString;
+        action: z.ZodEnum<{
+            grant: "grant";
+            revoke: "revoke";
+        }>;
+        decision: z.ZodNumber;
+        status: z.ZodEnum<{
+            pending: "pending";
+            complete: "complete";
+        }>;
+        peopleReached: z.ZodNumber;
+        attemptCount: z.ZodNumber;
+        lastError: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodNumber;
+        completedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AdminUpdateAwardGroupGrantResult = z.infer<typeof AdminUpdateAwardGroupGrantResultSchema>;
+export declare const AdminGetAwardGroupGrantStatusInputSchema: z.ZodObject<{
+    awardId: z.ZodString;
+    group: z.ZodObject<{
+        groupType: z.ZodEnum<{
+            team: "team";
+            league: "league";
+        }>;
+        groupId: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type AdminGetAwardGroupGrantStatusInput = z.infer<typeof AdminGetAwardGroupGrantStatusInputSchema>;
+export declare const AdminGetAwardGroupGrantStatusResultSchema: z.ZodObject<{
+    grant: z.ZodNullable<z.ZodObject<{
+        grantId: z.ZodString;
+        action: z.ZodEnum<{
+            grant: "grant";
+            revoke: "revoke";
+        }>;
+        decision: z.ZodNumber;
+        status: z.ZodEnum<{
+            pending: "pending";
+            complete: "complete";
+        }>;
+        peopleReached: z.ZodNumber;
+        attemptCount: z.ZodNumber;
+        lastError: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodNumber;
+        completedAt: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AdminGetAwardGroupGrantStatusResult = z.infer<typeof AdminGetAwardGroupGrantStatusResultSchema>;
 export declare const AdminDeleteAwardDefinitionInputSchema: z.ZodObject<{
     awardId: z.ZodString;
 }, z.core.$strict>;

package/dist/schemas/awards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"awards.d.ts","sourceRoot":"","sources":["../../src/schemas/awards.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,iCAAiC;;;;;;kBAmB3C,CAAC;AACJ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,oBAAoB;;;;;;kBAEtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAKlE,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;kBASpC,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAG9F,eAAO,MAAM,qCAAqC;;kBAAgD,CAAC;AACnG,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAGpG,eAAO,MAAM,sCAAsC;;;kBAExC,CAAC;AACZ,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAOtG,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;8BAI1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,gCAAgC;;;;;kBAOlC,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}
+{"version":3,"file":"awards.d.ts","sourceRoot":"","sources":["../../src/schemas/awards.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,iCAAiC;;;;kBAc3C,CAAC;AACJ,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iCAAiC,CAAC,CAAC;AAE5F,eAAO,MAAM,oBAAoB;;;;;;kBAEtB,CAAC;AACZ,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAKlE,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;kBASpC,CAAC;AACZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAI9F,eAAO,MAAM,gBAAgB;;;;;;kBAElB,CAAC;AACZ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAK1D,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;kBAEvC,CAAC;AACZ,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAMpG,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;kBAY/B,CAAC;AACZ,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAIpF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;kBAExC,CAAC;AACZ,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAGtG,eAAO,MAAM,wCAAwC;;;;;;;;;kBAE1C,CAAC;AACZ,MAAM,MAAM,kCAAkC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wCAAwC,CAAC,CAAC;AAC1G,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;kBAE3C,CAAC;AACZ,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAG5G,eAAO,MAAM,qCAAqC;;kBAAgD,CAAC;AACnG,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAGpG,eAAO,MAAM,sCAAsC;;;kBAExC,CAAC;AACZ,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sCAAsC,CAAC,CAAC;AAOtG,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;8BAI1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC;AAExF,eAAO,MAAM,gCAAgC;;;;;kBAOlC,CAAC;AACZ,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC"}

package/dist/schemas/awards.js

@@ -1,27 +1,27 @@
 // Callable contracts for the award catalog, award grants, and the badges an account features.
 //
 // An award is created by its first badge's publication (the `award-badge` upload, ./uploads.ts), so
-// no callable here creates one. Grants and revokes share one input — four named lists, never an
-// action discriminator (BACKEND-002) — like the role roster's.
+// no callable here creates one. Grants and revokes to named accounts share one input — two named
+// lists, never an action discriminator (BACKEND-002) — like the role roster's. A team's or a whole
+// league's grant is its own decision, carried out a page of people at a time.
 import { z } from 'zod';
 import { MAX_AWARD_GRANT_TARGETS } from '../constants/business.js';
+import { awardGroupGrantActionSchema, awardGroupGrantDecisionSchema, awardGroupGrantStatusSchema, awardGroupTypeSchema, } from '../doc-schemas/award-group-grant.js';
+import { countSchema, documentIdSegmentSchema, epochMsSchema } from '../doc-schemas/atoms.js';
 import { awardIdSchema } from '../doc-schemas/catalogs.js';
 import { AWARD_GRANT_SKIP_REASON_KEYS, FEATURED_AWARD_SLOT_KEYS } from '../types/unions.js';
-import { leagueIdSchema, teamIdSchema, userIdSchema } from './atoms.js';
+import { userIdSchema } from './atoms.js';
 const targetList = (atom) => z.array(atom).max(MAX_AWARD_GRANT_TARGETS).optional();
-// An admin grants an award to accounts — named directly, or as every active real member of a team
-// or of a league — and revokes it from accounts. Recipients are resolved on the server, deduplicated,
-// and bounded by MAX_AWARD_GRANT_RECIPIENTS; ghosts hold no account and are skipped.
+// An admin grants an award to named accounts and revokes it from named accounts, in one commit.
+// Recipients are deduplicated on the server; a ghost holds no account and is skipped.
 export const AdminUpdateAwardGrantsInputSchema = z
     .object({
     awardId: awardIdSchema,
     grantUserIds: targetList(userIdSchema),
-    grantTeamIds: targetList(teamIdSchema),
-    grantLeagueIds: targetList(leagueIdSchema),
     revokeUserIds: targetList(userIdSchema),
 })
     .strict()
-    .refine((input) => [input.grantUserIds, input.grantTeamIds, input.grantLeagueIds, input.revokeUserIds].some((list) => list !== undefined && list.length > 0), { message: 'Name someone to grant the award to or revoke it from.' })
+    .refine((input) => [input.grantUserIds, input.revokeUserIds].some((list) => list !== undefined && list.length > 0), { message: 'Name someone to grant the award to or revoke it from.' })
     .refine((input) => !(input.grantUserIds ?? []).some((userId) => (input.revokeUserIds ?? []).includes(userId)), { message: 'An account cannot be granted and revoked the award in one change.', path: ['revokeUserIds'] });
 export const AwardGrantSkipSchema = z
     .object({ userId: userIdSchema, reason: z.enum(AWARD_GRANT_SKIP_REASON_KEYS) })
@@ -39,6 +39,46 @@ export const AdminUpdateAwardGrantsResultSchema = z
     skipped: z.array(AwardGrantSkipSchema),
 })
     .strict();
+// The group a group grant reaches: every active member of one team, or of one whole league.
+// `groupId` is that team's or league's id.
+export const AwardGroupSchema = z
+    .object({ groupType: awardGroupTypeSchema, groupId: documentIdSegmentSchema })
+    .strict();
+// An admin grants an award to a group, or takes back what the group's grants gave. The decision opens
+// at once and its people are reached a page at a time after the answer; a request the group's latest
+// decision already settles (granting what is granted, taking back what is not) opens nothing.
+export const AdminUpdateAwardGroupGrantInputSchema = z
+    .object({ awardId: awardIdSchema, action: awardGroupGrantActionSchema, group: AwardGroupSchema })
+    .strict();
+// Where one decision on an award for a group stands. `peopleReached` is how many people it has dealt
+// with so far: a grant's recorded people, or the people a revoke has taken the award back from or left
+// holding it. A pending decision that failed carries its failure and how many times it has tried; the
+// scheduled resume tries it again.
+export const AwardGroupGrantProgressSchema = z
+    .object({
+    grantId: z.string().min(1),
+    action: awardGroupGrantActionSchema,
+    decision: awardGroupGrantDecisionSchema,
+    status: awardGroupGrantStatusSchema,
+    peopleReached: countSchema,
+    attemptCount: countSchema,
+    lastError: z.string().nullable(),
+    createdAt: epochMsSchema,
+    completedAt: epochMsSchema.nullable(),
+})
+    .strict();
+// `opened` is false when the group's latest decision already settled the request; `grant` is then that
+// decision, or null when the group has none.
+export const AdminUpdateAwardGroupGrantResultSchema = z
+    .object({ awardId: awardIdSchema, opened: z.boolean(), grant: AwardGroupGrantProgressSchema.nullable() })
+    .strict();
+// An admin reads the latest decision on an award for a group, so the progress survives a closed page.
+export const AdminGetAwardGroupGrantStatusInputSchema = z
+    .object({ awardId: awardIdSchema, group: AwardGroupSchema })
+    .strict();
+export const AdminGetAwardGroupGrantStatusResultSchema = z
+    .object({ grant: AwardGroupGrantProgressSchema.nullable() })
+    .strict();
 // An admin deletes an award nobody holds. Its badge's files are retired with it.
 export const AdminDeleteAwardDefinitionInputSchema = z.object({ awardId: awardIdSchema }).strict();
 // `deleted` is false when the award was already gone: nothing was written.

package/dist/schemas/awards.js.map

@@ -1 +1 @@
-{"version":3,"file":"awards.js","sourceRoot":"","sources":["../../src/schemas/awards.ts"],"names":[],"mappings":"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","sourcesContent":["// Callable contracts for the award catalog, award grants, and the badges an account features.\n//\n// An award is created by its first badge's publication (the `award-badge` upload, ./uploads.ts), so\n// no callable here creates one. Grants and revokes share one input — four named lists, never an\n// action discriminator (BACKEND-002) — like the role roster's.\n\nimport { z } from 'zod';\nimport { MAX_AWARD_GRANT_TARGETS } from '../constants/business.js';\nimport { awardIdSchema } from '../doc-schemas/catalogs.js';\nimport { AWARD_GRANT_SKIP_REASON_KEYS, FEATURED_AWARD_SLOT_KEYS } from '../types/unions.js';\nimport { leagueIdSchema, teamIdSchema, userIdSchema } from './atoms.js';\n\nconst targetList = <T extends z.ZodTypeAny>(atom: T) => z.array(atom).max(MAX_AWARD_GRANT_TARGETS).optional();\n\n// An admin grants an award to accounts — named directly, or as every active real member of a team\n// or of a league — and revokes it from accounts. Recipients are resolved on the server, deduplicated,\n// and bounded by MAX_AWARD_GRANT_RECIPIENTS; ghosts hold no account and are skipped.\nexport const AdminUpdateAwardGrantsInputSchema = z\n  .object({\n    awardId: awardIdSchema,\n    grantUserIds: targetList(userIdSchema),\n    grantTeamIds: targetList(teamIdSchema),\n    grantLeagueIds: targetList(leagueIdSchema),\n    revokeUserIds: targetList(userIdSchema),\n  })\n  .strict()\n  .refine(\n    (input) =>\n      [input.grantUserIds, input.grantTeamIds, input.grantLeagueIds, input.revokeUserIds].some(\n        (list) => list !== undefined && list.length > 0,\n      ),\n    { message: 'Name someone to grant the award to or revoke it from.' },\n  )\n  .refine(\n    (input) => !(input.grantUserIds ?? []).some((userId) => (input.revokeUserIds ?? []).includes(userId)),\n    { message: 'An account cannot be granted and revoked the award in one change.', path: ['revokeUserIds'] },\n  );\nexport type AdminUpdateAwardGrantsInput = z.infer<typeof AdminUpdateAwardGrantsInputSchema>;\n\nexport const AwardGrantSkipSchema = z\n  .object({ userId: userIdSchema, reason: z.enum(AWARD_GRANT_SKIP_REASON_KEYS) })\n  .strict();\nexport type AwardGrantSkip = z.infer<typeof AwardGrantSkipSchema>;\n\n// What the change did for each account it reached: granted now, already held, revoked now, not held\n// to begin with, or skipped with its reason. A retried call reports the accounts its first call\n// changed as already held or not held, and writes nothing again.\nexport const AdminUpdateAwardGrantsResultSchema = z\n  .object({\n    awardId: awardIdSchema,\n    granted: z.array(userIdSchema),\n    alreadyHeld: z.array(userIdSchema),\n    revoked: z.array(userIdSchema),\n    notHeld: z.array(userIdSchema),\n    skipped: z.array(AwardGrantSkipSchema),\n  })\n  .strict();\nexport type AdminUpdateAwardGrantsResult = z.infer<typeof AdminUpdateAwardGrantsResultSchema>;\n\n// An admin deletes an award nobody holds. Its badge's files are retired with it.\nexport const AdminDeleteAwardDefinitionInputSchema = z.object({ awardId: awardIdSchema }).strict();\nexport type AdminDeleteAwardDefinitionInput = z.infer<typeof AdminDeleteAwardDefinitionInputSchema>;\n\n// `deleted` is false when the award was already gone: nothing was written.\nexport const AdminDeleteAwardDefinitionResultSchema = z\n  .object({ awardId: awardIdSchema, deleted: z.boolean() })\n  .strict();\nexport type AdminDeleteAwardDefinitionResult = z.infer<typeof AdminDeleteAwardDefinitionResultSchema>;\n\n// The signed-in account chooses which of its own awards to show beside its name: a primary and a\n// secondary badge, each an award it holds, or none. The input is the one change the person made —\n// set a slot, clear a slot, or swap the two — and the core applies it to the pair as stored, so a\n// change to one slot never writes back a stale value of the other. No user id is ever sent.\nconst featuredAwardSlotSchema = z.enum(FEATURED_AWARD_SLOT_KEYS);\nexport const UpdateFeaturedAwardsInputSchema = z.discriminatedUnion('action', [\n  z.object({ action: z.literal('set'), slot: featuredAwardSlotSchema, awardId: awardIdSchema }).strict(),\n  z.object({ action: z.literal('clear'), slot: featuredAwardSlotSchema }).strict(),\n  z.object({ action: z.literal('swap') }).strict(),\n]);\nexport type UpdateFeaturedAwardsInput = z.infer<typeof UpdateFeaturedAwardsInputSchema>;\n\nexport const UpdateFeaturedAwardsResultSchema = z\n  .object({\n    userId: userIdSchema,\n    primaryAwardId: awardIdSchema.nullable(),\n    secondaryAwardId: awardIdSchema.nullable(),\n    changed: z.boolean(),\n  })\n  .strict();\nexport type UpdateFeaturedAwardsResult = z.infer<typeof UpdateFeaturedAwardsResultSchema>;\n"]}
+{"version":3,"file":"awards.js","sourceRoot":"","sources":["../../src/schemas/awards.ts"],"names":[],"mappings":"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","sourcesContent":["// Callable contracts for the award catalog, award grants, and the badges an account features.\n//\n// An award is created by its first badge's publication (the `award-badge` upload, ./uploads.ts), so\n// no callable here creates one. Grants and revokes to named accounts share one input — two named\n// lists, never an action discriminator (BACKEND-002) — like the role roster's. A team's or a whole\n// league's grant is its own decision, carried out a page of people at a time.\n\nimport { z } from 'zod';\nimport { MAX_AWARD_GRANT_TARGETS } from '../constants/business.js';\nimport {\n  awardGroupGrantActionSchema,\n  awardGroupGrantDecisionSchema,\n  awardGroupGrantStatusSchema,\n  awardGroupTypeSchema,\n} from '../doc-schemas/award-group-grant.js';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema } from '../doc-schemas/atoms.js';\nimport { awardIdSchema } from '../doc-schemas/catalogs.js';\nimport { AWARD_GRANT_SKIP_REASON_KEYS, FEATURED_AWARD_SLOT_KEYS } from '../types/unions.js';\nimport { userIdSchema } from './atoms.js';\n\nconst targetList = <T extends z.ZodTypeAny>(atom: T) => z.array(atom).max(MAX_AWARD_GRANT_TARGETS).optional();\n\n// An admin grants an award to named accounts and revokes it from named accounts, in one commit.\n// Recipients are deduplicated on the server; a ghost holds no account and is skipped.\nexport const AdminUpdateAwardGrantsInputSchema = z\n  .object({\n    awardId: awardIdSchema,\n    grantUserIds: targetList(userIdSchema),\n    revokeUserIds: targetList(userIdSchema),\n  })\n  .strict()\n  .refine(\n    (input) => [input.grantUserIds, input.revokeUserIds].some((list) => list !== undefined && list.length > 0),\n    { message: 'Name someone to grant the award to or revoke it from.' },\n  )\n  .refine(\n    (input) => !(input.grantUserIds ?? []).some((userId) => (input.revokeUserIds ?? []).includes(userId)),\n    { message: 'An account cannot be granted and revoked the award in one change.', path: ['revokeUserIds'] },\n  );\nexport type AdminUpdateAwardGrantsInput = z.infer<typeof AdminUpdateAwardGrantsInputSchema>;\n\nexport const AwardGrantSkipSchema = z\n  .object({ userId: userIdSchema, reason: z.enum(AWARD_GRANT_SKIP_REASON_KEYS) })\n  .strict();\nexport type AwardGrantSkip = z.infer<typeof AwardGrantSkipSchema>;\n\n// What the change did for each account it reached: granted now, already held, revoked now, not held\n// to begin with, or skipped with its reason. A retried call reports the accounts its first call\n// changed as already held or not held, and writes nothing again.\nexport const AdminUpdateAwardGrantsResultSchema = z\n  .object({\n    awardId: awardIdSchema,\n    granted: z.array(userIdSchema),\n    alreadyHeld: z.array(userIdSchema),\n    revoked: z.array(userIdSchema),\n    notHeld: z.array(userIdSchema),\n    skipped: z.array(AwardGrantSkipSchema),\n  })\n  .strict();\nexport type AdminUpdateAwardGrantsResult = z.infer<typeof AdminUpdateAwardGrantsResultSchema>;\n\n// The group a group grant reaches: every active member of one team, or of one whole league.\n// `groupId` is that team's or league's id.\nexport const AwardGroupSchema = z\n  .object({ groupType: awardGroupTypeSchema, groupId: documentIdSegmentSchema })\n  .strict();\nexport type AwardGroup = z.infer<typeof AwardGroupSchema>;\n\n// An admin grants an award to a group, or takes back what the group's grants gave. The decision opens\n// at once and its people are reached a page at a time after the answer; a request the group's latest\n// decision already settles (granting what is granted, taking back what is not) opens nothing.\nexport const AdminUpdateAwardGroupGrantInputSchema = z\n  .object({ awardId: awardIdSchema, action: awardGroupGrantActionSchema, group: AwardGroupSchema })\n  .strict();\nexport type AdminUpdateAwardGroupGrantInput = z.infer<typeof AdminUpdateAwardGroupGrantInputSchema>;\n\n// Where one decision on an award for a group stands. `peopleReached` is how many people it has dealt\n// with so far: a grant's recorded people, or the people a revoke has taken the award back from or left\n// holding it. A pending decision that failed carries its failure and how many times it has tried; the\n// scheduled resume tries it again.\nexport const AwardGroupGrantProgressSchema = z\n  .object({\n    grantId: z.string().min(1),\n    action: awardGroupGrantActionSchema,\n    decision: awardGroupGrantDecisionSchema,\n    status: awardGroupGrantStatusSchema,\n    peopleReached: countSchema,\n    attemptCount: countSchema,\n    lastError: z.string().nullable(),\n    createdAt: epochMsSchema,\n    completedAt: epochMsSchema.nullable(),\n  })\n  .strict();\nexport type AwardGroupGrantProgress = z.infer<typeof AwardGroupGrantProgressSchema>;\n\n// `opened` is false when the group's latest decision already settled the request; `grant` is then that\n// decision, or null when the group has none.\nexport const AdminUpdateAwardGroupGrantResultSchema = z\n  .object({ awardId: awardIdSchema, opened: z.boolean(), grant: AwardGroupGrantProgressSchema.nullable() })\n  .strict();\nexport type AdminUpdateAwardGroupGrantResult = z.infer<typeof AdminUpdateAwardGroupGrantResultSchema>;\n\n// An admin reads the latest decision on an award for a group, so the progress survives a closed page.\nexport const AdminGetAwardGroupGrantStatusInputSchema = z\n  .object({ awardId: awardIdSchema, group: AwardGroupSchema })\n  .strict();\nexport type AdminGetAwardGroupGrantStatusInput = z.infer<typeof AdminGetAwardGroupGrantStatusInputSchema>;\nexport const AdminGetAwardGroupGrantStatusResultSchema = z\n  .object({ grant: AwardGroupGrantProgressSchema.nullable() })\n  .strict();\nexport type AdminGetAwardGroupGrantStatusResult = z.infer<typeof AdminGetAwardGroupGrantStatusResultSchema>;\n\n// An admin deletes an award nobody holds. Its badge's files are retired with it.\nexport const AdminDeleteAwardDefinitionInputSchema = z.object({ awardId: awardIdSchema }).strict();\nexport type AdminDeleteAwardDefinitionInput = z.infer<typeof AdminDeleteAwardDefinitionInputSchema>;\n\n// `deleted` is false when the award was already gone: nothing was written.\nexport const AdminDeleteAwardDefinitionResultSchema = z\n  .object({ awardId: awardIdSchema, deleted: z.boolean() })\n  .strict();\nexport type AdminDeleteAwardDefinitionResult = z.infer<typeof AdminDeleteAwardDefinitionResultSchema>;\n\n// The signed-in account chooses which of its own awards to show beside its name: a primary and a\n// secondary badge, each an award it holds, or none. The input is the one change the person made —\n// set a slot, clear a slot, or swap the two — and the core applies it to the pair as stored, so a\n// change to one slot never writes back a stale value of the other. No user id is ever sent.\nconst featuredAwardSlotSchema = z.enum(FEATURED_AWARD_SLOT_KEYS);\nexport const UpdateFeaturedAwardsInputSchema = z.discriminatedUnion('action', [\n  z.object({ action: z.literal('set'), slot: featuredAwardSlotSchema, awardId: awardIdSchema }).strict(),\n  z.object({ action: z.literal('clear'), slot: featuredAwardSlotSchema }).strict(),\n  z.object({ action: z.literal('swap') }).strict(),\n]);\nexport type UpdateFeaturedAwardsInput = z.infer<typeof UpdateFeaturedAwardsInputSchema>;\n\nexport const UpdateFeaturedAwardsResultSchema = z\n  .object({\n    userId: userIdSchema,\n    primaryAwardId: awardIdSchema.nullable(),\n    secondaryAwardId: awardIdSchema.nullable(),\n    changed: z.boolean(),\n  })\n  .strict();\nexport type UpdateFeaturedAwardsResult = z.infer<typeof UpdateFeaturedAwardsResultSchema>;\n"]}

package/dist/schemas/leagues.d.ts

@@ -5,11 +5,11 @@ export declare const playoffCutoffSchema: z.ZodNumber;
 export declare const LEAGUE_SETTINGS_FIELD_KEYS: readonly ["leagueTitle", "description", "leagueStartDate", "leagueEndDate", "playoffCutoff", "playoffCutoffComp", "playoffCutoffRec", "requiresWaiver", "waiverTemplateId"];
 export type LeagueSettingsField = (typeof LEAGUE_SETTINGS_FIELD_KEYS)[number];
 export declare const leagueSettingsFieldSchema: z.ZodEnum<{
+    playoffCutoff: "playoffCutoff";
     description: "description";
     leagueEndDate: "leagueEndDate";
     waiverTemplateId: "waiverTemplateId";
     leagueStartDate: "leagueStartDate";
-    playoffCutoff: "playoffCutoff";
     playoffCutoffComp: "playoffCutoffComp";
     playoffCutoffRec: "playoffCutoffRec";
     leagueTitle: "leagueTitle";
@@ -59,11 +59,11 @@ export type AdminUpdateSportLeagueInput = z.infer<typeof AdminUpdateSportLeagueI
 export declare const AdminUpdateSportLeagueResultSchema: z.ZodObject<{
     leagueId: z.ZodString;
     changedFields: z.ZodArray<z.ZodEnum<{
+        playoffCutoff: "playoffCutoff";
         description: "description";
         leagueEndDate: "leagueEndDate";
         waiverTemplateId: "waiverTemplateId";
         leagueStartDate: "leagueStartDate";
-        playoffCutoff: "playoffCutoff";
         playoffCutoffComp: "playoffCutoffComp";
         playoffCutoffRec: "playoffCutoffRec";
         leagueTitle: "leagueTitle";

package/dist/schemas/migration-console.d.ts

@@ -123,8 +123,8 @@ export declare const MigrationActionPageResultSchema: z.ZodObject<{
         updatedAt: z.ZodNumber;
         completedAt: z.ZodOptional<z.ZodNumber>;
         status: z.ZodEnum<{
-            running: "running";
             complete: "complete";
+            running: "running";
             stopped: "stopped";
         }>;
         pages: z.ZodNumber;
@@ -426,8 +426,8 @@ export declare const MigrationStepStateSchema: z.ZodObject<{
             updatedAt: z.ZodNumber;
             completedAt: z.ZodOptional<z.ZodNumber>;
             status: z.ZodEnum<{
-                running: "running";
                 complete: "complete";
+                running: "running";
                 stopped: "stopped";
             }>;
             pages: z.ZodNumber;
@@ -461,8 +461,8 @@ export declare const MigrationStepStateSchema: z.ZodObject<{
             updatedAt: z.ZodNumber;
             completedAt: z.ZodOptional<z.ZodNumber>;
             status: z.ZodEnum<{
-                running: "running";
                 complete: "complete";
+                running: "running";
                 stopped: "stopped";
             }>;
             pages: z.ZodNumber;
@@ -870,8 +870,8 @@ export declare const GetMigrationConsoleResultSchema: z.ZodObject<{
                 updatedAt: z.ZodNumber;
                 completedAt: z.ZodOptional<z.ZodNumber>;
                 status: z.ZodEnum<{
-                    running: "running";
                     complete: "complete";
+                    running: "running";
                     stopped: "stopped";
                 }>;
                 pages: z.ZodNumber;
@@ -905,8 +905,8 @@ export declare const GetMigrationConsoleResultSchema: z.ZodObject<{
                 updatedAt: z.ZodNumber;
                 completedAt: z.ZodOptional<z.ZodNumber>;
                 status: z.ZodEnum<{
-                    running: "running";
                     complete: "complete";
+                    running: "running";
                     stopped: "stopped";
                 }>;
                 pages: z.ZodNumber;
@@ -1318,8 +1318,8 @@ export declare const RecordMigrationStepResultSchema: z.ZodObject<{
             updatedAt: z.ZodNumber;
             completedAt: z.ZodOptional<z.ZodNumber>;
             status: z.ZodEnum<{
-                running: "running";
                 complete: "complete";
+                running: "running";
                 stopped: "stopped";
             }>;
             pages: z.ZodNumber;
@@ -1353,8 +1353,8 @@ export declare const RecordMigrationStepResultSchema: z.ZodObject<{
             updatedAt: z.ZodNumber;
             completedAt: z.ZodOptional<z.ZodNumber>;
             status: z.ZodEnum<{
-                running: "running";
                 complete: "complete";
+                running: "running";
                 stopped: "stopped";
             }>;
             pages: z.ZodNumber;