@ttt-productions/q-core 0.1.28 → 0.1.29

package/dist/doc-schemas/game-stats.js

@@ -1,14 +1,3 @@
-// The game tier of the stats model: the stat event documents, and the rollup the game document
-// carries (RULE-QS-SPORT-901, RULE-QS-SPORT-911, RULE-QS-SPORT-912).
-//
-// Each stat event is its own document, `sportGames/{gameId}/gameStatEvents/{eventId}`, and the
-// event documents are the source of truth: at every commit the game's `stats` equals their replay,
-// in `sequence` order, from the sport's empty stats. The store is append-only — an undo appends a
-// `STAT_VOID` and a correction a `STAT_CORRECTION`; no event is ever edited.
-//
-// An event names people by id; names resolve from `publicUsers` at read time (RULE-STD-ARCH-103, RULE-QS-SPORT-914).
-// `displayNameSnapshot` and `assistedByDisplayNameSnapshot` are carried only by copied events, as
-// the audit record of the name the stat was entered under — never read as identity.
 import { z } from 'zod';
 import { CURLING_ROUND_COUNT, MAX_CURLING_ROUND_POINTS } from '../constants/sports.js';
 import { buildGameRosterPlayerId } from '../ids/compound-ids.js';
@@ -17,25 +6,14 @@ import { BASKETBALL_ASSISTABLE_SHOT_EVENT_TYPE_KEYS, BASKETBALL_BULK_EDIT_EVENT_
 import { STAT_CORRECTION_EVENT_TYPE, STAT_CORRECTION_SOURCE_KEYS, STAT_EVENT_AUTHORITY_KEYS, STAT_VOID_EVENT_TYPE, } from '../types/stats.js';
 import { CAPTAIN_TEAM_ROLES } from '../types/unions.js';
 import { basketballBulkStatKeySchema, countSchema, epochMsSchema, gameRosterPlayerIdSchema, repairReasonSchema, statCounterKeySchema, statEventIdSchema, statsOperationIdSchema, teamIdSchema, userIdSchema, } from './atoms.js';
-// ---------------------------------------------------------------------------------------------
-// Lines — one per team of the game, one per roster entry holding a non-zero player line
-// ---------------------------------------------------------------------------------------------
-// A line's counters: one field per key of the sport's declared stat-key set (RULE-QS-SPORT-907), so a key
-// added to the set is a field of every line built from it.
 function counterShape(keys) {
     return Object.fromEntries(keys.map((key) => [key, countSchema]));
 }
 export const BasketballTeamStatsSchema = z.strictObject(counterShape(BASKETBALL_TEAM_STAT_KEYS));
-// `fantasyPoints` is `basketballFantasyPoints` of the line's own counters, on every basketball
-// player line — this game line and the totals lines built from it — stored so every table and
-// aggregate reads it rather than deriving it. FP is linear in the counters, so a totals line's FP
-// equals the sum of its games' FP.
 export const BasketballPlayerStatsSchema = z.strictObject({
     ...counterShape(BASKETBALL_PLAYER_STAT_KEYS),
     fantasyPoints: z.number().nonnegative(),
 });
-// `roundScores[n]` is end n + 1: `null` until the end is recorded, `0` on both teams for a blank end.
-// `score` is the sum of the recorded ends.
 export const CurlingTeamStatsSchema = z.strictObject({
     ...counterShape(CURLING_TEAM_STAT_KEYS),
     roundScores: z
@@ -43,24 +21,12 @@ export const CurlingTeamStatsSchema = z.strictObject({
         .length(CURLING_ROUND_COUNT),
 });
 export const FootballTeamStatsSchema = z.strictObject(counterShape(FOOTBALL_TEAM_STAT_KEYS));
-// ---------------------------------------------------------------------------------------------
-// The payload — exactly two keys for every sport (RULE-QS-SPORT-901)
-// ---------------------------------------------------------------------------------------------
-// The one declaration of the game `stats` payload. Each sport's is built through it from that
-// sport's game lines in `SPORT_LINE_SCHEMAS`, as `SPORT_GAME_STATS_SCHEMAS`. `playerStats` is keyed
-// by roster entry, never by person, so a person on both teams of a game holds a line on each side. A
-// sport with no player lines passes `z.never()`, so its map stays empty.
 export function gameStatsSchema(teamLine, playerLine) {
     return z.strictObject({
         teamStats: z.record(teamIdSchema, teamLine),
         playerStats: z.record(gameRosterPlayerIdSchema, playerLine),
     });
 }
-// ---------------------------------------------------------------------------------------------
-// Events
-// ---------------------------------------------------------------------------------------------
-// Every event: its id, its place in the replay, and when it was entered. The recorder facts are
-// derived by the writing core, never taken from the payload (RULE-STD-ARCH-106); a copied event has none.
 const statEventBase = {
     eventId: statEventIdSchema,
     sequence: z.number().int().positive(),
@@ -68,22 +34,18 @@ const statEventBase = {
     acceptedAt: epochMsSchema.optional(),
     recordedByUserId: userIdSchema.optional(),
     recordedByAuthority: z.enum(STAT_EVENT_AUTHORITY_KEYS).optional(),
-    // Only for the two team roles: the team whose authority the event was recorded under.
     recordedByTeamId: teamIdSchema.optional(),
 };
-// A player-attributed event names the roster entry `{teamId}_{playerUserId}` whose line it changes.
 const playerEventFields = {
     teamId: teamIdSchema,
     playerUserId: userIdSchema,
     displayNameSnapshot: z.string().optional(),
 };
-// Basketball
 export const BasketballOnePointEventSchema = z.strictObject({
     ...statEventBase,
     ...playerEventFields,
     type: z.literal(BASKETBALL_ONE_POINT_EVENT_TYPE),
 });
-// An assisted shot names its assister on the same event, which credits both players.
 export const BasketballAssistableShotEventSchema = z
     .strictObject({
     ...statEventBase,
@@ -103,8 +65,6 @@ export const BasketballTimeoutEventSchema = z.strictObject({
     teamId: teamIdSchema,
     type: z.literal(BASKETBALL_TIMEOUT_EVENT_TYPE),
 });
-// A scorer's edit: `value` is the signed change to `stat`, entered against `previousValue`, the
-// value the form showed. A copied bulk edit has no `previousValue`; nothing validates one again.
 export const BasketballBulkEditEventSchema = z.strictObject({
     ...statEventBase,
     ...playerEventFields,
@@ -113,7 +73,6 @@ export const BasketballBulkEditEventSchema = z.strictObject({
     value: z.number().int(),
     previousValue: countSchema.optional(),
 });
-// Curling — an event names the end it records; it names no player.
 const curlingRoundNumberSchema = z.number().int().min(1).max(CURLING_ROUND_COUNT);
 export const CurlingRoundScoreEventSchema = z.strictObject({
     ...statEventBase,
@@ -127,7 +86,6 @@ export const CurlingBlankEndEventSchema = z.strictObject({
     type: z.literal(CURLING_ROUND_BLANK_EVENT_TYPE),
     roundNumber: curlingRoundNumberSchema,
 });
-// Football — team-attributed only.
 export const FootballScoreEventSchema = z.strictObject({
     ...statEventBase,
     type: z.enum(FOOTBALL_SCORE_EVENT_TYPE_KEYS),
@@ -140,9 +98,6 @@ export const FootballBulkEditEventSchema = z.strictObject({
     value: z.number().int(),
     previousValue: countSchema,
 });
-// The store-level events, members of every sport's union.
-// Undoes exactly the event it targets. Its id is derived from the target, so a target has at most
-// one void and a second undo of the same event is the same document.
 export const StatVoidEventSchema = z
     .strictObject({
     ...statEventBase,
@@ -153,9 +108,6 @@ export const StatVoidEventSchema = z
     message: 'A void is stored at the id its target derives.',
     path: ['eventId'],
 });
-// Adds `value` to one correctable field of one line — the player line `{teamId}_{playerUserId}`
-// when it names a player, the team line of `teamId` when it does not. It never cascades: a player
-// correction does not move the team's score.
 export const StatCorrectionEventSchema = z
     .strictObject({
     ...statEventBase,
@@ -167,8 +119,6 @@ export const StatCorrectionEventSchema = z
     correctionSource: z.enum(STAT_CORRECTION_SOURCE_KEYS),
     operationId: statsOperationIdSchema,
     reason: repairReasonSchema,
-    // The ghost a link re-keyed this correction's player line from. The id was derived from the
-    // ghost's line when the correction was written, and a document id never changes.
     rekeyedFromGhostUserId: userIdSchema.optional(),
 })
     .refine((event) => event.eventId ===
@@ -178,8 +128,6 @@ export const StatCorrectionEventSchema = z
     message: 'A correction is stored at the id its operation, line, and field derive.',
     path: ['eventId'],
 });
-// Recorder facts are all present or all absent, and a team is named exactly when the authority is a
-// team role.
 function recorderFactsAgree(event) {
     const facts = [event.acceptedAt, event.recordedByUserId, event.recordedByAuthority];
     const present = facts.filter((fact) => fact !== undefined).length;
@@ -188,9 +136,6 @@ function recorderFactsAgree(event) {
     const teamAuthority = CAPTAIN_TEAM_ROLES.includes(event.recordedByAuthority ?? '');
     return teamAuthority === (event.recordedByTeamId !== undefined);
 }
-// A name snapshot is the audit record a copied event keeps of the name its stat was entered under.
-// Only the writing core stamps recorder facts, and it writes ids only, so an event carrying both a
-// snapshot and a recorder fact is refused (RULE-STD-ARCH-103, RULE-QS-SPORT-914).
 function snapshotsOnlyOnCopiedEvents(event) {
     const snapshot = event.displayNameSnapshot !== undefined || event.assistedByDisplayNameSnapshot !== undefined;
     const recorded = [
@@ -201,7 +146,6 @@ function snapshotsOnlyOnCopiedEvents(event) {
     ].some((fact) => fact !== undefined);
     return !(snapshot && recorded);
 }
-// Event types are disjoint across sports, so `type` alone discriminates the whole union.
 export const GameStatEventSchema = z
     .discriminatedUnion('type', [
     BasketballOnePointEventSchema,

package/dist/doc-schemas/game-stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"game-stats.js","sourceRoot":"","sources":["../../src/doc-schemas/game-stats.ts"],"names":[],"mappings":"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","sourcesContent":["// The game tier of the stats model: the stat event documents, and the rollup the game document\n// carries (RULE-QS-SPORT-901, RULE-QS-SPORT-911, RULE-QS-SPORT-912).\n//\n// Each stat event is its own document, `sportGames/{gameId}/gameStatEvents/{eventId}`, and the\n// event documents are the source of truth: at every commit the game's `stats` equals their replay,\n// in `sequence` order, from the sport's empty stats. The store is append-only — an undo appends a\n// `STAT_VOID` and a correction a `STAT_CORRECTION`; no event is ever edited.\n//\n// An event names people by id; names resolve from `publicUsers` at read time (RULE-STD-ARCH-103, RULE-QS-SPORT-914).\n// `displayNameSnapshot` and `assistedByDisplayNameSnapshot` are carried only by copied events, as\n// the audit record of the name the stat was entered under — never read as identity.\n\nimport { z } from 'zod';\nimport { CURLING_ROUND_COUNT, MAX_CURLING_ROUND_POINTS } from '../constants/sports.js';\nimport { buildGameRosterPlayerId } from '../ids/compound-ids.js';\nimport { buildStatCorrectionId, buildStatVoidId } from '../ids/stat-event-ids.js';\nimport {\n  BASKETBALL_ASSISTABLE_SHOT_EVENT_TYPE_KEYS,\n  BASKETBALL_BULK_EDIT_EVENT_TYPE,\n  BASKETBALL_ONE_POINT_EVENT_TYPE,\n  BASKETBALL_PLAYER_STAT_KEYS,\n  BASKETBALL_PLAYER_TALLY_EVENT_TYPE_KEYS,\n  BASKETBALL_TEAM_STAT_KEYS,\n  BASKETBALL_TIMEOUT_EVENT_TYPE,\n  CURLING_ROUND_BLANK_EVENT_TYPE,\n  CURLING_ROUND_SCORE_EVENT_TYPE,\n  CURLING_TEAM_STAT_KEYS,\n  FOOTBALL_BULK_EDIT_EVENT_TYPE,\n  FOOTBALL_SCORE_EVENT_TYPE_KEYS,\n  FOOTBALL_TEAM_STAT_KEYS,\n} from '../types/sports.js';\nimport type {\n  BasketballStatEventType,\n  CurlingStatEventType,\n  FootballStatEventType,\n  StatCounterKey,\n} from '../types/sports.js';\nimport {\n  STAT_CORRECTION_EVENT_TYPE,\n  STAT_CORRECTION_SOURCE_KEYS,\n  STAT_EVENT_AUTHORITY_KEYS,\n  STAT_VOID_EVENT_TYPE,\n} from '../types/stats.js';\nimport { CAPTAIN_TEAM_ROLES } from '../types/unions.js';\nimport {\n  basketballBulkStatKeySchema,\n  countSchema,\n  epochMsSchema,\n  gameRosterPlayerIdSchema,\n  repairReasonSchema,\n  statCounterKeySchema,\n  statEventIdSchema,\n  statsOperationIdSchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\n\n// ---------------------------------------------------------------------------------------------\n// Lines — one per team of the game, one per roster entry holding a non-zero player line\n// ---------------------------------------------------------------------------------------------\n\n// A line's counters: one field per key of the sport's declared stat-key set (RULE-QS-SPORT-907), so a key\n// added to the set is a field of every line built from it.\nfunction counterShape<K extends StatCounterKey>(keys: readonly K[]): Record<K, typeof countSchema> {\n  return Object.fromEntries(keys.map((key) => [key, countSchema])) as Record<K, typeof countSchema>;\n}\n\nexport const BasketballTeamStatsSchema = z.strictObject(counterShape(BASKETBALL_TEAM_STAT_KEYS));\nexport type BasketballTeamStats = z.infer<typeof BasketballTeamStatsSchema>;\n\n// `fantasyPoints` is `basketballFantasyPoints` of the line's own counters, on every basketball\n// player line — this game line and the totals lines built from it — stored so every table and\n// aggregate reads it rather than deriving it. FP is linear in the counters, so a totals line's FP\n// equals the sum of its games' FP.\nexport const BasketballPlayerStatsSchema = z.strictObject({\n  ...counterShape(BASKETBALL_PLAYER_STAT_KEYS),\n  fantasyPoints: z.number().nonnegative(),\n});\nexport type BasketballPlayerStats = z.infer<typeof BasketballPlayerStatsSchema>;\n\n// `roundScores[n]` is end n + 1: `null` until the end is recorded, `0` on both teams for a blank end.\n// `score` is the sum of the recorded ends.\nexport const CurlingTeamStatsSchema = z.strictObject({\n  ...counterShape(CURLING_TEAM_STAT_KEYS),\n  roundScores: z\n    .array(z.number().int().min(0).max(MAX_CURLING_ROUND_POINTS).nullable())\n    .length(CURLING_ROUND_COUNT),\n});\nexport type CurlingTeamStats = z.infer<typeof CurlingTeamStatsSchema>;\n\nexport const FootballTeamStatsSchema = z.strictObject(counterShape(FOOTBALL_TEAM_STAT_KEYS));\nexport type FootballTeamStats = z.infer<typeof FootballTeamStatsSchema>;\n\n// ---------------------------------------------------------------------------------------------\n// The payload — exactly two keys for every sport (RULE-QS-SPORT-901)\n// ---------------------------------------------------------------------------------------------\n\n// The one declaration of the game `stats` payload. Each sport's is built through it from that\n// sport's game lines in `SPORT_LINE_SCHEMAS`, as `SPORT_GAME_STATS_SCHEMAS`. `playerStats` is keyed\n// by roster entry, never by person, so a person on both teams of a game holds a line on each side. A\n// sport with no player lines passes `z.never()`, so its map stays empty.\nexport function gameStatsSchema<TeamLine extends z.ZodType, PlayerLine extends z.ZodType>(\n  teamLine: TeamLine,\n  playerLine: PlayerLine,\n) {\n  return z.strictObject({\n    teamStats: z.record(teamIdSchema, teamLine),\n    playerStats: z.record(gameRosterPlayerIdSchema, playerLine),\n  });\n}\n\n// ---------------------------------------------------------------------------------------------\n// Events\n// ---------------------------------------------------------------------------------------------\n\n// Every event: its id, its place in the replay, and when it was entered. The recorder facts are\n// derived by the writing core, never taken from the payload (RULE-STD-ARCH-106); a copied event has none.\nconst statEventBase = {\n  eventId: statEventIdSchema,\n  sequence: z.number().int().positive(),\n  recordedAt: epochMsSchema,\n  acceptedAt: epochMsSchema.optional(),\n  recordedByUserId: userIdSchema.optional(),\n  recordedByAuthority: z.enum(STAT_EVENT_AUTHORITY_KEYS).optional(),\n  // Only for the two team roles: the team whose authority the event was recorded under.\n  recordedByTeamId: teamIdSchema.optional(),\n};\n\n// A player-attributed event names the roster entry `{teamId}_{playerUserId}` whose line it changes.\nconst playerEventFields = {\n  teamId: teamIdSchema,\n  playerUserId: userIdSchema,\n  displayNameSnapshot: z.string().optional(),\n};\n\n// Basketball\n\nexport const BasketballOnePointEventSchema = z.strictObject({\n  ...statEventBase,\n  ...playerEventFields,\n  type: z.literal(BASKETBALL_ONE_POINT_EVENT_TYPE),\n});\n\n// An assisted shot names its assister on the same event, which credits both players.\nexport const BasketballAssistableShotEventSchema = z\n  .strictObject({\n    ...statEventBase,\n    ...playerEventFields,\n    type: z.enum(BASKETBALL_ASSISTABLE_SHOT_EVENT_TYPE_KEYS),\n    assistedByUserId: userIdSchema.optional(),\n    assistedByDisplayNameSnapshot: z.string().optional(),\n  })\n  .refine(\n    (event) =>\n      event.assistedByDisplayNameSnapshot === undefined || event.assistedByUserId !== undefined,\n    'An assister snapshot needs the assister.',\n  );\n\nexport const BasketballPlayerTallyEventSchema = z.strictObject({\n  ...statEventBase,\n  ...playerEventFields,\n  type: z.enum(BASKETBALL_PLAYER_TALLY_EVENT_TYPE_KEYS),\n});\n\nexport const BasketballTimeoutEventSchema = z.strictObject({\n  ...statEventBase,\n  teamId: teamIdSchema,\n  type: z.literal(BASKETBALL_TIMEOUT_EVENT_TYPE),\n});\n\n// A scorer's edit: `value` is the signed change to `stat`, entered against `previousValue`, the\n// value the form showed. A copied bulk edit has no `previousValue`; nothing validates one again.\nexport const BasketballBulkEditEventSchema = z.strictObject({\n  ...statEventBase,\n  ...playerEventFields,\n  type: z.literal(BASKETBALL_BULK_EDIT_EVENT_TYPE),\n  stat: basketballBulkStatKeySchema,\n  value: z.number().int(),\n  previousValue: countSchema.optional(),\n});\n\n// Curling — an event names the end it records; it names no player.\n\nconst curlingRoundNumberSchema = z.number().int().min(1).max(CURLING_ROUND_COUNT);\n\nexport const CurlingRoundScoreEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.literal(CURLING_ROUND_SCORE_EVENT_TYPE),\n  teamId: teamIdSchema,\n  roundNumber: curlingRoundNumberSchema,\n  points: z.number().int().min(1).max(MAX_CURLING_ROUND_POINTS),\n});\n\nexport const CurlingBlankEndEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.literal(CURLING_ROUND_BLANK_EVENT_TYPE),\n  roundNumber: curlingRoundNumberSchema,\n});\n\n// Football — team-attributed only.\n\nexport const FootballScoreEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.enum(FOOTBALL_SCORE_EVENT_TYPE_KEYS),\n  teamId: teamIdSchema,\n});\n\nexport const FootballBulkEditEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.literal(FOOTBALL_BULK_EDIT_EVENT_TYPE),\n  teamId: teamIdSchema,\n  value: z.number().int(),\n  previousValue: countSchema,\n});\n\n// The store-level events, members of every sport's union.\n\n// Undoes exactly the event it targets. Its id is derived from the target, so a target has at most\n// one void and a second undo of the same event is the same document.\nexport const StatVoidEventSchema = z\n  .strictObject({\n    ...statEventBase,\n    type: z.literal(STAT_VOID_EVENT_TYPE),\n    targetEventId: statEventIdSchema,\n  })\n  .refine((event) => event.eventId === buildStatVoidId(event.targetEventId), {\n    message: 'A void is stored at the id its target derives.',\n    path: ['eventId'],\n  });\n\n// Adds `value` to one correctable field of one line — the player line `{teamId}_{playerUserId}`\n// when it names a player, the team line of `teamId` when it does not. It never cascades: a player\n// correction does not move the team's score.\nexport const StatCorrectionEventSchema = z\n  .strictObject({\n    ...statEventBase,\n    type: z.literal(STAT_CORRECTION_EVENT_TYPE),\n    teamId: teamIdSchema,\n    playerUserId: userIdSchema.optional(),\n    stat: statCounterKeySchema,\n    value: z.number().int(),\n    correctionSource: z.enum(STAT_CORRECTION_SOURCE_KEYS),\n    operationId: statsOperationIdSchema,\n    reason: repairReasonSchema,\n    // The ghost a link re-keyed this correction's player line from. The id was derived from the\n    // ghost's line when the correction was written, and a document id never changes.\n    rekeyedFromGhostUserId: userIdSchema.optional(),\n  })\n  .refine(\n    (event) =>\n      event.eventId ===\n      buildStatCorrectionId(\n        event.operationId,\n        event.playerUserId === undefined\n          ? event.teamId\n          : buildGameRosterPlayerId(\n              event.teamId,\n              event.rekeyedFromGhostUserId ?? event.playerUserId,\n            ),\n        event.stat,\n      ),\n    {\n      message: 'A correction is stored at the id its operation, line, and field derive.',\n      path: ['eventId'],\n    },\n  );\n\n// Recorder facts are all present or all absent, and a team is named exactly when the authority is a\n// team role.\nfunction recorderFactsAgree(event: {\n  acceptedAt?: number;\n  recordedByUserId?: string;\n  recordedByAuthority?: (typeof STAT_EVENT_AUTHORITY_KEYS)[number];\n  recordedByTeamId?: string;\n}): boolean {\n  const facts = [event.acceptedAt, event.recordedByUserId, event.recordedByAuthority];\n  const present = facts.filter((fact) => fact !== undefined).length;\n  if (present !== 0 && present !== facts.length) return false;\n  const teamAuthority = (CAPTAIN_TEAM_ROLES as readonly string[]).includes(\n    event.recordedByAuthority ?? '',\n  );\n  return teamAuthority === (event.recordedByTeamId !== undefined);\n}\n\n// A name snapshot is the audit record a copied event keeps of the name its stat was entered under.\n// Only the writing core stamps recorder facts, and it writes ids only, so an event carrying both a\n// snapshot and a recorder fact is refused (RULE-STD-ARCH-103, RULE-QS-SPORT-914).\nfunction snapshotsOnlyOnCopiedEvents(event: {\n  acceptedAt?: number;\n  recordedByUserId?: string;\n  recordedByAuthority?: string;\n  recordedByTeamId?: string;\n  displayNameSnapshot?: string;\n  assistedByDisplayNameSnapshot?: string;\n}): boolean {\n  const snapshot =\n    event.displayNameSnapshot !== undefined || event.assistedByDisplayNameSnapshot !== undefined;\n  const recorded = [\n    event.acceptedAt,\n    event.recordedByUserId,\n    event.recordedByAuthority,\n    event.recordedByTeamId,\n  ].some((fact) => fact !== undefined);\n  return !(snapshot && recorded);\n}\n\n// Event types are disjoint across sports, so `type` alone discriminates the whole union.\nexport const GameStatEventSchema = z\n  .discriminatedUnion('type', [\n    BasketballOnePointEventSchema,\n    BasketballAssistableShotEventSchema,\n    BasketballPlayerTallyEventSchema,\n    BasketballTimeoutEventSchema,\n    BasketballBulkEditEventSchema,\n    CurlingRoundScoreEventSchema,\n    CurlingBlankEndEventSchema,\n    FootballScoreEventSchema,\n    FootballBulkEditEventSchema,\n    StatVoidEventSchema,\n    StatCorrectionEventSchema,\n  ])\n  .refine(\n    recorderFactsAgree,\n    'Recorder facts are all present, or all absent, with a team only for a team role.',\n  )\n  .refine(\n    snapshotsOnlyOnCopiedEvents,\n    'A name snapshot belongs to a copied event, which carries no recorder facts.',\n  );\nexport type GameStatEvent = z.infer<typeof GameStatEventSchema>;\nexport type GameStatEventType = GameStatEvent['type'];\n\nexport type BasketballStatEvent = Extract<GameStatEvent, { type: BasketballStatEventType }>;\nexport type CurlingRoundScoreEvent = z.infer<typeof CurlingRoundScoreEventSchema>;\nexport type CurlingBlankEndEvent = z.infer<typeof CurlingBlankEndEventSchema>;\nexport type CurlingStatEvent = Extract<GameStatEvent, { type: CurlingStatEventType }>;\nexport type FootballStatEvent = Extract<GameStatEvent, { type: FootballStatEventType }>;\nexport type StatVoidEvent = z.infer<typeof StatVoidEventSchema>;\nexport type StatCorrectionEvent = z.infer<typeof StatCorrectionEventSchema>;\n"]}
+{"version":3,"file":"game-stats.js","sourceRoot":"","sources":["../../src/doc-schemas/game-stats.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { CURLING_ROUND_COUNT, MAX_CURLING_ROUND_POINTS } from '../constants/sports.js';\nimport { buildGameRosterPlayerId } from '../ids/compound-ids.js';\nimport { buildStatCorrectionId, buildStatVoidId } from '../ids/stat-event-ids.js';\nimport {\n  BASKETBALL_ASSISTABLE_SHOT_EVENT_TYPE_KEYS,\n  BASKETBALL_BULK_EDIT_EVENT_TYPE,\n  BASKETBALL_ONE_POINT_EVENT_TYPE,\n  BASKETBALL_PLAYER_STAT_KEYS,\n  BASKETBALL_PLAYER_TALLY_EVENT_TYPE_KEYS,\n  BASKETBALL_TEAM_STAT_KEYS,\n  BASKETBALL_TIMEOUT_EVENT_TYPE,\n  CURLING_ROUND_BLANK_EVENT_TYPE,\n  CURLING_ROUND_SCORE_EVENT_TYPE,\n  CURLING_TEAM_STAT_KEYS,\n  FOOTBALL_BULK_EDIT_EVENT_TYPE,\n  FOOTBALL_SCORE_EVENT_TYPE_KEYS,\n  FOOTBALL_TEAM_STAT_KEYS,\n} from '../types/sports.js';\nimport type {\n  BasketballStatEventType,\n  CurlingStatEventType,\n  FootballStatEventType,\n  StatCounterKey,\n} from '../types/sports.js';\nimport {\n  STAT_CORRECTION_EVENT_TYPE,\n  STAT_CORRECTION_SOURCE_KEYS,\n  STAT_EVENT_AUTHORITY_KEYS,\n  STAT_VOID_EVENT_TYPE,\n} from '../types/stats.js';\nimport { CAPTAIN_TEAM_ROLES } from '../types/unions.js';\nimport {\n  basketballBulkStatKeySchema,\n  countSchema,\n  epochMsSchema,\n  gameRosterPlayerIdSchema,\n  repairReasonSchema,\n  statCounterKeySchema,\n  statEventIdSchema,\n  statsOperationIdSchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\n\nfunction counterShape<K extends StatCounterKey>(keys: readonly K[]): Record<K, typeof countSchema> {\n  return Object.fromEntries(keys.map((key) => [key, countSchema])) as Record<K, typeof countSchema>;\n}\n\nexport const BasketballTeamStatsSchema = z.strictObject(counterShape(BASKETBALL_TEAM_STAT_KEYS));\nexport type BasketballTeamStats = z.infer<typeof BasketballTeamStatsSchema>;\n\nexport const BasketballPlayerStatsSchema = z.strictObject({\n  ...counterShape(BASKETBALL_PLAYER_STAT_KEYS),\n  fantasyPoints: z.number().nonnegative(),\n});\nexport type BasketballPlayerStats = z.infer<typeof BasketballPlayerStatsSchema>;\n\nexport const CurlingTeamStatsSchema = z.strictObject({\n  ...counterShape(CURLING_TEAM_STAT_KEYS),\n  roundScores: z\n    .array(z.number().int().min(0).max(MAX_CURLING_ROUND_POINTS).nullable())\n    .length(CURLING_ROUND_COUNT),\n});\nexport type CurlingTeamStats = z.infer<typeof CurlingTeamStatsSchema>;\n\nexport const FootballTeamStatsSchema = z.strictObject(counterShape(FOOTBALL_TEAM_STAT_KEYS));\nexport type FootballTeamStats = z.infer<typeof FootballTeamStatsSchema>;\n\nexport function gameStatsSchema<TeamLine extends z.ZodType, PlayerLine extends z.ZodType>(\n  teamLine: TeamLine,\n  playerLine: PlayerLine,\n) {\n  return z.strictObject({\n    teamStats: z.record(teamIdSchema, teamLine),\n    playerStats: z.record(gameRosterPlayerIdSchema, playerLine),\n  });\n}\n\nconst statEventBase = {\n  eventId: statEventIdSchema,\n  sequence: z.number().int().positive(),\n  recordedAt: epochMsSchema,\n  acceptedAt: epochMsSchema.optional(),\n  recordedByUserId: userIdSchema.optional(),\n  recordedByAuthority: z.enum(STAT_EVENT_AUTHORITY_KEYS).optional(),\n  recordedByTeamId: teamIdSchema.optional(),\n};\n\nconst playerEventFields = {\n  teamId: teamIdSchema,\n  playerUserId: userIdSchema,\n  displayNameSnapshot: z.string().optional(),\n};\n\nexport const BasketballOnePointEventSchema = z.strictObject({\n  ...statEventBase,\n  ...playerEventFields,\n  type: z.literal(BASKETBALL_ONE_POINT_EVENT_TYPE),\n});\n\nexport const BasketballAssistableShotEventSchema = z\n  .strictObject({\n    ...statEventBase,\n    ...playerEventFields,\n    type: z.enum(BASKETBALL_ASSISTABLE_SHOT_EVENT_TYPE_KEYS),\n    assistedByUserId: userIdSchema.optional(),\n    assistedByDisplayNameSnapshot: z.string().optional(),\n  })\n  .refine(\n    (event) =>\n      event.assistedByDisplayNameSnapshot === undefined || event.assistedByUserId !== undefined,\n    'An assister snapshot needs the assister.',\n  );\n\nexport const BasketballPlayerTallyEventSchema = z.strictObject({\n  ...statEventBase,\n  ...playerEventFields,\n  type: z.enum(BASKETBALL_PLAYER_TALLY_EVENT_TYPE_KEYS),\n});\n\nexport const BasketballTimeoutEventSchema = z.strictObject({\n  ...statEventBase,\n  teamId: teamIdSchema,\n  type: z.literal(BASKETBALL_TIMEOUT_EVENT_TYPE),\n});\n\nexport const BasketballBulkEditEventSchema = z.strictObject({\n  ...statEventBase,\n  ...playerEventFields,\n  type: z.literal(BASKETBALL_BULK_EDIT_EVENT_TYPE),\n  stat: basketballBulkStatKeySchema,\n  value: z.number().int(),\n  previousValue: countSchema.optional(),\n});\n\nconst curlingRoundNumberSchema = z.number().int().min(1).max(CURLING_ROUND_COUNT);\n\nexport const CurlingRoundScoreEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.literal(CURLING_ROUND_SCORE_EVENT_TYPE),\n  teamId: teamIdSchema,\n  roundNumber: curlingRoundNumberSchema,\n  points: z.number().int().min(1).max(MAX_CURLING_ROUND_POINTS),\n});\n\nexport const CurlingBlankEndEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.literal(CURLING_ROUND_BLANK_EVENT_TYPE),\n  roundNumber: curlingRoundNumberSchema,\n});\n\nexport const FootballScoreEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.enum(FOOTBALL_SCORE_EVENT_TYPE_KEYS),\n  teamId: teamIdSchema,\n});\n\nexport const FootballBulkEditEventSchema = z.strictObject({\n  ...statEventBase,\n  type: z.literal(FOOTBALL_BULK_EDIT_EVENT_TYPE),\n  teamId: teamIdSchema,\n  value: z.number().int(),\n  previousValue: countSchema,\n});\n\nexport const StatVoidEventSchema = z\n  .strictObject({\n    ...statEventBase,\n    type: z.literal(STAT_VOID_EVENT_TYPE),\n    targetEventId: statEventIdSchema,\n  })\n  .refine((event) => event.eventId === buildStatVoidId(event.targetEventId), {\n    message: 'A void is stored at the id its target derives.',\n    path: ['eventId'],\n  });\n\nexport const StatCorrectionEventSchema = z\n  .strictObject({\n    ...statEventBase,\n    type: z.literal(STAT_CORRECTION_EVENT_TYPE),\n    teamId: teamIdSchema,\n    playerUserId: userIdSchema.optional(),\n    stat: statCounterKeySchema,\n    value: z.number().int(),\n    correctionSource: z.enum(STAT_CORRECTION_SOURCE_KEYS),\n    operationId: statsOperationIdSchema,\n    reason: repairReasonSchema,\n    rekeyedFromGhostUserId: userIdSchema.optional(),\n  })\n  .refine(\n    (event) =>\n      event.eventId ===\n      buildStatCorrectionId(\n        event.operationId,\n        event.playerUserId === undefined\n          ? event.teamId\n          : buildGameRosterPlayerId(\n              event.teamId,\n              event.rekeyedFromGhostUserId ?? event.playerUserId,\n            ),\n        event.stat,\n      ),\n    {\n      message: 'A correction is stored at the id its operation, line, and field derive.',\n      path: ['eventId'],\n    },\n  );\n\nfunction recorderFactsAgree(event: {\n  acceptedAt?: number;\n  recordedByUserId?: string;\n  recordedByAuthority?: (typeof STAT_EVENT_AUTHORITY_KEYS)[number];\n  recordedByTeamId?: string;\n}): boolean {\n  const facts = [event.acceptedAt, event.recordedByUserId, event.recordedByAuthority];\n  const present = facts.filter((fact) => fact !== undefined).length;\n  if (present !== 0 && present !== facts.length) return false;\n  const teamAuthority = (CAPTAIN_TEAM_ROLES as readonly string[]).includes(\n    event.recordedByAuthority ?? '',\n  );\n  return teamAuthority === (event.recordedByTeamId !== undefined);\n}\n\nfunction snapshotsOnlyOnCopiedEvents(event: {\n  acceptedAt?: number;\n  recordedByUserId?: string;\n  recordedByAuthority?: string;\n  recordedByTeamId?: string;\n  displayNameSnapshot?: string;\n  assistedByDisplayNameSnapshot?: string;\n}): boolean {\n  const snapshot =\n    event.displayNameSnapshot !== undefined || event.assistedByDisplayNameSnapshot !== undefined;\n  const recorded = [\n    event.acceptedAt,\n    event.recordedByUserId,\n    event.recordedByAuthority,\n    event.recordedByTeamId,\n  ].some((fact) => fact !== undefined);\n  return !(snapshot && recorded);\n}\n\nexport const GameStatEventSchema = z\n  .discriminatedUnion('type', [\n    BasketballOnePointEventSchema,\n    BasketballAssistableShotEventSchema,\n    BasketballPlayerTallyEventSchema,\n    BasketballTimeoutEventSchema,\n    BasketballBulkEditEventSchema,\n    CurlingRoundScoreEventSchema,\n    CurlingBlankEndEventSchema,\n    FootballScoreEventSchema,\n    FootballBulkEditEventSchema,\n    StatVoidEventSchema,\n    StatCorrectionEventSchema,\n  ])\n  .refine(\n    recorderFactsAgree,\n    'Recorder facts are all present, or all absent, with a team only for a team role.',\n  )\n  .refine(\n    snapshotsOnlyOnCopiedEvents,\n    'A name snapshot belongs to a copied event, which carries no recorder facts.',\n  );\nexport type GameStatEvent = z.infer<typeof GameStatEventSchema>;\nexport type GameStatEventType = GameStatEvent['type'];\n\nexport type BasketballStatEvent = Extract<GameStatEvent, { type: BasketballStatEventType }>;\nexport type CurlingRoundScoreEvent = z.infer<typeof CurlingRoundScoreEventSchema>;\nexport type CurlingBlankEndEvent = z.infer<typeof CurlingBlankEndEventSchema>;\nexport type CurlingStatEvent = Extract<GameStatEvent, { type: CurlingStatEventType }>;\nexport type FootballStatEvent = Extract<GameStatEvent, { type: FootballStatEventType }>;\nexport type StatVoidEvent = z.infer<typeof StatVoidEventSchema>;\nexport type StatCorrectionEvent = z.infer<typeof StatCorrectionEventSchema>;\n"]}

package/dist/doc-schemas/league-team.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"league-team.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/league-team.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqC3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAK1D,eAAO,MAAM,uBAAuB;;;;iBAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}
+{"version":3,"file":"league-team.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/league-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoB3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/doc-schemas/league-team.js

@@ -1,5 +1,3 @@
-// `leagueTeams/{teamId}` — one team in one league, with its derived season rollups. Who is on the
-// team, and who captains it, is `teamMemberships` — never a field here.
 import { z } from 'zod';
 import { CONTACT_PHONE_INPUT_FORMAT } from '../input-formats/input-formats.js';
 import { countSchema, epochMsSchema, leagueIdSchema, teamIconSchema, teamTypeSchema, textFieldSchema, userIdSchema, } from './atoms.js';
@@ -9,46 +7,25 @@ export const LeagueTeamSchema = z.object({
     name: z.string(),
     icon: teamIconSchema,
     leagueId: leagueIdSchema,
-    // Present only in a Competitive/Recreational league.
     teamType: teamTypeSchema.optional(),
-    // The account that created the team — the new captain, or the admin who created it for a ghost
-    // captain. A creation record, never a membership or an authority.
     createdByUserId: userIdSchema,
-    // The team's standings line, absent until its first game is finalized.
     seasonStats: TeamSeasonStatsSchema.optional(),
-    // The league player stats: one row per person the team's games credited, keyed by userId (real or
-    // ghost). The team's league, the team, and the key are the membership the row belongs to.
     playerSeasonStats: z.record(userIdSchema, PlayerSeasonStatsSchema).optional(),
-    // The team's picture gallery summary — absent is an empty gallery. Only the picture core writes
-    // it; the team callables and the copy action never do.
     pictures: GallerySummarySchema.optional(),
-    // Advanced by every membership change on the team after its creation; absent until the first.
-    // Only its changing matters: game creation and a game's team replacement read this document in the
-    // transaction that seeds a roster from the team's memberships, so a membership change landing at
-    // the same moment conflicts with them instead of missing the new game (RULE-STD-BACKEND-116).
+    // Only its changing matters: the write fence between membership changes and roster seeding
+    // (RULE-STD-BACKEND-116).
     membershipRevision: countSchema.optional(),
-    // Advanced by every invitation and join request a door creates for the team; absent until the
-    // first. Only its changing matters: a pending invitation or request between one team and one
-    // person is unique, and a membership on the team closes both, but a transaction does not lock a
-    // query against an insert — so each creation writes this document, which every competing
-    // creation and every membership door also writes, and two racers conflict instead of both passing
-    // their checks (RULE-STD-BACKEND-116).
+    // Only its changing matters: the write fence between competing invitations, join requests, and
+    // membership doors (RULE-STD-BACKEND-116).
     joinRevision: countSchema.optional(),
-    // Advanced by every game creation and every game edit that brings the team in; absent until the
-    // first. Only its changing matters: a team's deletion re-reads the team's games in the transaction
-    // that deletes the team document, and a query does not lock against an insert — so a game created
-    // for the team writes this document, which the deletion also writes, and the two conflict instead of
-    // leaving a game naming a deleted team (RULE-STD-BACKEND-116).
+    // Only its changing matters: the write fence between game creation and the team's deletion
+    // (RULE-STD-BACKEND-116).
     scheduleRevision: countSchema.optional(),
     createdAt: epochMsSchema,
     updatedAt: epochMsSchema,
 });
-// `leagueTeamContacts/{teamId}` — how the league reaches the team. Admin read only: the team
-// document is public, so the phone lives here, never on it (RULE-STD-BACKEND-105). `leagueId` is what lists a
-// league's contacts in one query. Written with the team by team creation.
 export const LeagueTeamContactSchema = z.object({
     leagueId: leagueIdSchema,
-    // The number as the contact callables kept it, held to the same declaration they parse with.
     contactPhone: textFieldSchema(CONTACT_PHONE_INPUT_FORMAT),
     updatedAt: epochMsSchema,
 });

package/dist/doc-schemas/league-team.js.map

@@ -1 +1 @@
-{"version":3,"file":"league-team.js","sourceRoot":"","sources":["../../src/doc-schemas/league-team.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,wEAAwE;AAExE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,cAAc;IACxB,qDAAqD;IACrD,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,+FAA+F;IAC/F,kEAAkE;IAClE,eAAe,EAAE,YAAY;IAC7B,uEAAuE;IACvE,WAAW,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IAC7C,kGAAkG;IAClG,0FAA0F;IAC1F,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC,QAAQ,EAAE;IAC7E,gGAAgG;IAChG,uDAAuD;IACvD,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACzC,8FAA8F;IAC9F,mGAAmG;IACnG,iGAAiG;IACjG,8FAA8F;IAC9F,kBAAkB,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC1C,8FAA8F;IAC9F,6FAA6F;IAC7F,gGAAgG;IAChG,yFAAyF;IACzF,kGAAkG;IAClG,uCAAuC;IACvC,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE;IACpC,gGAAgG;IAChG,mGAAmG;IACnG,kGAAkG;IAClG,qGAAqG;IACrG,+DAA+D;IAC/D,gBAAgB,EAAE,WAAW,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,6FAA6F;AAC7F,8GAA8G;AAC9G,0EAA0E;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,cAAc;IACxB,6FAA6F;IAC7F,YAAY,EAAE,eAAe,CAAC,0BAA0B,CAAC;IACzD,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC","sourcesContent":["// `leagueTeams/{teamId}` — one team in one league, with its derived season rollups. Who is on the\n// team, and who captains it, is `teamMemberships` — never a field here.\n\nimport { z } from 'zod';\nimport { CONTACT_PHONE_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport {\n  countSchema,\n  epochMsSchema,\n  leagueIdSchema,\n  teamIconSchema,\n  teamTypeSchema,\n  textFieldSchema,\n  userIdSchema,\n} from './atoms.js';\nimport { PlayerSeasonStatsSchema, TeamSeasonStatsSchema } from './aggregate-stats.js';\nimport { GallerySummarySchema } from './gallery.js';\n\nexport const LeagueTeamSchema = z.object({\n  name: z.string(),\n  icon: teamIconSchema,\n  leagueId: leagueIdSchema,\n  // Present only in a Competitive/Recreational league.\n  teamType: teamTypeSchema.optional(),\n  // The account that created the team — the new captain, or the admin who created it for a ghost\n  // captain. A creation record, never a membership or an authority.\n  createdByUserId: userIdSchema,\n  // The team's standings line, absent until its first game is finalized.\n  seasonStats: TeamSeasonStatsSchema.optional(),\n  // The league player stats: one row per person the team's games credited, keyed by userId (real or\n  // ghost). The team's league, the team, and the key are the membership the row belongs to.\n  playerSeasonStats: z.record(userIdSchema, PlayerSeasonStatsSchema).optional(),\n  // The team's picture gallery summary — absent is an empty gallery. Only the picture core writes\n  // it; the team callables and the copy action never do.\n  pictures: GallerySummarySchema.optional(),\n  // Advanced by every membership change on the team after its creation; absent until the first.\n  // Only its changing matters: game creation and a game's team replacement read this document in the\n  // transaction that seeds a roster from the team's memberships, so a membership change landing at\n  // the same moment conflicts with them instead of missing the new game (RULE-STD-BACKEND-116).\n  membershipRevision: countSchema.optional(),\n  // Advanced by every invitation and join request a door creates for the team; absent until the\n  // first. Only its changing matters: a pending invitation or request between one team and one\n  // person is unique, and a membership on the team closes both, but a transaction does not lock a\n  // query against an insert — so each creation writes this document, which every competing\n  // creation and every membership door also writes, and two racers conflict instead of both passing\n  // their checks (RULE-STD-BACKEND-116).\n  joinRevision: countSchema.optional(),\n  // Advanced by every game creation and every game edit that brings the team in; absent until the\n  // first. Only its changing matters: a team's deletion re-reads the team's games in the transaction\n  // that deletes the team document, and a query does not lock against an insert — so a game created\n  // for the team writes this document, which the deletion also writes, and the two conflict instead of\n  // leaving a game naming a deleted team (RULE-STD-BACKEND-116).\n  scheduleRevision: countSchema.optional(),\n  createdAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type LeagueTeam = z.infer<typeof LeagueTeamSchema>;\n\n// `leagueTeamContacts/{teamId}` — how the league reaches the team. Admin read only: the team\n// document is public, so the phone lives here, never on it (RULE-STD-BACKEND-105). `leagueId` is what lists a\n// league's contacts in one query. Written with the team by team creation.\nexport const LeagueTeamContactSchema = z.object({\n  leagueId: leagueIdSchema,\n  // The number as the contact callables kept it, held to the same declaration they parse with.\n  contactPhone: textFieldSchema(CONTACT_PHONE_INPUT_FORMAT),\n  updatedAt: epochMsSchema,\n});\nexport type LeagueTeamContact = z.infer<typeof LeagueTeamContactSchema>;\n"]}
+{"version":3,"file":"league-team.js","sourceRoot":"","sources":["../../src/doc-schemas/league-team.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACtF,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,cAAc;IACxB,QAAQ,EAAE,cAAc,CAAC,QAAQ,EAAE;IACnC,eAAe,EAAE,YAAY;IAC7B,WAAW,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IAC7C,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC,QAAQ,EAAE;IAC7E,QAAQ,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACzC,2FAA2F;IAC3F,0BAA0B;IAC1B,kBAAkB,EAAE,WAAW,CAAC,QAAQ,EAAE;IAC1C,+FAA+F;IAC/F,2CAA2C;IAC3C,YAAY,EAAE,WAAW,CAAC,QAAQ,EAAE;IACpC,2FAA2F;IAC3F,0BAA0B;IAC1B,gBAAgB,EAAE,WAAW,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,QAAQ,EAAE,cAAc;IACxB,YAAY,EAAE,eAAe,CAAC,0BAA0B,CAAC;IACzD,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { CONTACT_PHONE_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport {\n  countSchema,\n  epochMsSchema,\n  leagueIdSchema,\n  teamIconSchema,\n  teamTypeSchema,\n  textFieldSchema,\n  userIdSchema,\n} from './atoms.js';\nimport { PlayerSeasonStatsSchema, TeamSeasonStatsSchema } from './aggregate-stats.js';\nimport { GallerySummarySchema } from './gallery.js';\n\nexport const LeagueTeamSchema = z.object({\n  name: z.string(),\n  icon: teamIconSchema,\n  leagueId: leagueIdSchema,\n  teamType: teamTypeSchema.optional(),\n  createdByUserId: userIdSchema,\n  seasonStats: TeamSeasonStatsSchema.optional(),\n  playerSeasonStats: z.record(userIdSchema, PlayerSeasonStatsSchema).optional(),\n  pictures: GallerySummarySchema.optional(),\n  // Only its changing matters: the write fence between membership changes and roster seeding\n  // (RULE-STD-BACKEND-116).\n  membershipRevision: countSchema.optional(),\n  // Only its changing matters: the write fence between competing invitations, join requests, and\n  // membership doors (RULE-STD-BACKEND-116).\n  joinRevision: countSchema.optional(),\n  // Only its changing matters: the write fence between game creation and the team's deletion\n  // (RULE-STD-BACKEND-116).\n  scheduleRevision: countSchema.optional(),\n  createdAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type LeagueTeam = z.infer<typeof LeagueTeamSchema>;\n\nexport const LeagueTeamContactSchema = z.object({\n  leagueId: leagueIdSchema,\n  contactPhone: textFieldSchema(CONTACT_PHONE_INPUT_FORMAT),\n  updatedAt: epochMsSchema,\n});\nexport type LeagueTeamContact = z.infer<typeof LeagueTeamContactSchema>;\n"]}

package/dist/doc-schemas/membership-roster-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"membership-roster-sync.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/membership-roster-sync.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,gCAAgC;;;kBAG3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;iBAyCpC,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"membership-roster-sync.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/membership-roster-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,gCAAgC;;;kBAG3C,CAAC;AACH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;iBAkCpC,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

package/dist/doc-schemas/membership-roster-sync.js

@@ -1,17 +1,7 @@
-// `membershipRosterSyncs/{teamMembershipId}` — one team membership's durable obligation to bring
-// its team's open game rosters in line with it (RULE-STD-QUALITY-104, RULE-STD-BACKEND-302).
-//
-// Every change to a membership — made, removed, or linked — advances `rosterRevision` in the same
-// transaction as the change, so a committed membership can never lose its roster work. The roster
-// core raises `reconciledRosterRevision` to the revision it finished; the obligation is outstanding
-// while it is lower. The document outlives a deleted membership, so a removal is still reconciled,
-// and it is keyed by the membership id, so no second id format exists (RULE-STD-ARCH-109). Backend-only.
 import { z } from 'zod';
 import { MAX_ROSTER_SYNC_FAILURE_MESSAGE_LENGTH } from '../constants/business.js';
 import { FAILED_ROSTER_SYNC_STATUS, RECONCILED_ROSTER_SYNC_STATUS } from '../types/unions.js';
 import { appliedRevisionSchema, countSchema, epochMsSchema, gameIdSchema, leagueIdSchema, membershipRosterSyncStatusSchema, revisionSchema, teamIdSchema, userIdSchema, } from './atoms.js';
-// Where a run that stopped part-way resumes: the last game it finished for this revision. A cursor
-// for an older revision is ignored, because a newer change re-reconciles every open game.
 export const MembershipRosterSyncCursorSchema = z.strictObject({
     rosterRevision: revisionSchema,
     afterGameId: gameIdSchema,
@@ -21,20 +11,13 @@ export const MembershipRosterSyncSchema = z
     leagueId: leagueIdSchema,
     teamId: teamIdSchema,
     userId: userIdSchema,
-    // Advanced by every change to the membership; the first change writes 1.
     rosterRevision: revisionSchema,
-    // The revision the roster core last finished; 0 before the first finish.
     reconciledRosterRevision: appliedRevisionSchema,
     syncStatus: membershipRosterSyncStatusSchema,
-    // Runs of the worker at the current revision that ended in a failure.
     attemptCount: countSchema,
-    // The earliest moment the worker takes the obligation again.
     nextAttemptAt: epochMsSchema,
     cursor: MembershipRosterSyncCursorSchema.optional(),
-    // When its retries ran out: present exactly while the obligation is failed.
     failedAt: epochMsSchema.optional(),
-    // The last failed run's message, kept while it retries and while it is failed; a finished run or
-    // an admin's retry clears it.
     lastFailureMessage: z.string().max(MAX_ROSTER_SYNC_FAILURE_MESSAGE_LENGTH).optional(),
     updatedAt: epochMsSchema,
 })

package/dist/doc-schemas/membership-roster-sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"membership-roster-sync.js","sourceRoot":"","sources":["../../src/doc-schemas/membership-roster-sync.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,6FAA6F;AAC7F,EAAE;AACF,kGAAkG;AAClG,kGAAkG;AAClG,oGAAoG;AACpG,mGAAmG;AACnG,yGAAyG;AAEzG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gCAAgC,EAChC,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,mGAAmG;AACnG,0FAA0F;AAC1F,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,YAAY,CAAC;IAC7D,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,YAAY;CAC1B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,yEAAyE;IACzE,cAAc,EAAE,cAAc;IAC9B,yEAAyE;IACzE,wBAAwB,EAAE,qBAAqB;IAC/C,UAAU,EAAE,gCAAgC;IAC5C,sEAAsE;IACtE,YAAY,EAAE,WAAW;IACzB,6DAA6D;IAC7D,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IACnD,4EAA4E;IAC5E,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;IAClC,iGAAiG;IACjG,8BAA8B;IAC9B,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC,QAAQ,EAAE;IACrF,SAAS,EAAE,aAAa;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,cAAc,EAAE;IACtE,OAAO,EAAE,iEAAiE;IAC1E,IAAI,EAAE,CAAC,0BAA0B,CAAC;CACnC,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,UAAU,KAAK,6BAA6B,CAAC;IACnD,CAAC,IAAI,CAAC,wBAAwB,KAAK,IAAI,CAAC,cAAc,CAAC,EACzD;IACE,OAAO,EAAE,mFAAmF;IAC5F,IAAI,EAAE,CAAC,YAAY,CAAC;CACrB,CACF;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,EAC3F;IACE,OAAO,EAAE,8DAA8D;IACvE,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CACF,CAAC","sourcesContent":["// `membershipRosterSyncs/{teamMembershipId}` — one team membership's durable obligation to bring\n// its team's open game rosters in line with it (RULE-STD-QUALITY-104, RULE-STD-BACKEND-302).\n//\n// Every change to a membership — made, removed, or linked — advances `rosterRevision` in the same\n// transaction as the change, so a committed membership can never lose its roster work. The roster\n// core raises `reconciledRosterRevision` to the revision it finished; the obligation is outstanding\n// while it is lower. The document outlives a deleted membership, so a removal is still reconciled,\n// and it is keyed by the membership id, so no second id format exists (RULE-STD-ARCH-109). Backend-only.\n\nimport { z } from 'zod';\nimport { MAX_ROSTER_SYNC_FAILURE_MESSAGE_LENGTH } from '../constants/business.js';\nimport { FAILED_ROSTER_SYNC_STATUS, RECONCILED_ROSTER_SYNC_STATUS } from '../types/unions.js';\nimport {\n  appliedRevisionSchema,\n  countSchema,\n  epochMsSchema,\n  gameIdSchema,\n  leagueIdSchema,\n  membershipRosterSyncStatusSchema,\n  revisionSchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\n\n// Where a run that stopped part-way resumes: the last game it finished for this revision. A cursor\n// for an older revision is ignored, because a newer change re-reconciles every open game.\nexport const MembershipRosterSyncCursorSchema = z.strictObject({\n  rosterRevision: revisionSchema,\n  afterGameId: gameIdSchema,\n});\nexport type MembershipRosterSyncCursor = z.infer<typeof MembershipRosterSyncCursorSchema>;\n\nexport const MembershipRosterSyncSchema = z\n  .object({\n    leagueId: leagueIdSchema,\n    teamId: teamIdSchema,\n    userId: userIdSchema,\n    // Advanced by every change to the membership; the first change writes 1.\n    rosterRevision: revisionSchema,\n    // The revision the roster core last finished; 0 before the first finish.\n    reconciledRosterRevision: appliedRevisionSchema,\n    syncStatus: membershipRosterSyncStatusSchema,\n    // Runs of the worker at the current revision that ended in a failure.\n    attemptCount: countSchema,\n    // The earliest moment the worker takes the obligation again.\n    nextAttemptAt: epochMsSchema,\n    cursor: MembershipRosterSyncCursorSchema.optional(),\n    // When its retries ran out: present exactly while the obligation is failed.\n    failedAt: epochMsSchema.optional(),\n    // The last failed run's message, kept while it retries and while it is failed; a finished run or\n    // an admin's retry clears it.\n    lastFailureMessage: z.string().max(MAX_ROSTER_SYNC_FAILURE_MESSAGE_LENGTH).optional(),\n    updatedAt: epochMsSchema,\n  })\n  .refine((sync) => sync.reconciledRosterRevision <= sync.rosterRevision, {\n    message: 'A roster obligation cannot be reconciled past its own revision.',\n    path: ['reconciledRosterRevision'],\n  })\n  .refine(\n    (sync) =>\n      (sync.syncStatus === RECONCILED_ROSTER_SYNC_STATUS) ===\n      (sync.reconciledRosterRevision === sync.rosterRevision),\n    {\n      message: 'An obligation is reconciled exactly when its reconciled revision is its revision.',\n      path: ['syncStatus'],\n    },\n  )\n  .refine(\n    (sync) => (sync.syncStatus === FAILED_ROSTER_SYNC_STATUS) === (sync.failedAt !== undefined),\n    {\n      message: 'An obligation carries `failedAt` exactly while it is failed.',\n      path: ['failedAt'],\n    },\n  );\nexport type MembershipRosterSync = z.infer<typeof MembershipRosterSyncSchema>;\n"]}
+{"version":3,"file":"membership-roster-sync.js","sourceRoot":"","sources":["../../src/doc-schemas/membership-roster-sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sCAAsC,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,aAAa,EACb,YAAY,EACZ,cAAc,EACd,gCAAgC,EAChC,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,YAAY,CAAC;IAC7D,cAAc,EAAE,cAAc;IAC9B,WAAW,EAAE,YAAY;CAC1B,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,cAAc,EAAE,cAAc;IAC9B,wBAAwB,EAAE,qBAAqB;IAC/C,UAAU,EAAE,gCAAgC;IAC5C,YAAY,EAAE,WAAW;IACzB,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,gCAAgC,CAAC,QAAQ,EAAE;IACnD,QAAQ,EAAE,aAAa,CAAC,QAAQ,EAAE;IAClC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC,QAAQ,EAAE;IACrF,SAAS,EAAE,aAAa;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,wBAAwB,IAAI,IAAI,CAAC,cAAc,EAAE;IACtE,OAAO,EAAE,iEAAiE;IAC1E,IAAI,EAAE,CAAC,0BAA0B,CAAC;CACnC,CAAC;KACD,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,IAAI,CAAC,UAAU,KAAK,6BAA6B,CAAC;IACnD,CAAC,IAAI,CAAC,wBAAwB,KAAK,IAAI,CAAC,cAAc,CAAC,EACzD;IACE,OAAO,EAAE,mFAAmF;IAC5F,IAAI,EAAE,CAAC,YAAY,CAAC;CACrB,CACF;KACA,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,KAAK,yBAAyB,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,EAC3F;IACE,OAAO,EAAE,8DAA8D;IACvE,IAAI,EAAE,CAAC,UAAU,CAAC;CACnB,CACF,CAAC","sourcesContent":["import { z } from 'zod';\nimport { MAX_ROSTER_SYNC_FAILURE_MESSAGE_LENGTH } from '../constants/business.js';\nimport { FAILED_ROSTER_SYNC_STATUS, RECONCILED_ROSTER_SYNC_STATUS } from '../types/unions.js';\nimport {\n  appliedRevisionSchema,\n  countSchema,\n  epochMsSchema,\n  gameIdSchema,\n  leagueIdSchema,\n  membershipRosterSyncStatusSchema,\n  revisionSchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\n\nexport const MembershipRosterSyncCursorSchema = z.strictObject({\n  rosterRevision: revisionSchema,\n  afterGameId: gameIdSchema,\n});\nexport type MembershipRosterSyncCursor = z.infer<typeof MembershipRosterSyncCursorSchema>;\n\nexport const MembershipRosterSyncSchema = z\n  .object({\n    leagueId: leagueIdSchema,\n    teamId: teamIdSchema,\n    userId: userIdSchema,\n    rosterRevision: revisionSchema,\n    reconciledRosterRevision: appliedRevisionSchema,\n    syncStatus: membershipRosterSyncStatusSchema,\n    attemptCount: countSchema,\n    nextAttemptAt: epochMsSchema,\n    cursor: MembershipRosterSyncCursorSchema.optional(),\n    failedAt: epochMsSchema.optional(),\n    lastFailureMessage: z.string().max(MAX_ROSTER_SYNC_FAILURE_MESSAGE_LENGTH).optional(),\n    updatedAt: epochMsSchema,\n  })\n  .refine((sync) => sync.reconciledRosterRevision <= sync.rosterRevision, {\n    message: 'A roster obligation cannot be reconciled past its own revision.',\n    path: ['reconciledRosterRevision'],\n  })\n  .refine(\n    (sync) =>\n      (sync.syncStatus === RECONCILED_ROSTER_SYNC_STATUS) ===\n      (sync.reconciledRosterRevision === sync.rosterRevision),\n    {\n      message: 'An obligation is reconciled exactly when its reconciled revision is its revision.',\n      path: ['syncStatus'],\n    },\n  )\n  .refine(\n    (sync) => (sync.syncStatus === FAILED_ROSTER_SYNC_STATUS) === (sync.failedAt !== undefined),\n    {\n      message: 'An obligation carries `failedAt` exactly while it is failed.',\n      path: ['failedAt'],\n    },\n  );\nexport type MembershipRosterSync = z.infer<typeof MembershipRosterSyncSchema>;\n"]}

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

@@ -89,15 +89,8 @@ export declare const migrationDestinationStateSchema: z.ZodEnum<{
     live: "live";
     preCutover: "preCutover";
 }>;
-/** One logical run of an action, minted by the admin's browser when the admin starts it. */
 export declare const migrationOperationIdSchema: z.ZodString;
-/** What the operator records as proof of a step the console cannot see done. */
 export declare const migrationEvidenceSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
-/**
- * One document an action reported: skipped by a copy, missing or mismatched in a verification, or
- * named by one of an action's own report lists (a merged pair, a created roster entry, a ghost's
- * disposition) — `category` names which.
- */
 export declare const MigrationFindingSchema: z.ZodObject<{
     category: z.ZodString;
     id: z.ZodString;
@@ -105,7 +98,6 @@ export declare const MigrationFindingSchema: z.ZodObject<{
     reason: z.ZodString;
 }, z.core.$strict>;
 export type MigrationFinding = z.infer<typeof MigrationFindingSchema>;
-/** A run's totals across its pages. A write action fills the first three, a verification the next three. */
 export declare const MigrationRunCountsSchema: z.ZodObject<{
     read: z.ZodNumber;
     written: z.ZodNumber;
@@ -151,7 +143,6 @@ export declare const MigrationRunRecordSchema: z.ZodObject<{
     stoppedReason: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type MigrationRunRecord = z.infer<typeof MigrationRunRecordSchema>;
-/** A product control's run, an operator checkpoint, or the cutover, as recorded. */
 export declare const MigrationStepRecordSchema: z.ZodObject<{
     recordedAt: z.ZodNumber;
     recordedByUserId: z.ZodString;
@@ -324,7 +315,6 @@ export declare const MigrationActionRunSchema: z.ZodObject<{
     }, z.core.$strict>>;
 }, z.core.$strict>;
 export type MigrationActionRun = z.infer<typeof MigrationActionRunSchema>;
-/** The one action holding the console, until its lease runs out. */
 export declare const MigrationConsoleLockSchema: z.ZodObject<{
     actionId: z.ZodEnum<{
         "copy.userProfiles": "copy.userProfiles";

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

@@ -1 +1 @@
-{"version":3,"file":"migration-console.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/migration-console.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAmC,CAAC;AACxE,eAAO,MAAM,+BAA+B;;;EAA2C,CAAC;AACxF,4FAA4F;AAC5F,eAAO,MAAM,0BAA0B,aAA0B,CAAC;AAClE,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,wDAAmD,CAAC;AAIxF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;kBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,4GAA4G;AAC5G,eAAO,MAAM,wBAAwB;;;;;;;kBAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0BnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,oFAAoF;AACpF,eAAO,MAAM,yBAAyB;;;;;kBAOpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,oEAAoE;AACpE,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
+{"version":3,"file":"migration-console.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/migration-console.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAmC,CAAC;AACxE,eAAO,MAAM,+BAA+B;;;EAA2C,CAAC;AACxF,eAAO,MAAM,0BAA0B,aAA0B,CAAC;AAClE,eAAO,MAAM,uBAAuB,wDAAmD,CAAC;AAIxF,eAAO,MAAM,sBAAsB;;;;;kBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,wBAAwB;;;;;;;kBAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,yBAAyB;;;;;kBAKpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/doc-schemas/migration-console.js

@@ -1,9 +1,3 @@
-// The migration console's recorded state — admin read, written only by the console's callables.
-//
-// `_serverData/migrationConsole` holds the cutover marker and the lock: one action runs at a time, and
-// whether the destinations are still the migration's is recorded here, never taken from the
-// operator. `migrationActionRuns/{actionId}` holds each step's latest real run — the one its
-// dependents read — its latest preview, and, for a recorded step, what was recorded.
 import { z } from 'zod';
 import { MIGRATION_EVIDENCE_INPUT_FORMAT } from '../input-formats/input-formats.js';
 import { MIGRATION_ACTION_ID_KEYS } from '../migration-console/action-ids.js';
@@ -11,23 +5,15 @@ import { MAX_MIGRATION_FINDING_TEXT_LENGTH, MAX_MIGRATION_RUN_FINDINGS, MIGRATIO
 import { countSchema, documentIdSegmentSchema, epochMsSchema, repairReasonSchema, statsOperationIdSchema, textFieldSchema, userIdSchema, } from './atoms.js';
 export const migrationActionIdSchema = z.enum(MIGRATION_ACTION_ID_KEYS);
 export const migrationDestinationStateSchema = z.enum(MIGRATION_DESTINATION_STATE_KEYS);
-/** One logical run of an action, minted by the admin's browser when the admin starts it. */
 export const migrationOperationIdSchema = documentIdSegmentSchema;
-/** What the operator records as proof of a step the console cannot see done. */
 export const migrationEvidenceSchema = textFieldSchema(MIGRATION_EVIDENCE_INPUT_FORMAT);
 const findingText = z.string().max(MAX_MIGRATION_FINDING_TEXT_LENGTH);
-/**
- * One document an action reported: skipped by a copy, missing or mismatched in a verification, or
- * named by one of an action's own report lists (a merged pair, a created roster entry, a ghost's
- * disposition) — `category` names which.
- */
 export const MigrationFindingSchema = z.strictObject({
     category: z.string().min(1).max(64),
     id: findingText,
     field: findingText,
     reason: findingText,
 });
-/** A run's totals across its pages. A write action fills the first three, a verification the next three. */
 export const MigrationRunCountsSchema = z.strictObject({
     read: countSchema,
     written: countSchema,
@@ -43,53 +29,35 @@ export const MigrationRunRecordSchema = z.strictObject({
     startedByUserId: userIdSchema,
     startedAt: epochMsSchema,
     updatedAt: epochMsSchema,
-    // Set with `complete`: the moment the run reached its end.
     completedAt: epochMsSchema.optional(),
     status: z.enum(MIGRATION_RUN_STATUS_KEYS),
     pages: countSchema,
-    // The resume key of the next page, or null once the run reached its end.
     nextResumeAfter: z.string().min(1).nullable(),
     counts: MigrationRunCountsSchema,
-    // An action's own counters beyond the shared ones — merged pairs, corrections by field, kept
-    // ghosts by disposition — summed across pages.
     details: z.record(z.string().min(1), countSchema),
     findings: z.array(MigrationFindingSchema).max(MAX_MIGRATION_RUN_FINDINGS),
-    // Findings met past the kept ones; each page's answer carried them in full.
     findingsNotKept: countSchema,
-    // A verification run declared, at its start, that its source is empty.
     expectEmptySource: z.boolean(),
-    // A `verify.v1Pictures` run acknowledged, at its start, the sources it cannot examine.
     acknowledgeUnexaminedSources: z.boolean().optional(),
-    // Why a stopped run stopped: the refusal its core gave.
     stoppedReason: findingText.optional(),
 });
-/** A product control's run, an operator checkpoint, or the cutover, as recorded. */
 export const MigrationStepRecordSchema = z.strictObject({
     recordedAt: epochMsSchema,
     recordedByUserId: userIdSchema,
-    // A product control's runs, whose evidence the console checked.
     operationIds: z.array(statsOperationIdSchema).optional(),
-    // An operator checkpoint's evidence, or a recorded step's reason.
     evidence: migrationEvidenceSchema,
 });
 export const MigrationActionRunSchema = z.strictObject({
     actionId: migrationActionIdSchema,
-    // The latest real run: what every dependent and every gate reads.
     run: MigrationRunRecordSchema.optional(),
-    // The latest dry run, kept apart so a preview never stands in for a run.
     preview: MigrationRunRecordSchema.optional(),
     recorded: MigrationStepRecordSchema.optional(),
 });
-/** The one action holding the console, until its lease runs out. */
 export const MigrationConsoleLockSchema = z.strictObject({
     actionId: migrationActionIdSchema,
     operationId: migrationOperationIdSchema,
     heldByUserId: userIdSchema,
     expiresAt: epochMsSchema,
-    // Present while one page of the run is in flight: the moment its claim was stamped, and that
-    // page's fencing token. Only the page holding this exact token records its result or releases the
-    // lock; any other page, the same run's included, is refused while it stands. A lock stored
-    // without one has no page in flight.
     pageClaimedAt: epochMsSchema.optional(),
 });
 export const MigrationConsoleSchema = z.strictObject({

package/dist/doc-schemas/migration-console.js.map

@@ -1 +1 @@
-{"version":3,"file":"migration-console.js","sourceRoot":"","sources":["../../src/doc-schemas/migration-console.ts"],"names":[],"mappings":"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","sourcesContent":["// The migration console's recorded state — admin read, written only by the console's callables.\n//\n// `_serverData/migrationConsole` holds the cutover marker and the lock: one action runs at a time, and\n// whether the destinations are still the migration's is recorded here, never taken from the\n// operator. `migrationActionRuns/{actionId}` holds each step's latest real run — the one its\n// dependents read — its latest preview, and, for a recorded step, what was recorded.\n\nimport { z } from 'zod';\nimport { MIGRATION_EVIDENCE_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport { MIGRATION_ACTION_ID_KEYS } from '../migration-console/action-ids.js';\nimport {\n  MAX_MIGRATION_FINDING_TEXT_LENGTH,\n  MAX_MIGRATION_RUN_FINDINGS,\n  MIGRATION_DESTINATION_STATE_KEYS,\n  MIGRATION_RUN_STATUS_KEYS,\n} from '../migration-console/run-state.js';\nimport {\n  countSchema,\n  documentIdSegmentSchema,\n  epochMsSchema,\n  repairReasonSchema,\n  statsOperationIdSchema,\n  textFieldSchema,\n  userIdSchema,\n} from './atoms.js';\n\nexport const migrationActionIdSchema = z.enum(MIGRATION_ACTION_ID_KEYS);\nexport const migrationDestinationStateSchema = z.enum(MIGRATION_DESTINATION_STATE_KEYS);\n/** One logical run of an action, minted by the admin's browser when the admin starts it. */\nexport const migrationOperationIdSchema = documentIdSegmentSchema;\n/** What the operator records as proof of a step the console cannot see done. */\nexport const migrationEvidenceSchema = textFieldSchema(MIGRATION_EVIDENCE_INPUT_FORMAT);\n\nconst findingText = z.string().max(MAX_MIGRATION_FINDING_TEXT_LENGTH);\n\n/**\n * One document an action reported: skipped by a copy, missing or mismatched in a verification, or\n * named by one of an action's own report lists (a merged pair, a created roster entry, a ghost's\n * disposition) — `category` names which.\n */\nexport const MigrationFindingSchema = z.strictObject({\n  category: z.string().min(1).max(64),\n  id: findingText,\n  field: findingText,\n  reason: findingText,\n});\nexport type MigrationFinding = z.infer<typeof MigrationFindingSchema>;\n\n/** A run's totals across its pages. A write action fills the first three, a verification the next three. */\nexport const MigrationRunCountsSchema = z.strictObject({\n  read: countSchema,\n  written: countSchema,\n  skipped: countSchema,\n  checked: countSchema,\n  missing: countSchema,\n  mismatched: countSchema,\n});\nexport type MigrationRunCounts = z.infer<typeof MigrationRunCountsSchema>;\n\nexport const MigrationRunRecordSchema = z.strictObject({\n  operationId: migrationOperationIdSchema,\n  dryRun: z.boolean(),\n  reason: repairReasonSchema,\n  startedByUserId: userIdSchema,\n  startedAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n  // Set with `complete`: the moment the run reached its end.\n  completedAt: epochMsSchema.optional(),\n  status: z.enum(MIGRATION_RUN_STATUS_KEYS),\n  pages: countSchema,\n  // The resume key of the next page, or null once the run reached its end.\n  nextResumeAfter: z.string().min(1).nullable(),\n  counts: MigrationRunCountsSchema,\n  // An action's own counters beyond the shared ones — merged pairs, corrections by field, kept\n  // ghosts by disposition — summed across pages.\n  details: z.record(z.string().min(1), countSchema),\n  findings: z.array(MigrationFindingSchema).max(MAX_MIGRATION_RUN_FINDINGS),\n  // Findings met past the kept ones; each page's answer carried them in full.\n  findingsNotKept: countSchema,\n  // A verification run declared, at its start, that its source is empty.\n  expectEmptySource: z.boolean(),\n  // A `verify.v1Pictures` run acknowledged, at its start, the sources it cannot examine.\n  acknowledgeUnexaminedSources: z.boolean().optional(),\n  // Why a stopped run stopped: the refusal its core gave.\n  stoppedReason: findingText.optional(),\n});\nexport type MigrationRunRecord = z.infer<typeof MigrationRunRecordSchema>;\n\n/** A product control's run, an operator checkpoint, or the cutover, as recorded. */\nexport const MigrationStepRecordSchema = z.strictObject({\n  recordedAt: epochMsSchema,\n  recordedByUserId: userIdSchema,\n  // A product control's runs, whose evidence the console checked.\n  operationIds: z.array(statsOperationIdSchema).optional(),\n  // An operator checkpoint's evidence, or a recorded step's reason.\n  evidence: migrationEvidenceSchema,\n});\nexport type MigrationStepRecord = z.infer<typeof MigrationStepRecordSchema>;\n\nexport const MigrationActionRunSchema = z.strictObject({\n  actionId: migrationActionIdSchema,\n  // The latest real run: what every dependent and every gate reads.\n  run: MigrationRunRecordSchema.optional(),\n  // The latest dry run, kept apart so a preview never stands in for a run.\n  preview: MigrationRunRecordSchema.optional(),\n  recorded: MigrationStepRecordSchema.optional(),\n});\nexport type MigrationActionRun = z.infer<typeof MigrationActionRunSchema>;\n\n/** The one action holding the console, until its lease runs out. */\nexport const MigrationConsoleLockSchema = z.strictObject({\n  actionId: migrationActionIdSchema,\n  operationId: migrationOperationIdSchema,\n  heldByUserId: userIdSchema,\n  expiresAt: epochMsSchema,\n  // Present while one page of the run is in flight: the moment its claim was stamped, and that\n  // page's fencing token. Only the page holding this exact token records its result or releases the\n  // lock; any other page, the same run's included, is refused while it stands. A lock stored\n  // without one has no page in flight.\n  pageClaimedAt: epochMsSchema.optional(),\n});\nexport type MigrationConsoleLock = z.infer<typeof MigrationConsoleLockSchema>;\n\nexport const MigrationConsoleSchema = z.strictObject({\n  destinationState: migrationDestinationStateSchema,\n  cutoverRecordedAt: epochMsSchema.optional(),\n  cutoverRecordedByUserId: userIdSchema.optional(),\n  lock: MigrationConsoleLockSchema.nullable(),\n  updatedAt: epochMsSchema,\n});\nexport type MigrationConsole = z.infer<typeof MigrationConsoleSchema>;\n"]}
+{"version":3,"file":"migration-console.js","sourceRoot":"","sources":["../../src/doc-schemas/migration-console.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { MIGRATION_EVIDENCE_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport { MIGRATION_ACTION_ID_KEYS } from '../migration-console/action-ids.js';\nimport {\n  MAX_MIGRATION_FINDING_TEXT_LENGTH,\n  MAX_MIGRATION_RUN_FINDINGS,\n  MIGRATION_DESTINATION_STATE_KEYS,\n  MIGRATION_RUN_STATUS_KEYS,\n} from '../migration-console/run-state.js';\nimport {\n  countSchema,\n  documentIdSegmentSchema,\n  epochMsSchema,\n  repairReasonSchema,\n  statsOperationIdSchema,\n  textFieldSchema,\n  userIdSchema,\n} from './atoms.js';\n\nexport const migrationActionIdSchema = z.enum(MIGRATION_ACTION_ID_KEYS);\nexport const migrationDestinationStateSchema = z.enum(MIGRATION_DESTINATION_STATE_KEYS);\nexport const migrationOperationIdSchema = documentIdSegmentSchema;\nexport const migrationEvidenceSchema = textFieldSchema(MIGRATION_EVIDENCE_INPUT_FORMAT);\n\nconst findingText = z.string().max(MAX_MIGRATION_FINDING_TEXT_LENGTH);\n\nexport const MigrationFindingSchema = z.strictObject({\n  category: z.string().min(1).max(64),\n  id: findingText,\n  field: findingText,\n  reason: findingText,\n});\nexport type MigrationFinding = z.infer<typeof MigrationFindingSchema>;\n\nexport const MigrationRunCountsSchema = z.strictObject({\n  read: countSchema,\n  written: countSchema,\n  skipped: countSchema,\n  checked: countSchema,\n  missing: countSchema,\n  mismatched: countSchema,\n});\nexport type MigrationRunCounts = z.infer<typeof MigrationRunCountsSchema>;\n\nexport const MigrationRunRecordSchema = z.strictObject({\n  operationId: migrationOperationIdSchema,\n  dryRun: z.boolean(),\n  reason: repairReasonSchema,\n  startedByUserId: userIdSchema,\n  startedAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n  completedAt: epochMsSchema.optional(),\n  status: z.enum(MIGRATION_RUN_STATUS_KEYS),\n  pages: countSchema,\n  nextResumeAfter: z.string().min(1).nullable(),\n  counts: MigrationRunCountsSchema,\n  details: z.record(z.string().min(1), countSchema),\n  findings: z.array(MigrationFindingSchema).max(MAX_MIGRATION_RUN_FINDINGS),\n  findingsNotKept: countSchema,\n  expectEmptySource: z.boolean(),\n  acknowledgeUnexaminedSources: z.boolean().optional(),\n  stoppedReason: findingText.optional(),\n});\nexport type MigrationRunRecord = z.infer<typeof MigrationRunRecordSchema>;\n\nexport const MigrationStepRecordSchema = z.strictObject({\n  recordedAt: epochMsSchema,\n  recordedByUserId: userIdSchema,\n  operationIds: z.array(statsOperationIdSchema).optional(),\n  evidence: migrationEvidenceSchema,\n});\nexport type MigrationStepRecord = z.infer<typeof MigrationStepRecordSchema>;\n\nexport const MigrationActionRunSchema = z.strictObject({\n  actionId: migrationActionIdSchema,\n  run: MigrationRunRecordSchema.optional(),\n  preview: MigrationRunRecordSchema.optional(),\n  recorded: MigrationStepRecordSchema.optional(),\n});\nexport type MigrationActionRun = z.infer<typeof MigrationActionRunSchema>;\n\nexport const MigrationConsoleLockSchema = z.strictObject({\n  actionId: migrationActionIdSchema,\n  operationId: migrationOperationIdSchema,\n  heldByUserId: userIdSchema,\n  expiresAt: epochMsSchema,\n  pageClaimedAt: epochMsSchema.optional(),\n});\nexport type MigrationConsoleLock = z.infer<typeof MigrationConsoleLockSchema>;\n\nexport const MigrationConsoleSchema = z.strictObject({\n  destinationState: migrationDestinationStateSchema,\n  cutoverRecordedAt: epochMsSchema.optional(),\n  cutoverRecordedByUserId: userIdSchema.optional(),\n  lock: MigrationConsoleLockSchema.nullable(),\n  updatedAt: epochMsSchema,\n});\nexport type MigrationConsole = z.infer<typeof MigrationConsoleSchema>;\n"]}