@ttt-productions/q-core 0.1.29 → 0.1.30

package/dist/sports/finalized-record.d.ts

@@ -9,9 +9,9 @@ export interface FinalizedRecordPage {
 }
 export declare function buildFinalizedRecordPages(events: readonly GameStatEvent[], snapshot: Pick<FinalizedGame, 'leagueType' | 'teamIds' | 'rosterPlayerIds' | 'absentRosterPlayerIds' | 'nonScoringRosterPlayerIds'>): FinalizedRecordPage[];
 export declare function isFirstRecordPage(page: GameStatHistoryPage): page is GameStatHistoryFirstPage;
-export declare function readFinalizedRecord(pages: readonly GameStatHistoryPage[]): {
+export declare function readFinalizedRecord(pages: readonly FinalizedRecordPage[]): {
     readonly snapshot: FinalizedRecordSnapshot;
     readonly events: GameStatEvent[];
 };
-export declare function finalizedGameFromRecord(adapter: AnySportAdapter, pages: readonly GameStatHistoryPage[]): FinalizedGame;
+export declare function finalizedGameFromRecord(adapter: AnySportAdapter, pages: readonly FinalizedRecordPage[]): FinalizedGame;
 //# sourceMappingURL=finalized-record.d.ts.map

package/dist/sports/finalized-record.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"finalized-record.d.ts","sourceRoot":"","sources":["../../src/sports/finalized-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AAE7F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,EAAE,IAAI,CACZ,aAAa,EACX,YAAY,GACZ,SAAS,GACT,iBAAiB,GACjB,uBAAuB,GACvB,2BAA2B,CAC9B,GACA,mBAAmB,EAAE,CAwBvB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,IAAI,wBAAwB,CAE7F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG;IAC1E,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;CAClC,CAqBA;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,aAAa,CAUf"}
+{"version":3,"file":"finalized-record.d.ts","sourceRoot":"","sources":["../../src/sports/finalized-record.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AAE7F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,aAAa,EAAE,EAChC,QAAQ,EAAE,IAAI,CACZ,aAAa,EACX,YAAY,GACZ,SAAS,GACT,iBAAiB,GACjB,uBAAuB,GACvB,2BAA2B,CAC9B,GACA,mBAAmB,EAAE,CA6BvB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,IAAI,wBAAwB,CAE7F;AAKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,GAAG;IAC1E,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;CAClC,CAkCA;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,SAAS,mBAAmB,EAAE,GACpC,aAAa,CAUf"}

package/dist/sports/finalized-record.js

@@ -1,9 +1,12 @@
-import { STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';
+import { MAX_STAT_HISTORY_PAGES, STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';
 import { buildStatHistoryPageId } from '../ids/stat-event-ids.js';
 import { replayGameStats } from './replay.js';
 export function buildFinalizedRecordPages(events, snapshot) {
     const ordered = [...events].sort((left, right) => left.sequence - right.sequence);
     const pageCount = Math.max(1, Math.ceil(ordered.length / STAT_HISTORY_PAGE_SIZE));
+    if (pageCount > MAX_STAT_HISTORY_PAGES) {
+        throw new RangeError(`A finalized record holds at most ${MAX_STAT_HISTORY_PAGES} pages; ${ordered.length} events need ${pageCount}.`);
+    }
     const pages = [];
     for (let index = 0; index < pageCount; index += 1) {
         const slice = ordered.slice(index * STAT_HISTORY_PAGE_SIZE, (index + 1) * STAT_HISTORY_PAGE_SIZE);
@@ -25,13 +28,29 @@ export function buildFinalizedRecordPages(events, snapshot) {
 export function isFirstRecordPage(page) {
     return 'pageCount' in page;
 }
+// The pages as the record's collection lists them, in id order. They are one whole record only as
+// the exact set: the first page at `page_0000`, then a continuation page at each next id, as many in
+// all as the first page counts.
 export function readFinalizedRecord(pages) {
-    const [first, ...rest] = pages;
+    if (pages.length > MAX_STAT_HISTORY_PAGES) {
+        throw new Error(`A finalized record holds at most ${MAX_STAT_HISTORY_PAGES} pages.`);
+    }
+    const [firstEntry, ...restEntries] = pages;
+    const first = firstEntry?.page;
     if (first === undefined || !isFirstRecordPage(first))
         throw new Error('A finalized record starts with its first page.');
     if (first.pageCount !== pages.length) {
         throw new Error(`A finalized record of ${first.pageCount} pages was read as ${pages.length}.`);
     }
+    pages.forEach(({ pageId, page }, index) => {
+        if (pageId !== buildStatHistoryPageId(index)) {
+            throw new Error(`A finalized record holds page ${pageId} at position ${index}.`);
+        }
+        if (index > 0 && isFirstRecordPage(page)) {
+            throw new Error(`A finalized record holds a second first page at ${pageId}.`);
+        }
+    });
+    const rest = restEntries.map(({ page }) => page);
     const events = [...first.events, ...rest.flatMap((page) => page.events)];
     events.forEach((event, index) => {
         if (index > 0 && events[index - 1].sequence >= event.sequence) {

package/dist/sports/finalized-record.js.map

@@ -1 +1 @@
-{"version":3,"file":"finalized-record.js","sourceRoot":"","sources":["../../src/sports/finalized-record.ts"],"names":[],"mappings":"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","sourcesContent":["import { STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';\nimport type { GameStatEvent } from '../doc-schemas/game-stats.js';\nimport type {\n  GameStatHistoryFirstPage,\n  GameStatHistoryPage,\n} from '../doc-schemas/game-stat-history.js';\nimport { buildStatHistoryPageId } from '../ids/stat-event-ids.js';\nimport type { FinalizedGame } from './contribution.js';\nimport { replayGameStats } from './replay.js';\nimport type { AnySportAdapter } from './sport-adapter.js';\n\nexport type FinalizedRecordSnapshot = Omit<GameStatHistoryFirstPage, 'events' | 'pageCount'>;\n\nexport interface FinalizedRecordPage {\n  readonly pageId: string;\n  readonly page: GameStatHistoryPage;\n}\n\nexport function buildFinalizedRecordPages(\n  events: readonly GameStatEvent[],\n  snapshot: Pick<\n    FinalizedGame,\n    | 'leagueType'\n    | 'teamIds'\n    | 'rosterPlayerIds'\n    | 'absentRosterPlayerIds'\n    | 'nonScoringRosterPlayerIds'\n  >,\n): FinalizedRecordPage[] {\n  const ordered = [...events].sort((left, right) => left.sequence - right.sequence);\n  const pageCount = Math.max(1, Math.ceil(ordered.length / STAT_HISTORY_PAGE_SIZE));\n  const pages: FinalizedRecordPage[] = [];\n  for (let index = 0; index < pageCount; index += 1) {\n    const slice = ordered.slice(\n      index * STAT_HISTORY_PAGE_SIZE,\n      (index + 1) * STAT_HISTORY_PAGE_SIZE,\n    );\n    const page: GameStatHistoryPage =\n      index === 0\n        ? {\n            events: slice,\n            pageCount,\n            leagueType: snapshot.leagueType,\n            teamIds: [...snapshot.teamIds],\n            rosterPlayerIds: [...snapshot.rosterPlayerIds],\n            absentRosterPlayerIds: [...snapshot.absentRosterPlayerIds],\n            nonScoringRosterPlayerIds: [...snapshot.nonScoringRosterPlayerIds],\n          }\n        : { events: slice };\n    pages.push({ pageId: buildStatHistoryPageId(index), page });\n  }\n  return pages;\n}\n\nexport function isFirstRecordPage(page: GameStatHistoryPage): page is GameStatHistoryFirstPage {\n  return 'pageCount' in page;\n}\n\nexport function readFinalizedRecord(pages: readonly GameStatHistoryPage[]): {\n  readonly snapshot: FinalizedRecordSnapshot;\n  readonly events: GameStatEvent[];\n} {\n  const [first, ...rest] = pages;\n  if (first === undefined || !isFirstRecordPage(first))\n    throw new Error('A finalized record starts with its first page.');\n  if (first.pageCount !== pages.length) {\n    throw new Error(`A finalized record of ${first.pageCount} pages was read as ${pages.length}.`);\n  }\n  const events = [...first.events, ...rest.flatMap((page) => page.events)];\n  events.forEach((event, index) => {\n    if (index > 0 && (events[index - 1] as GameStatEvent).sequence >= event.sequence) {\n      throw new Error(`A finalized record holds event ${event.eventId} out of sequence.`);\n    }\n  });\n  const snapshot: FinalizedRecordSnapshot = {\n    leagueType: first.leagueType,\n    teamIds: first.teamIds,\n    rosterPlayerIds: first.rosterPlayerIds,\n    absentRosterPlayerIds: first.absentRosterPlayerIds,\n    nonScoringRosterPlayerIds: first.nonScoringRosterPlayerIds,\n  };\n  return { snapshot, events };\n}\n\nexport function finalizedGameFromRecord(\n  adapter: AnySportAdapter,\n  pages: readonly GameStatHistoryPage[],\n): FinalizedGame {\n  const { snapshot, events } = readFinalizedRecord(pages);\n  return {\n    leagueType: snapshot.leagueType,\n    teamIds: snapshot.teamIds,\n    stats: replayGameStats(adapter, snapshot, events),\n    rosterPlayerIds: snapshot.rosterPlayerIds,\n    absentRosterPlayerIds: snapshot.absentRosterPlayerIds,\n    nonScoringRosterPlayerIds: snapshot.nonScoringRosterPlayerIds,\n  };\n}\n"]}
+{"version":3,"file":"finalized-record.js","sourceRoot":"","sources":["../../src/sports/finalized-record.ts"],"names":[],"mappings":"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","sourcesContent":["import { MAX_STAT_HISTORY_PAGES, STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';\nimport type { GameStatEvent } from '../doc-schemas/game-stats.js';\nimport type {\n  GameStatHistoryFirstPage,\n  GameStatHistoryPage,\n} from '../doc-schemas/game-stat-history.js';\nimport { buildStatHistoryPageId } from '../ids/stat-event-ids.js';\nimport type { FinalizedGame } from './contribution.js';\nimport { replayGameStats } from './replay.js';\nimport type { AnySportAdapter } from './sport-adapter.js';\n\nexport type FinalizedRecordSnapshot = Omit<GameStatHistoryFirstPage, 'events' | 'pageCount'>;\n\nexport interface FinalizedRecordPage {\n  readonly pageId: string;\n  readonly page: GameStatHistoryPage;\n}\n\nexport function buildFinalizedRecordPages(\n  events: readonly GameStatEvent[],\n  snapshot: Pick<\n    FinalizedGame,\n    | 'leagueType'\n    | 'teamIds'\n    | 'rosterPlayerIds'\n    | 'absentRosterPlayerIds'\n    | 'nonScoringRosterPlayerIds'\n  >,\n): FinalizedRecordPage[] {\n  const ordered = [...events].sort((left, right) => left.sequence - right.sequence);\n  const pageCount = Math.max(1, Math.ceil(ordered.length / STAT_HISTORY_PAGE_SIZE));\n  if (pageCount > MAX_STAT_HISTORY_PAGES) {\n    throw new RangeError(\n      `A finalized record holds at most ${MAX_STAT_HISTORY_PAGES} pages; ${ordered.length} events need ${pageCount}.`,\n    );\n  }\n  const pages: FinalizedRecordPage[] = [];\n  for (let index = 0; index < pageCount; index += 1) {\n    const slice = ordered.slice(\n      index * STAT_HISTORY_PAGE_SIZE,\n      (index + 1) * STAT_HISTORY_PAGE_SIZE,\n    );\n    const page: GameStatHistoryPage =\n      index === 0\n        ? {\n            events: slice,\n            pageCount,\n            leagueType: snapshot.leagueType,\n            teamIds: [...snapshot.teamIds],\n            rosterPlayerIds: [...snapshot.rosterPlayerIds],\n            absentRosterPlayerIds: [...snapshot.absentRosterPlayerIds],\n            nonScoringRosterPlayerIds: [...snapshot.nonScoringRosterPlayerIds],\n          }\n        : { events: slice };\n    pages.push({ pageId: buildStatHistoryPageId(index), page });\n  }\n  return pages;\n}\n\nexport function isFirstRecordPage(page: GameStatHistoryPage): page is GameStatHistoryFirstPage {\n  return 'pageCount' in page;\n}\n\n// The pages as the record's collection lists them, in id order. They are one whole record only as\n// the exact set: the first page at `page_0000`, then a continuation page at each next id, as many in\n// all as the first page counts.\nexport function readFinalizedRecord(pages: readonly FinalizedRecordPage[]): {\n  readonly snapshot: FinalizedRecordSnapshot;\n  readonly events: GameStatEvent[];\n} {\n  if (pages.length > MAX_STAT_HISTORY_PAGES) {\n    throw new Error(`A finalized record holds at most ${MAX_STAT_HISTORY_PAGES} pages.`);\n  }\n  const [firstEntry, ...restEntries] = pages;\n  const first = firstEntry?.page;\n  if (first === undefined || !isFirstRecordPage(first))\n    throw new Error('A finalized record starts with its first page.');\n  if (first.pageCount !== pages.length) {\n    throw new Error(`A finalized record of ${first.pageCount} pages was read as ${pages.length}.`);\n  }\n  pages.forEach(({ pageId, page }, index) => {\n    if (pageId !== buildStatHistoryPageId(index)) {\n      throw new Error(`A finalized record holds page ${pageId} at position ${index}.`);\n    }\n    if (index > 0 && isFirstRecordPage(page)) {\n      throw new Error(`A finalized record holds a second first page at ${pageId}.`);\n    }\n  });\n  const rest = restEntries.map(({ page }) => page);\n  const events = [...first.events, ...rest.flatMap((page) => page.events)];\n  events.forEach((event, index) => {\n    if (index > 0 && (events[index - 1] as GameStatEvent).sequence >= event.sequence) {\n      throw new Error(`A finalized record holds event ${event.eventId} out of sequence.`);\n    }\n  });\n  const snapshot: FinalizedRecordSnapshot = {\n    leagueType: first.leagueType,\n    teamIds: first.teamIds,\n    rosterPlayerIds: first.rosterPlayerIds,\n    absentRosterPlayerIds: first.absentRosterPlayerIds,\n    nonScoringRosterPlayerIds: first.nonScoringRosterPlayerIds,\n  };\n  return { snapshot, events };\n}\n\nexport function finalizedGameFromRecord(\n  adapter: AnySportAdapter,\n  pages: readonly FinalizedRecordPage[],\n): FinalizedGame {\n  const { snapshot, events } = readFinalizedRecord(pages);\n  return {\n    leagueType: snapshot.leagueType,\n    teamIds: snapshot.teamIds,\n    stats: replayGameStats(adapter, snapshot, events),\n    rosterPlayerIds: snapshot.rosterPlayerIds,\n    absentRosterPlayerIds: snapshot.absentRosterPlayerIds,\n    nonScoringRosterPlayerIds: snapshot.nonScoringRosterPlayerIds,\n  };\n}\n"]}

package/dist/types/audit.d.ts

@@ -1,6 +1,6 @@
 import type { SystemRole } from './unions.js';
 import { CAPTAIN_TEAM_ROLES } from './unions.js';
-export declare const AUDIT_EVENT_TYPE_KEYS: readonly ["user.accountRegistered", "user.displayNameChanged", "user.abandonedRegistrationDeleted", "user.signedIn", "user.passwordResetCompleted", "user.accountBanned", "user.accountUnbanned", "admin.systemRoleGranted", "admin.systemRoleRevoked", "admin.systemRoleClaimSynced", "appConfig.updated", "landingPage.updated", "league.created", "league.updated", "league.statusChanged", "league.modeSwitched", "waiverTemplate.created", "waiverTemplate.versionPublished", "waiverTemplate.retired", "waiverTemplate.deleted", "gameLocation.created", "gameLocation.updated", "gameLocation.deleted", "picture.added", "picture.replaced", "picture.moved", "picture.featuredChanged", "picture.removed", "award.created", "award.badgeReplaced", "award.deleted", "award.granted", "award.revoked", "hardwareLoanContract.created", "hardwareLoanContract.signed", "hardwareLoanContract.returned", "hardwareLoanContract.deleted", "leagueTeam.created", "ghostPlayer.created", "teamRoster.syncRetried", "teamMembership.roleChanged", "leagueTeam.captainChanged", "leagueTeam.updated", "leagueTeamContact.updated", "teamMembership.removed", "ghostPlayer.removed", "ghostPlayer.linked", "ghostPlayer.closedLeagueLinked", "leagueTeam.deleted", "ghostPlayer.removalStopped", "teamInvitation.created", "teamInvitation.cancelled", "teamInvitation.accepted", "teamInvitation.rejected", "teamJoinRequest.created", "teamJoinRequest.cancelled", "teamJoinRequest.accepted", "teamJoinRequest.rejected", "leagueFreeAgent.created", "leagueFreeAgent.deleted", "leagueFreeAgent.assigned", "signedWaiver.created", "scheduleWeek.created", "scheduleWeek.updated", "sportGame.created", "sportGame.updated", "sportGame.deleted", "sportGame.statEventsRejected", "sportGame.absenceChanged", "sportGame.memoUpdated", "sportGame.jumpBallChanged", "sportGame.finalized", "sportGame.reopened", "sportGame.statsCorrected", "sportGame.statsRecalculated", "stats.aggregateRecalculated", "stats.historicalStatsUpdated", "stats.validationRun", "stats.validationReportDeleted", "stats.unrosteredStatLineResolved", "adminNotification.archived", "adminNotification.archiveAllRequested", "system.manualIntervention", "migrationAction.pageRun", "migrationAction.writesCommitted", "migrationAction.controlRecorded", "migrationAction.checkpointRecorded", "migrationConsole.cutoverRecorded"];
+export declare const AUDIT_EVENT_TYPE_KEYS: readonly ["user.accountRegistered", "user.displayNameChanged", "user.abandonedRegistrationDeleted", "user.signedIn", "user.passwordResetCompleted", "user.accountBanned", "user.accountUnbanned", "admin.systemRoleGranted", "admin.systemRoleRevoked", "admin.systemRoleClaimSynced", "appConfig.updated", "landingPage.updated", "league.created", "league.updated", "league.statusChanged", "league.modeSwitched", "waiverTemplate.created", "waiverTemplate.versionPublished", "waiverTemplate.retired", "waiverTemplate.deleted", "gameLocation.created", "gameLocation.updated", "gameLocation.deleted", "picture.added", "picture.replaced", "picture.moved", "picture.featuredChanged", "picture.removed", "award.created", "award.badgeReplaced", "award.deleted", "award.granted", "award.revoked", "award.groupDecisionOpened", "hardwareLoanContract.created", "hardwareLoanContract.signed", "hardwareLoanContract.returned", "hardwareLoanContract.deleted", "leagueTeam.created", "ghostPlayer.created", "teamRoster.syncRetried", "teamMembership.roleChanged", "leagueTeam.captainChanged", "leagueTeam.updated", "leagueTeamContact.updated", "teamMembership.removed", "ghostPlayer.removed", "ghostPlayer.linked", "ghostPlayer.closedLeagueLinked", "leagueTeam.deleted", "ghostPlayer.removalStopped", "teamInvitation.created", "teamInvitation.cancelled", "teamInvitation.accepted", "teamInvitation.rejected", "teamJoinRequest.created", "teamJoinRequest.cancelled", "teamJoinRequest.accepted", "teamJoinRequest.rejected", "leagueFreeAgent.created", "leagueFreeAgent.deleted", "leagueFreeAgent.assigned", "signedWaiver.created", "scheduleWeek.created", "scheduleWeek.updated", "sportGame.created", "sportGame.updated", "sportGame.deleted", "sportGame.statEventsRejected", "sportGame.absenceChanged", "sportGame.memoUpdated", "sportGame.jumpBallChanged", "sportGame.finalized", "sportGame.reopened", "sportGame.statsCorrected", "sportGame.statsRecalculated", "stats.aggregateRecalculated", "stats.historicalStatsUpdated", "stats.validationRun", "stats.validationReportDeleted", "stats.unrosteredStatLineResolved", "adminNotification.archived", "adminNotification.archiveAllRequested", "system.manualIntervention", "migrationAction.pageRun", "migrationAction.writesCommitted", "migrationAction.controlRecorded", "migrationAction.checkpointRecorded", "migrationConsole.cutoverRecorded"];
 export type AuditEventType = (typeof AUDIT_EVENT_TYPE_KEYS)[number];
 export declare const GHOST_LINK_AUDIT_EVENT_TYPE_KEYS: readonly ["ghostPlayer.linked", "ghostPlayer.closedLeagueLinked"];
 export type GhostLinkAuditEventType = (typeof GHOST_LINK_AUDIT_EVENT_TYPE_KEYS)[number];

package/dist/types/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,qBAAqB,0xEAyFxB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,gCAAgC,mEAGC,CAAC;AAC/C,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,eAAO,MAAM,qBAAqB,6EAMxB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,2BAA2B,2CAGM,CAAC;AAC/C,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,eAAO,MAAM,+BAA+B,6CAIE,CAAC;AAC/C,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtF,eAAO,MAAM,wBAAwB,mDAAoD,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,MAAM,UAAU,GAClB;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,sBAAsB,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/F;IACE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,eAAO,MAAM,iBAAiB,iCAAkC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,qBAAqB,uzEA0FxB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,gCAAgC,mEAGC,CAAC;AAC/C,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,gCAAgC,CAAC,CAAC,MAAM,CAAC,CAAC;AAExF,eAAO,MAAM,qBAAqB,6EAMxB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,eAAO,MAAM,2BAA2B,2CAGM,CAAC;AAC/C,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/E,eAAO,MAAM,+BAA+B,6CAIE,CAAC;AAC/C,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtF,eAAO,MAAM,wBAAwB,mDAAoD,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,MAAM,UAAU,GAClB;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,sBAAsB,CAAC;IAAC,UAAU,CAAC,EAAE,KAAK,CAAA;CAAE,GAC/F;IACE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,UAAU,EAAE,UAAU,CAAC;CACxB,CAAC;AAEN,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,eAAO,MAAM,iBAAiB,iCAAkC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/types/audit.js

@@ -32,6 +32,7 @@ export const AUDIT_EVENT_TYPE_KEYS = [
     'award.deleted',
     'award.granted',
     'award.revoked',
+    'award.groupDecisionOpened',
     'hardwareLoanContract.created',
     'hardwareLoanContract.signed',
     'hardwareLoanContract.returned',

package/dist/types/audit.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,yBAAyB;IACzB,mCAAmC;IACnC,eAAe;IACf,6BAA6B;IAC7B,oBAAoB;IACpB,sBAAsB;IACtB,yBAAyB;IACzB,yBAAyB;IACzB,6BAA6B;IAC7B,mBAAmB;IACnB,qBAAqB;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;IACxB,iCAAiC;IACjC,wBAAwB;IACxB,wBAAwB;IACxB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,yBAAyB;IACzB,iBAAiB;IACjB,eAAe;IACf,qBAAqB;IACrB,eAAe;IACf,eAAe;IACf,eAAe;IACf,8BAA8B;IAC9B,6BAA6B;IAC7B,+BAA+B;IAC/B,8BAA8B;IAC9B,oBAAoB;IACpB,qBAAqB;IACrB,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,oBAAoB;IACpB,2BAA2B;IAC3B,wBAAwB;IACxB,qBAAqB;IACrB,oBAAoB;IACpB,gCAAgC;IAChC,oBAAoB;IACpB,4BAA4B;IAC5B,wBAAwB;IACxB,0BAA0B;IAC1B,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,0BAA0B;IAC1B,0BAA0B;IAC1B,yBAAyB;IACzB,yBAAyB;IACzB,0BAA0B;IAC1B,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,8BAA8B;IAC9B,0BAA0B;IAC1B,uBAAuB;IACvB,2BAA2B;IAC3B,qBAAqB;IACrB,oBAAoB;IACpB,0BAA0B;IAC1B,6BAA6B;IAC7B,6BAA6B;IAC7B,8BAA8B;IAC9B,qBAAqB;IACrB,+BAA+B;IAC/B,kCAAkC;IAClC,4BAA4B;IAC5B,uCAAuC;IACvC,2BAA2B;IAC3B,yBAAyB;IACzB,iCAAiC;IACjC,iCAAiC;IACjC,oCAAoC;IACpC,kCAAkC;CAC1B,CAAC;AAGX,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,oBAAoB;IACpB,gCAAgC;CACY,CAAC;AAG/C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM;IACN,cAAc;IACd,aAAa;IACb,eAAe;IACf,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,aAAa;IACb,eAAe;CAC6B,CAAC;AAG/C,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,MAAM;IACN,cAAc;IACd,QAAQ;CACoC,CAAC;AAG/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAmB1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,CAAU,CAAC","sourcesContent":["import type { SystemRole } from './unions.js';\nimport { CAPTAIN_TEAM_ROLES } from './unions.js';\n\nexport const AUDIT_EVENT_TYPE_KEYS = [\n  'user.accountRegistered',\n  'user.displayNameChanged',\n  'user.abandonedRegistrationDeleted',\n  'user.signedIn',\n  'user.passwordResetCompleted',\n  'user.accountBanned',\n  'user.accountUnbanned',\n  'admin.systemRoleGranted',\n  'admin.systemRoleRevoked',\n  'admin.systemRoleClaimSynced',\n  'appConfig.updated',\n  'landingPage.updated',\n  'league.created',\n  'league.updated',\n  'league.statusChanged',\n  'league.modeSwitched',\n  'waiverTemplate.created',\n  'waiverTemplate.versionPublished',\n  'waiverTemplate.retired',\n  'waiverTemplate.deleted',\n  'gameLocation.created',\n  'gameLocation.updated',\n  'gameLocation.deleted',\n  'picture.added',\n  'picture.replaced',\n  'picture.moved',\n  'picture.featuredChanged',\n  'picture.removed',\n  'award.created',\n  'award.badgeReplaced',\n  'award.deleted',\n  'award.granted',\n  'award.revoked',\n  'hardwareLoanContract.created',\n  'hardwareLoanContract.signed',\n  'hardwareLoanContract.returned',\n  'hardwareLoanContract.deleted',\n  'leagueTeam.created',\n  'ghostPlayer.created',\n  'teamRoster.syncRetried',\n  'teamMembership.roleChanged',\n  'leagueTeam.captainChanged',\n  'leagueTeam.updated',\n  'leagueTeamContact.updated',\n  'teamMembership.removed',\n  'ghostPlayer.removed',\n  'ghostPlayer.linked',\n  'ghostPlayer.closedLeagueLinked',\n  'leagueTeam.deleted',\n  'ghostPlayer.removalStopped',\n  'teamInvitation.created',\n  'teamInvitation.cancelled',\n  'teamInvitation.accepted',\n  'teamInvitation.rejected',\n  'teamJoinRequest.created',\n  'teamJoinRequest.cancelled',\n  'teamJoinRequest.accepted',\n  'teamJoinRequest.rejected',\n  'leagueFreeAgent.created',\n  'leagueFreeAgent.deleted',\n  'leagueFreeAgent.assigned',\n  'signedWaiver.created',\n  'scheduleWeek.created',\n  'scheduleWeek.updated',\n  'sportGame.created',\n  'sportGame.updated',\n  'sportGame.deleted',\n  'sportGame.statEventsRejected',\n  'sportGame.absenceChanged',\n  'sportGame.memoUpdated',\n  'sportGame.jumpBallChanged',\n  'sportGame.finalized',\n  'sportGame.reopened',\n  'sportGame.statsCorrected',\n  'sportGame.statsRecalculated',\n  'stats.aggregateRecalculated',\n  'stats.historicalStatsUpdated',\n  'stats.validationRun',\n  'stats.validationReportDeleted',\n  'stats.unrosteredStatLineResolved',\n  'adminNotification.archived',\n  'adminNotification.archiveAllRequested',\n  'system.manualIntervention',\n  'migrationAction.pageRun',\n  'migrationAction.writesCommitted',\n  'migrationAction.controlRecorded',\n  'migrationAction.checkpointRecorded',\n  'migrationConsole.cutoverRecorded',\n] as const;\nexport type AuditEventType = (typeof AUDIT_EVENT_TYPE_KEYS)[number];\n\nexport const GHOST_LINK_AUDIT_EVENT_TYPE_KEYS = [\n  'ghostPlayer.linked',\n  'ghostPlayer.closedLeagueLinked',\n] as const satisfies readonly AuditEventType[];\nexport type GhostLinkAuditEventType = (typeof GHOST_LINK_AUDIT_EVENT_TYPE_KEYS)[number];\n\nexport const AUDIT_ACTOR_MODE_KEYS = [\n  'user',\n  'teammateUser',\n  'adminReview',\n  'adminOverride',\n  'system',\n] as const;\nexport type AuditActorMode = (typeof AUDIT_ACTOR_MODE_KEYS)[number];\n\nexport const AUDIT_ADMIN_ACTOR_MODE_KEYS = [\n  'adminReview',\n  'adminOverride',\n] as const satisfies readonly AuditActorMode[];\nexport type AuditAdminActorMode = (typeof AUDIT_ADMIN_ACTOR_MODE_KEYS)[number];\n\nexport const AUDIT_NON_ADMIN_ACTOR_MODE_KEYS = [\n  'user',\n  'teammateUser',\n  'system',\n] as const satisfies readonly AuditActorMode[];\nexport type AuditNonAdminActorMode = (typeof AUDIT_NON_ADMIN_ACTOR_MODE_KEYS)[number];\n\nexport const AUDIT_SYSTEM_REASON_KEYS = ['trigger', 'scheduledJob', 'migration'] as const;\nexport type AuditSystemReason = (typeof AUDIT_SYSTEM_REASON_KEYS)[number];\n\nexport type CaptainTeamRole = (typeof CAPTAIN_TEAM_ROLES)[number];\n\nexport type AuditActor =\n  | { uid: string | null; isAdmin: boolean; actorMode: AuditNonAdminActorMode; systemRole?: never }\n  | {\n      uid: string | null;\n      isAdmin: boolean;\n      actorMode: AuditAdminActorMode;\n      systemRole: SystemRole;\n    };\n\nexport interface AuditTarget {\n  uid: string | null;\n  ref: string | null;\n}\n\nexport const AUDIT_RESULT_KEYS = ['success', 'failure'] as const;\nexport type AuditResult = (typeof AUDIT_RESULT_KEYS)[number];\n"]}
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/types/audit.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,wBAAwB;IACxB,yBAAyB;IACzB,mCAAmC;IACnC,eAAe;IACf,6BAA6B;IAC7B,oBAAoB;IACpB,sBAAsB;IACtB,yBAAyB;IACzB,yBAAyB;IACzB,6BAA6B;IAC7B,mBAAmB;IACnB,qBAAqB;IACrB,gBAAgB;IAChB,gBAAgB;IAChB,sBAAsB;IACtB,qBAAqB;IACrB,wBAAwB;IACxB,iCAAiC;IACjC,wBAAwB;IACxB,wBAAwB;IACxB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,yBAAyB;IACzB,iBAAiB;IACjB,eAAe;IACf,qBAAqB;IACrB,eAAe;IACf,eAAe;IACf,eAAe;IACf,2BAA2B;IAC3B,8BAA8B;IAC9B,6BAA6B;IAC7B,+BAA+B;IAC/B,8BAA8B;IAC9B,oBAAoB;IACpB,qBAAqB;IACrB,wBAAwB;IACxB,4BAA4B;IAC5B,2BAA2B;IAC3B,oBAAoB;IACpB,2BAA2B;IAC3B,wBAAwB;IACxB,qBAAqB;IACrB,oBAAoB;IACpB,gCAAgC;IAChC,oBAAoB;IACpB,4BAA4B;IAC5B,wBAAwB;IACxB,0BAA0B;IAC1B,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;IACzB,2BAA2B;IAC3B,0BAA0B;IAC1B,0BAA0B;IAC1B,yBAAyB;IACzB,yBAAyB;IACzB,0BAA0B;IAC1B,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,mBAAmB;IACnB,mBAAmB;IACnB,mBAAmB;IACnB,8BAA8B;IAC9B,0BAA0B;IAC1B,uBAAuB;IACvB,2BAA2B;IAC3B,qBAAqB;IACrB,oBAAoB;IACpB,0BAA0B;IAC1B,6BAA6B;IAC7B,6BAA6B;IAC7B,8BAA8B;IAC9B,qBAAqB;IACrB,+BAA+B;IAC/B,kCAAkC;IAClC,4BAA4B;IAC5B,uCAAuC;IACvC,2BAA2B;IAC3B,yBAAyB;IACzB,iCAAiC;IACjC,iCAAiC;IACjC,oCAAoC;IACpC,kCAAkC;CAC1B,CAAC;AAGX,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,oBAAoB;IACpB,gCAAgC;CACY,CAAC;AAG/C,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,MAAM;IACN,cAAc;IACd,aAAa;IACb,eAAe;IACf,QAAQ;CACA,CAAC;AAGX,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,aAAa;IACb,eAAe;CAC6B,CAAC;AAG/C,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,MAAM;IACN,cAAc;IACd,QAAQ;CACoC,CAAC;AAG/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,SAAS,EAAE,cAAc,EAAE,WAAW,CAAU,CAAC;AAmB1F,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,SAAS,CAAU,CAAC","sourcesContent":["import type { SystemRole } from './unions.js';\nimport { CAPTAIN_TEAM_ROLES } from './unions.js';\n\nexport const AUDIT_EVENT_TYPE_KEYS = [\n  'user.accountRegistered',\n  'user.displayNameChanged',\n  'user.abandonedRegistrationDeleted',\n  'user.signedIn',\n  'user.passwordResetCompleted',\n  'user.accountBanned',\n  'user.accountUnbanned',\n  'admin.systemRoleGranted',\n  'admin.systemRoleRevoked',\n  'admin.systemRoleClaimSynced',\n  'appConfig.updated',\n  'landingPage.updated',\n  'league.created',\n  'league.updated',\n  'league.statusChanged',\n  'league.modeSwitched',\n  'waiverTemplate.created',\n  'waiverTemplate.versionPublished',\n  'waiverTemplate.retired',\n  'waiverTemplate.deleted',\n  'gameLocation.created',\n  'gameLocation.updated',\n  'gameLocation.deleted',\n  'picture.added',\n  'picture.replaced',\n  'picture.moved',\n  'picture.featuredChanged',\n  'picture.removed',\n  'award.created',\n  'award.badgeReplaced',\n  'award.deleted',\n  'award.granted',\n  'award.revoked',\n  'award.groupDecisionOpened',\n  'hardwareLoanContract.created',\n  'hardwareLoanContract.signed',\n  'hardwareLoanContract.returned',\n  'hardwareLoanContract.deleted',\n  'leagueTeam.created',\n  'ghostPlayer.created',\n  'teamRoster.syncRetried',\n  'teamMembership.roleChanged',\n  'leagueTeam.captainChanged',\n  'leagueTeam.updated',\n  'leagueTeamContact.updated',\n  'teamMembership.removed',\n  'ghostPlayer.removed',\n  'ghostPlayer.linked',\n  'ghostPlayer.closedLeagueLinked',\n  'leagueTeam.deleted',\n  'ghostPlayer.removalStopped',\n  'teamInvitation.created',\n  'teamInvitation.cancelled',\n  'teamInvitation.accepted',\n  'teamInvitation.rejected',\n  'teamJoinRequest.created',\n  'teamJoinRequest.cancelled',\n  'teamJoinRequest.accepted',\n  'teamJoinRequest.rejected',\n  'leagueFreeAgent.created',\n  'leagueFreeAgent.deleted',\n  'leagueFreeAgent.assigned',\n  'signedWaiver.created',\n  'scheduleWeek.created',\n  'scheduleWeek.updated',\n  'sportGame.created',\n  'sportGame.updated',\n  'sportGame.deleted',\n  'sportGame.statEventsRejected',\n  'sportGame.absenceChanged',\n  'sportGame.memoUpdated',\n  'sportGame.jumpBallChanged',\n  'sportGame.finalized',\n  'sportGame.reopened',\n  'sportGame.statsCorrected',\n  'sportGame.statsRecalculated',\n  'stats.aggregateRecalculated',\n  'stats.historicalStatsUpdated',\n  'stats.validationRun',\n  'stats.validationReportDeleted',\n  'stats.unrosteredStatLineResolved',\n  'adminNotification.archived',\n  'adminNotification.archiveAllRequested',\n  'system.manualIntervention',\n  'migrationAction.pageRun',\n  'migrationAction.writesCommitted',\n  'migrationAction.controlRecorded',\n  'migrationAction.checkpointRecorded',\n  'migrationConsole.cutoverRecorded',\n] as const;\nexport type AuditEventType = (typeof AUDIT_EVENT_TYPE_KEYS)[number];\n\nexport const GHOST_LINK_AUDIT_EVENT_TYPE_KEYS = [\n  'ghostPlayer.linked',\n  'ghostPlayer.closedLeagueLinked',\n] as const satisfies readonly AuditEventType[];\nexport type GhostLinkAuditEventType = (typeof GHOST_LINK_AUDIT_EVENT_TYPE_KEYS)[number];\n\nexport const AUDIT_ACTOR_MODE_KEYS = [\n  'user',\n  'teammateUser',\n  'adminReview',\n  'adminOverride',\n  'system',\n] as const;\nexport type AuditActorMode = (typeof AUDIT_ACTOR_MODE_KEYS)[number];\n\nexport const AUDIT_ADMIN_ACTOR_MODE_KEYS = [\n  'adminReview',\n  'adminOverride',\n] as const satisfies readonly AuditActorMode[];\nexport type AuditAdminActorMode = (typeof AUDIT_ADMIN_ACTOR_MODE_KEYS)[number];\n\nexport const AUDIT_NON_ADMIN_ACTOR_MODE_KEYS = [\n  'user',\n  'teammateUser',\n  'system',\n] as const satisfies readonly AuditActorMode[];\nexport type AuditNonAdminActorMode = (typeof AUDIT_NON_ADMIN_ACTOR_MODE_KEYS)[number];\n\nexport const AUDIT_SYSTEM_REASON_KEYS = ['trigger', 'scheduledJob', 'migration'] as const;\nexport type AuditSystemReason = (typeof AUDIT_SYSTEM_REASON_KEYS)[number];\n\nexport type CaptainTeamRole = (typeof CAPTAIN_TEAM_ROLES)[number];\n\nexport type AuditActor =\n  | { uid: string | null; isAdmin: boolean; actorMode: AuditNonAdminActorMode; systemRole?: never }\n  | {\n      uid: string | null;\n      isAdmin: boolean;\n      actorMode: AuditAdminActorMode;\n      systemRole: SystemRole;\n    };\n\nexport interface AuditTarget {\n  uid: string | null;\n  ref: string | null;\n}\n\nexport const AUDIT_RESULT_KEYS = ['success', 'failure'] as const;\nexport type AuditResult = (typeof AUDIT_RESULT_KEYS)[number];\n"]}

package/dist/utils/index.d.ts

@@ -8,4 +8,5 @@ export * from './schedules.js';
 export * from './team-member-actions.js';
 export * from './league-mode.js';
 export * from './league-joining.js';
+export * from './stats-operation-request.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC"}

package/dist/utils/index.js

@@ -8,4 +8,5 @@ export * from './schedules.js';
 export * from './team-member-actions.js';
 export * from './league-mode.js';
 export * from './league-joining.js';
+export * from './stats-operation-request.js';
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC","sourcesContent":["export * from './display-name.js';\nexport * from './app-config.js';\nexport * from './league-calendar.js';\nexport * from './team-creation.js';\nexport * from './account-status.js';\nexport * from './league-join-warning.js';\nexport * from './schedules.js';\nexport * from './team-member-actions.js';\nexport * from './league-mode.js';\nexport * from './league-joining.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC","sourcesContent":["export * from './display-name.js';\nexport * from './app-config.js';\nexport * from './league-calendar.js';\nexport * from './team-creation.js';\nexport * from './account-status.js';\nexport * from './league-join-warning.js';\nexport * from './schedules.js';\nexport * from './team-member-actions.js';\nexport * from './league-mode.js';\nexport * from './league-joining.js';\nexport * from './stats-operation-request.js';\n"]}

package/dist/utils/league-calendar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"league-calendar.d.ts","sourceRoot":"","sources":["../../src/utils/league-calendar.ts"],"names":[],"mappings":"AAYA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpE;AAkCD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAmBzE"}
+{"version":3,"file":"league-calendar.d.ts","sourceRoot":"","sources":["../../src/utils/league-calendar.ts"],"names":[],"mappings":"AAYA,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpE;AAkCD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAwBzE"}

package/dist/utils/league-calendar.js

@@ -55,6 +55,11 @@ export function leagueInstantOf(dayKey, timeOfDay) {
     // The offset at the wall-clock reading taken as UTC is within a day of the right one; read again at
     // the instant that offset gives, so a reading on the other side of a change settles on its own.
     const firstGuess = wallClock - (leagueWallClockAsUtc(wallClock) - wallClock);
-    return wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);
+    const instant = wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);
+    // A reading the clocks skip forward over settles on another hour; only a real one reads back.
+    if (toLeagueDayKey(instant) !== dayKey || toLeagueTimeOfDay(instant) !== timeOfDay) {
+        throw new RangeError(`Not a time the league's clocks show: '${dayKey}' '${timeOfDay}'.`);
+    }
+    return instant;
 }
 //# sourceMappingURL=league-calendar.js.map

package/dist/utils/league-calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"league-calendar.js","sourceRoot":"","sources":["../../src/utils/league-calendar.ts"],"names":[],"mappings":"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","sourcesContent":["import { LEAGUE_TIME_ZONE } from '../constants/business.js';\n\n// `en-CA` formats a date as `YYYY-MM-DD`, the stored calendar-date shape.\nconst LEAGUE_DAY_FORMAT = new Intl.DateTimeFormat('en-CA', {\n  timeZone: LEAGUE_TIME_ZONE,\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n});\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\nexport function toLeagueDayKey(epochMs: number): string {\n  return LEAGUE_DAY_FORMAT.format(new Date(epochMs));\n}\n\nexport function addCalendarDays(dayKey: string, days: number): string {\n  const day = new Date(`${dayKey}T00:00:00.000Z`);\n  if (Number.isNaN(day.getTime())) {\n    throw new RangeError(`Not a calendar date: '${dayKey}'.`);\n  }\n  return new Date(day.getTime() + days * DAY_MS).toISOString().slice(0, 10);\n}\n\n// `h23` keeps midnight at hour 0.\nconst LEAGUE_WALL_CLOCK_FORMAT = new Intl.DateTimeFormat('en-US', {\n  timeZone: LEAGUE_TIME_ZONE,\n  hourCycle: 'h23',\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n  hour: '2-digit',\n  minute: '2-digit',\n  second: '2-digit',\n});\n\nconst CALENDAR_DAY_SHAPE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst TIME_OF_DAY_SHAPE = /^([01]\\d|2[0-3]):([0-5]\\d)$/;\n\nfunction leagueWallClockAsUtc(epochMs: number): number {\n  const parts = Object.fromEntries(\n    LEAGUE_WALL_CLOCK_FORMAT.formatToParts(new Date(epochMs)).map((part) => [\n      part.type,\n      part.value,\n    ]),\n  );\n  return Date.UTC(\n    Number(parts.year),\n    Number(parts.month) - 1,\n    Number(parts.day),\n    Number(parts.hour),\n    Number(parts.minute),\n    Number(parts.second),\n  );\n}\n\nexport function toLeagueTimeOfDay(epochMs: number): string {\n  const wallClock = new Date(leagueWallClockAsUtc(epochMs));\n  const hours = String(wallClock.getUTCHours()).padStart(2, '0');\n  const minutes = String(wallClock.getUTCMinutes()).padStart(2, '0');\n  return `${hours}:${minutes}`;\n}\n\nexport function leagueInstantOf(dayKey: string, timeOfDay: string): number {\n  const day = CALENDAR_DAY_SHAPE.exec(dayKey);\n  const time = TIME_OF_DAY_SHAPE.exec(timeOfDay);\n  if (!day || !time)\n    throw new RangeError(`Not a calendar day and time of day: '${dayKey}' '${timeOfDay}'.`);\n  const wallClock = Date.UTC(\n    Number(day[1]),\n    Number(day[2]) - 1,\n    Number(day[3]),\n    Number(time[1]),\n    Number(time[2]),\n  );\n  if (new Date(wallClock).toISOString().slice(0, 10) !== dayKey) {\n    throw new RangeError(`Not a calendar day: '${dayKey}'.`);\n  }\n  // The offset at the wall-clock reading taken as UTC is within a day of the right one; read again at\n  // the instant that offset gives, so a reading on the other side of a change settles on its own.\n  const firstGuess = wallClock - (leagueWallClockAsUtc(wallClock) - wallClock);\n  return wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);\n}\n"]}
+{"version":3,"file":"league-calendar.js","sourceRoot":"","sources":["../../src/utils/league-calendar.ts"],"names":[],"mappings":"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","sourcesContent":["import { LEAGUE_TIME_ZONE } from '../constants/business.js';\n\n// `en-CA` formats a date as `YYYY-MM-DD`, the stored calendar-date shape.\nconst LEAGUE_DAY_FORMAT = new Intl.DateTimeFormat('en-CA', {\n  timeZone: LEAGUE_TIME_ZONE,\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n});\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\nexport function toLeagueDayKey(epochMs: number): string {\n  return LEAGUE_DAY_FORMAT.format(new Date(epochMs));\n}\n\nexport function addCalendarDays(dayKey: string, days: number): string {\n  const day = new Date(`${dayKey}T00:00:00.000Z`);\n  if (Number.isNaN(day.getTime())) {\n    throw new RangeError(`Not a calendar date: '${dayKey}'.`);\n  }\n  return new Date(day.getTime() + days * DAY_MS).toISOString().slice(0, 10);\n}\n\n// `h23` keeps midnight at hour 0.\nconst LEAGUE_WALL_CLOCK_FORMAT = new Intl.DateTimeFormat('en-US', {\n  timeZone: LEAGUE_TIME_ZONE,\n  hourCycle: 'h23',\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n  hour: '2-digit',\n  minute: '2-digit',\n  second: '2-digit',\n});\n\nconst CALENDAR_DAY_SHAPE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst TIME_OF_DAY_SHAPE = /^([01]\\d|2[0-3]):([0-5]\\d)$/;\n\nfunction leagueWallClockAsUtc(epochMs: number): number {\n  const parts = Object.fromEntries(\n    LEAGUE_WALL_CLOCK_FORMAT.formatToParts(new Date(epochMs)).map((part) => [\n      part.type,\n      part.value,\n    ]),\n  );\n  return Date.UTC(\n    Number(parts.year),\n    Number(parts.month) - 1,\n    Number(parts.day),\n    Number(parts.hour),\n    Number(parts.minute),\n    Number(parts.second),\n  );\n}\n\nexport function toLeagueTimeOfDay(epochMs: number): string {\n  const wallClock = new Date(leagueWallClockAsUtc(epochMs));\n  const hours = String(wallClock.getUTCHours()).padStart(2, '0');\n  const minutes = String(wallClock.getUTCMinutes()).padStart(2, '0');\n  return `${hours}:${minutes}`;\n}\n\nexport function leagueInstantOf(dayKey: string, timeOfDay: string): number {\n  const day = CALENDAR_DAY_SHAPE.exec(dayKey);\n  const time = TIME_OF_DAY_SHAPE.exec(timeOfDay);\n  if (!day || !time)\n    throw new RangeError(`Not a calendar day and time of day: '${dayKey}' '${timeOfDay}'.`);\n  const wallClock = Date.UTC(\n    Number(day[1]),\n    Number(day[2]) - 1,\n    Number(day[3]),\n    Number(time[1]),\n    Number(time[2]),\n  );\n  if (new Date(wallClock).toISOString().slice(0, 10) !== dayKey) {\n    throw new RangeError(`Not a calendar day: '${dayKey}'.`);\n  }\n  // The offset at the wall-clock reading taken as UTC is within a day of the right one; read again at\n  // the instant that offset gives, so a reading on the other side of a change settles on its own.\n  const firstGuess = wallClock - (leagueWallClockAsUtc(wallClock) - wallClock);\n  const instant = wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);\n  // A reading the clocks skip forward over settles on another hour; only a real one reads back.\n  if (toLeagueDayKey(instant) !== dayKey || toLeagueTimeOfDay(instant) !== timeOfDay) {\n    throw new RangeError(`Not a time the league's clocks show: '${dayKey}' '${timeOfDay}'.`);\n  }\n  return instant;\n}\n"]}

package/dist/utils/stats-operation-request.d.ts

@@ -0,0 +1,20 @@
+import type { HistoricalStats } from '../doc-schemas/user-profile.js';
+import type { GameStatsCorrectionTarget } from '../schemas/stats.js';
+import type { SportKey } from '../types/sports.js';
+export type StatsOperationRequest = {
+    kind: 'gameStatsCorrection';
+    scope: {
+        gameId: string;
+    };
+    targets?: readonly GameStatsCorrectionTarget[];
+    keepStored?: true;
+} | {
+    kind: 'historicalStatsUpdate';
+    scope: {
+        userId: string;
+        sportKey: SportKey;
+    };
+    stats: HistoricalStats;
+};
+export declare function hashStatsOperationRequest(request: StatsOperationRequest): Promise<string>;
+//# sourceMappingURL=stats-operation-request.d.ts.map

package/dist/utils/stats-operation-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-operation-request.d.ts","sourceRoot":"","sources":["../../src/utils/stats-operation-request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGnD,MAAM,MAAM,qBAAqB,GAC7B;IACE,IAAI,EAAE,qBAAqB,CAAC;IAC5B,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC/C,UAAU,CAAC,EAAE,IAAI,CAAC;CACnB,GACD;IACE,IAAI,EAAE,uBAAuB,CAAC;IAC9B,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC9C,KAAK,EAAE,eAAe,CAAC;CACxB,CAAC;AAGN,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzF"}

package/dist/utils/stats-operation-request.js

@@ -0,0 +1,10 @@
+import { canonicalize, hashPayload } from '@ttt-productions/edge-protocol-core';
+// The same targets sent in another order are the same request.
+export function hashStatsOperationRequest(request) {
+    if (request.kind !== 'gameStatsCorrection' || request.targets === undefined) {
+        return hashPayload(request);
+    }
+    const targets = [...request.targets].sort((left, right) => canonicalize(left) < canonicalize(right) ? -1 : 1);
+    return hashPayload({ ...request, targets });
+}
+//# sourceMappingURL=stats-operation-request.js.map

package/dist/utils/stats-operation-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats-operation-request.js","sourceRoot":"","sources":["../../src/utils/stats-operation-request.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAmBhF,+DAA+D;AAC/D,MAAM,UAAU,yBAAyB,CAAC,OAA8B;IACtE,IAAI,OAAO,CAAC,IAAI,KAAK,qBAAqB,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC5E,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACxD,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAClD,CAAC;IACF,OAAO,WAAW,CAAC,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;AAC9C,CAAC","sourcesContent":["import { canonicalize, hashPayload } from '@ttt-productions/edge-protocol-core';\nimport type { HistoricalStats } from '../doc-schemas/user-profile.js';\nimport type { GameStatsCorrectionTarget } from '../schemas/stats.js';\nimport type { SportKey } from '../types/sports.js';\n\n// What a held operation is bound to: its kind, scope, and values, never its reason.\nexport type StatsOperationRequest =\n  | {\n      kind: 'gameStatsCorrection';\n      scope: { gameId: string };\n      targets?: readonly GameStatsCorrectionTarget[];\n      keepStored?: true;\n    }\n  | {\n      kind: 'historicalStatsUpdate';\n      scope: { userId: string; sportKey: SportKey };\n      stats: HistoricalStats;\n    };\n\n// The same targets sent in another order are the same request.\nexport function hashStatsOperationRequest(request: StatsOperationRequest): Promise<string> {\n  if (request.kind !== 'gameStatsCorrection' || request.targets === undefined) {\n    return hashPayload(request);\n  }\n  const targets = [...request.targets].sort((left, right) =>\n    canonicalize(left) < canonicalize(right) ? -1 : 1,\n  );\n  return hashPayload({ ...request, targets });\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/q-core",
-  "version": "0.1.29",
+  "version": "0.1.30",
   "description": "Core types, Firestore path constants, zod schemas, and shared constants for Q-Sports",
   "repository": {
     "type": "git",
@@ -77,6 +77,7 @@
     "test": "vitest run"
   },
   "dependencies": {
+    "@ttt-productions/edge-protocol-core": "^0.1.15",
     "@ttt-productions/input-format-core": "^0.1.4",
     "@ttt-productions/media-schemas": "^0.14.14",
     "@ttt-productions/notification-core": "^0.15.22",