@ttt-productions/q-core 0.1.28 → 0.1.30

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

@@ -1,16 +1,3 @@
-// `statsOperations/{operationId}` — one logical run of a stats action: a rebuild, a validation, a
-// game's correction or recalculation, a historical-baseline update, a ghost's stats half, or a game
-// deletion. The stats cores write it in the same commit as each page it records, so an interrupted
-// run resumes the same operation instead of starting a second one, and a retried single-game action
-// finds its operation `complete` and is acknowledged.
-//
-// It is also the hold on a game: while a multi-page operation works a game, the game's
-// `statsOperationId` names this document, and every other writer of that game refuses it.
-//
-// The id is minted by the client when the admin starts the action, except two the server derives: a
-// ghost's, from the team and the ghost, so a ghost has one operation for its links and its removal;
-// and a game deletion's, from the game (`buildGameDeletionOperationId`).
-// Admin read; written only by the stats cores.
 import { z } from 'zod';
 import { GHOST_LINK_MEMBERSHIP_OUTCOME_KEYS, STATS_OPERATION_STATUS_KEYS, STATS_VALIDATION_PHASE_KEYS, } from '../types/stats.js';
 import { countSchema, epochMsSchema, gameIdSchema, leagueIdSchema, repairReasonSchema, sportKeySchema, teamIdSchema, userIdSchema, } from './atoms.js';
@@ -25,41 +12,36 @@ const operationBase = {
     startedAt: epochMsSchema,
     updatedAt: epochMsSchema,
     status: z.enum(STATS_OPERATION_STATUS_KEYS),
-    // The last document id a paged run finished; absent before its first page.
     resumeAfter: z.string().min(1).optional(),
     counts: StatsOperationCountsSchema,
 };
-// A rebuild replaces a destination whole and never rebuilds from a game whose record disagrees with
-// its rollup; it names each such game and rebuilds everything that game does not feed.
 const rebuildFields = {
     ...operationBase,
     reason: repairReasonSchema,
     stoppedOnGameIds: z.array(gameIdSchema),
 };
 const gameScope = z.strictObject({ gameId: gameIdSchema });
+// `hashStatsOperationRequest` of the values the operation was opened with. Optional: an operation
+// stored before it existed still resumes.
+const requestHashSchema = z.string().regex(/^[0-9a-f]{64}$/);
 export const LeagueStatsRebuildOperationSchema = z.strictObject({
     ...rebuildFields,
     kind: z.literal('leagueStatsRebuild'),
-    // Absent: every league.
     scope: z.strictObject({ leagueId: leagueIdSchema.optional() }),
 });
 export const LifetimeStatsRebuildOperationSchema = z.strictObject({
     ...rebuildFields,
     kind: z.literal('lifetimeStatsRebuild'),
-    // Absent: every user.
     scope: z.strictObject({ userId: userIdSchema.optional() }),
 });
 export const HallOfFameRebuildOperationSchema = z.strictObject({
     ...rebuildFields,
     kind: z.literal('hallOfFameRebuild'),
-    // Absent user: the whole sport.
     scope: z.strictObject({ sportKey: sportKeySchema, userId: userIdSchema.optional() }),
 });
-// A validation writes no stat, so it takes no reason.
 export const StatsValidationOperationSchema = z.strictObject({
     ...operationBase,
     kind: z.literal('statsValidation'),
-    // One game, one league, or — with neither — everything.
     scope: StatsValidationScopeSchema,
     phase: z.enum(STATS_VALIDATION_PHASE_KEYS),
 });
@@ -68,6 +50,7 @@ export const GameStatsCorrectionOperationSchema = z.strictObject({
     kind: z.literal('gameStatsCorrection'),
     scope: gameScope,
     reason: repairReasonSchema,
+    requestHash: requestHashSchema.optional(),
 });
 export const GameStatsRecalculationOperationSchema = z.strictObject({
     ...operationBase,
@@ -80,37 +63,24 @@ export const HistoricalStatsUpdateOperationSchema = z.strictObject({
     kind: z.literal('historicalStatsUpdate'),
     scope: z.strictObject({ userId: userIdSchema, sportKey: sportKeySchema }),
     reason: repairReasonSchema,
+    requestHash: requestHashSchema.optional(),
 });
-// One completed game a never-played ghost's removal took the ghost's entry off, with what the stored
-// participation decision said of the entry before: absent, and credited no game played. The per-game
-// transaction that removes the entry records it, so the removal's audit event names every one.
 export const GhostRemovedFinishedEntrySchema = z.strictObject({
     gameId: gameIdSchema,
     wasAbsent: z.boolean(),
     wasNonScoring: z.boolean(),
 });
-// One game a ghost link moved the ghost's entry on, whether the game was completed when it did, and
-// whether the account already held an entry there that the ghost's merged into. The per-game
-// transaction records it, so the link's audit event names every one.
 export const GhostLinkedGameSchema = z.strictObject({
     gameId: gameIdSchema,
     completed: z.boolean(),
     merged: z.boolean(),
 });
-// One derived line a stats action moved — a team's standings line, a per-membership row, a lifetime
-// line, or a hall-of-fame entry — with its value before the action's first change to it and after
-// its latest, `null` where there was or is no line. Every repair's audit event records them, and a
-// dry run lists them without writing (RULE-STD-BACKEND-212).
 export const StatsDestinationChangeSchema = z.strictObject({
     ref: z.string().min(1),
     field: z.string().min(1),
     before: z.record(z.string(), z.number()).nullable(),
     after: z.record(z.string(), z.number()).nullable(),
 });
-// The ghost's one operation records the account a link chose, or the removal, so a call naming a
-// different account — or a removal against a link — is refused, and the same call resumes. Neither
-// takes a reason: a link is chosen and confirmed, and its audit event records who linked which ghost
-// to whom and what moved (RULE-STD-BACKEND-212).
 export const GhostPlayerStatsOperationSchema = z
     .strictObject({
     ...operationBase,
@@ -128,17 +98,12 @@ export const GhostPlayerStatsOperationSchema = z
             ghostUserId: userIdSchema,
         }),
     ]),
-    // A reason stored by a link or a removal recorded while they still took one; no operation
-    // writes one now. A removal's is dropped on read; a link's is kept, so its stored operation
-    // still resumes.
+    // Present only on an operation stored with a reason. A removal's is dropped on read; a link's
+    // is kept, so its stored operation still resumes.
     reason: repairReasonSchema.optional(),
-    // A removal's finished-game entries, in the order it removed them; absent on a link.
     removedFinishedGameEntries: z.array(GhostRemovedFinishedEntrySchema).optional(),
-    // A link's games moved so far, in the order it moved them, and every derived line it changed;
-    // absent on a removal.
     linkedGames: z.array(GhostLinkedGameSchema).optional(),
     destinationChanges: z.array(StatsDestinationChangeSchema).optional(),
-    // What a completed link did with the team's memberships, so a call after completion answers it.
     membershipOutcome: z.enum(GHOST_LINK_MEMBERSHIP_OUTCOME_KEYS).optional(),
 })
     .overwrite((operation) => {
@@ -147,8 +112,6 @@ export const GhostPlayerStatsOperationSchema = z
     const { reason: _reason, ...withoutReason } = operation;
     return withoutReason;
 });
-// A game deletion pages out the game's events and roster under the hold and removes the game
-// document last; running it again on a held game continues it.
 export const GameDeletionOperationSchema = z.strictObject({
     ...operationBase,
     kind: z.literal('gameDeletion'),

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

@@ -1 +1 @@
-{"version":3,"file":"stats-operation.js","sourceRoot":"","sources":["../../src/doc-schemas/stats-operation.ts"],"names":[],"mappings":"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","sourcesContent":["// `statsOperations/{operationId}` — one logical run of a stats action: a rebuild, a validation, a\n// game's correction or recalculation, a historical-baseline update, a ghost's stats half, or a game\n// deletion. The stats cores write it in the same commit as each page it records, so an interrupted\n// run resumes the same operation instead of starting a second one, and a retried single-game action\n// finds its operation `complete` and is acknowledged.\n//\n// It is also the hold on a game: while a multi-page operation works a game, the game's\n// `statsOperationId` names this document, and every other writer of that game refuses it.\n//\n// The id is minted by the client when the admin starts the action, except two the server derives: a\n// ghost's, from the team and the ghost, so a ghost has one operation for its links and its removal;\n// and a game deletion's, from the game (`buildGameDeletionOperationId`).\n// Admin read; written only by the stats cores.\n\nimport { z } from 'zod';\nimport {\n  GHOST_LINK_MEMBERSHIP_OUTCOME_KEYS,\n  STATS_OPERATION_STATUS_KEYS,\n  STATS_VALIDATION_PHASE_KEYS,\n} from '../types/stats.js';\nimport type { GhostStatsOperationAction, StatsOperationKind } from '../types/stats.js';\nimport {\n  countSchema,\n  epochMsSchema,\n  gameIdSchema,\n  leagueIdSchema,\n  repairReasonSchema,\n  sportKeySchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\nimport { StatsValidationScopeSchema } from './system.js';\n\nexport const StatsOperationCountsSchema = z.strictObject({\n  read: countSchema,\n  changed: countSchema,\n  skipped: countSchema,\n});\nexport type StatsOperationCounts = z.infer<typeof StatsOperationCountsSchema>;\n\nconst operationBase = {\n  startedByUserId: userIdSchema,\n  startedAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n  status: z.enum(STATS_OPERATION_STATUS_KEYS),\n  // The last document id a paged run finished; absent before its first page.\n  resumeAfter: z.string().min(1).optional(),\n  counts: StatsOperationCountsSchema,\n};\n\n// A rebuild replaces a destination whole and never rebuilds from a game whose record disagrees with\n// its rollup; it names each such game and rebuilds everything that game does not feed.\nconst rebuildFields = {\n  ...operationBase,\n  reason: repairReasonSchema,\n  stoppedOnGameIds: z.array(gameIdSchema),\n};\n\nconst gameScope = z.strictObject({ gameId: gameIdSchema });\n\nexport const LeagueStatsRebuildOperationSchema = z.strictObject({\n  ...rebuildFields,\n  kind: z.literal('leagueStatsRebuild' satisfies StatsOperationKind),\n  // Absent: every league.\n  scope: z.strictObject({ leagueId: leagueIdSchema.optional() }),\n});\n\nexport const LifetimeStatsRebuildOperationSchema = z.strictObject({\n  ...rebuildFields,\n  kind: z.literal('lifetimeStatsRebuild' satisfies StatsOperationKind),\n  // Absent: every user.\n  scope: z.strictObject({ userId: userIdSchema.optional() }),\n});\n\nexport const HallOfFameRebuildOperationSchema = z.strictObject({\n  ...rebuildFields,\n  kind: z.literal('hallOfFameRebuild' satisfies StatsOperationKind),\n  // Absent user: the whole sport.\n  scope: z.strictObject({ sportKey: sportKeySchema, userId: userIdSchema.optional() }),\n});\n\n// A validation writes no stat, so it takes no reason.\nexport const StatsValidationOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('statsValidation' satisfies StatsOperationKind),\n  // One game, one league, or — with neither — everything.\n  scope: StatsValidationScopeSchema,\n  phase: z.enum(STATS_VALIDATION_PHASE_KEYS),\n});\n\nexport const GameStatsCorrectionOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('gameStatsCorrection' satisfies StatsOperationKind),\n  scope: gameScope,\n  reason: repairReasonSchema,\n});\n\nexport const GameStatsRecalculationOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('gameStatsRecalculation' satisfies StatsOperationKind),\n  scope: gameScope,\n  reason: repairReasonSchema,\n});\n\nexport const HistoricalStatsUpdateOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('historicalStatsUpdate' satisfies StatsOperationKind),\n  scope: z.strictObject({ userId: userIdSchema, sportKey: sportKeySchema }),\n  reason: repairReasonSchema,\n});\n\n// One completed game a never-played ghost's removal took the ghost's entry off, with what the stored\n// participation decision said of the entry before: absent, and credited no game played. The per-game\n// transaction that removes the entry records it, so the removal's audit event names every one.\nexport const GhostRemovedFinishedEntrySchema = z.strictObject({\n  gameId: gameIdSchema,\n  wasAbsent: z.boolean(),\n  wasNonScoring: z.boolean(),\n});\nexport type GhostRemovedFinishedEntry = z.infer<typeof GhostRemovedFinishedEntrySchema>;\n\n// One game a ghost link moved the ghost's entry on, whether the game was completed when it did, and\n// whether the account already held an entry there that the ghost's merged into. The per-game\n// transaction records it, so the link's audit event names every one.\nexport const GhostLinkedGameSchema = z.strictObject({\n  gameId: gameIdSchema,\n  completed: z.boolean(),\n  merged: z.boolean(),\n});\nexport type GhostLinkedGame = z.infer<typeof GhostLinkedGameSchema>;\n\n// One derived line a stats action moved — a team's standings line, a per-membership row, a lifetime\n// line, or a hall-of-fame entry — with its value before the action's first change to it and after\n// its latest, `null` where there was or is no line. Every repair's audit event records them, and a\n// dry run lists them without writing (RULE-STD-BACKEND-212).\nexport const StatsDestinationChangeSchema = z.strictObject({\n  ref: z.string().min(1),\n  field: z.string().min(1),\n  before: z.record(z.string(), z.number()).nullable(),\n  after: z.record(z.string(), z.number()).nullable(),\n});\nexport type StatsDestinationChange = z.infer<typeof StatsDestinationChangeSchema>;\n\n// The ghost's one operation records the account a link chose, or the removal, so a call naming a\n// different account — or a removal against a link — is refused, and the same call resumes. Neither\n// takes a reason: a link is chosen and confirmed, and its audit event records who linked which ghost\n// to whom and what moved (RULE-STD-BACKEND-212).\nexport const GhostPlayerStatsOperationSchema = z\n  .strictObject({\n    ...operationBase,\n    kind: z.literal('ghostPlayerStats' satisfies StatsOperationKind),\n    scope: z.discriminatedUnion('action', [\n      z.strictObject({\n        action: z.literal('link' satisfies GhostStatsOperationAction),\n        teamId: teamIdSchema,\n        ghostUserId: userIdSchema,\n        userId: userIdSchema,\n      }),\n      z.strictObject({\n        action: z.literal('removal' satisfies GhostStatsOperationAction),\n        teamId: teamIdSchema,\n        ghostUserId: userIdSchema,\n      }),\n    ]),\n    // A reason stored by a link or a removal recorded while they still took one; no operation\n    // writes one now. A removal's is dropped on read; a link's is kept, so its stored operation\n    // still resumes.\n    reason: repairReasonSchema.optional(),\n    // A removal's finished-game entries, in the order it removed them; absent on a link.\n    removedFinishedGameEntries: z.array(GhostRemovedFinishedEntrySchema).optional(),\n    // A link's games moved so far, in the order it moved them, and every derived line it changed;\n    // absent on a removal.\n    linkedGames: z.array(GhostLinkedGameSchema).optional(),\n    destinationChanges: z.array(StatsDestinationChangeSchema).optional(),\n    // What a completed link did with the team's memberships, so a call after completion answers it.\n    membershipOutcome: z.enum(GHOST_LINK_MEMBERSHIP_OUTCOME_KEYS).optional(),\n  })\n  .overwrite((operation) => {\n    if (operation.scope.action !== 'removal' || operation.reason === undefined) return operation;\n    const { reason: _reason, ...withoutReason } = operation;\n    return withoutReason;\n  });\nexport type GhostPlayerStatsOperation = z.infer<typeof GhostPlayerStatsOperationSchema>;\n\n// A game deletion pages out the game's events and roster under the hold and removes the game\n// document last; running it again on a held game continues it.\nexport const GameDeletionOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('gameDeletion' satisfies StatsOperationKind),\n  scope: gameScope,\n});\n\nexport const StatsOperationSchema = z.discriminatedUnion('kind', [\n  LeagueStatsRebuildOperationSchema,\n  LifetimeStatsRebuildOperationSchema,\n  HallOfFameRebuildOperationSchema,\n  StatsValidationOperationSchema,\n  GameStatsCorrectionOperationSchema,\n  GameStatsRecalculationOperationSchema,\n  HistoricalStatsUpdateOperationSchema,\n  GhostPlayerStatsOperationSchema,\n  GameDeletionOperationSchema,\n]);\nexport type StatsOperation = z.infer<typeof StatsOperationSchema>;\n"]}
+{"version":3,"file":"stats-operation.js","sourceRoot":"","sources":["../../src/doc-schemas/stats-operation.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  GHOST_LINK_MEMBERSHIP_OUTCOME_KEYS,\n  STATS_OPERATION_STATUS_KEYS,\n  STATS_VALIDATION_PHASE_KEYS,\n} from '../types/stats.js';\nimport type { GhostStatsOperationAction, StatsOperationKind } from '../types/stats.js';\nimport {\n  countSchema,\n  epochMsSchema,\n  gameIdSchema,\n  leagueIdSchema,\n  repairReasonSchema,\n  sportKeySchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\nimport { StatsValidationScopeSchema } from './system.js';\n\nexport const StatsOperationCountsSchema = z.strictObject({\n  read: countSchema,\n  changed: countSchema,\n  skipped: countSchema,\n});\nexport type StatsOperationCounts = z.infer<typeof StatsOperationCountsSchema>;\n\nconst operationBase = {\n  startedByUserId: userIdSchema,\n  startedAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n  status: z.enum(STATS_OPERATION_STATUS_KEYS),\n  resumeAfter: z.string().min(1).optional(),\n  counts: StatsOperationCountsSchema,\n};\n\nconst rebuildFields = {\n  ...operationBase,\n  reason: repairReasonSchema,\n  stoppedOnGameIds: z.array(gameIdSchema),\n};\n\nconst gameScope = z.strictObject({ gameId: gameIdSchema });\n\n// `hashStatsOperationRequest` of the values the operation was opened with. Optional: an operation\n// stored before it existed still resumes.\nconst requestHashSchema = z.string().regex(/^[0-9a-f]{64}$/);\n\nexport const LeagueStatsRebuildOperationSchema = z.strictObject({\n  ...rebuildFields,\n  kind: z.literal('leagueStatsRebuild' satisfies StatsOperationKind),\n  scope: z.strictObject({ leagueId: leagueIdSchema.optional() }),\n});\n\nexport const LifetimeStatsRebuildOperationSchema = z.strictObject({\n  ...rebuildFields,\n  kind: z.literal('lifetimeStatsRebuild' satisfies StatsOperationKind),\n  scope: z.strictObject({ userId: userIdSchema.optional() }),\n});\n\nexport const HallOfFameRebuildOperationSchema = z.strictObject({\n  ...rebuildFields,\n  kind: z.literal('hallOfFameRebuild' satisfies StatsOperationKind),\n  scope: z.strictObject({ sportKey: sportKeySchema, userId: userIdSchema.optional() }),\n});\n\nexport const StatsValidationOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('statsValidation' satisfies StatsOperationKind),\n  scope: StatsValidationScopeSchema,\n  phase: z.enum(STATS_VALIDATION_PHASE_KEYS),\n});\n\nexport const GameStatsCorrectionOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('gameStatsCorrection' satisfies StatsOperationKind),\n  scope: gameScope,\n  reason: repairReasonSchema,\n  requestHash: requestHashSchema.optional(),\n});\n\nexport const GameStatsRecalculationOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('gameStatsRecalculation' satisfies StatsOperationKind),\n  scope: gameScope,\n  reason: repairReasonSchema,\n});\n\nexport const HistoricalStatsUpdateOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('historicalStatsUpdate' satisfies StatsOperationKind),\n  scope: z.strictObject({ userId: userIdSchema, sportKey: sportKeySchema }),\n  reason: repairReasonSchema,\n  requestHash: requestHashSchema.optional(),\n});\n\nexport const GhostRemovedFinishedEntrySchema = z.strictObject({\n  gameId: gameIdSchema,\n  wasAbsent: z.boolean(),\n  wasNonScoring: z.boolean(),\n});\nexport type GhostRemovedFinishedEntry = z.infer<typeof GhostRemovedFinishedEntrySchema>;\n\nexport const GhostLinkedGameSchema = z.strictObject({\n  gameId: gameIdSchema,\n  completed: z.boolean(),\n  merged: z.boolean(),\n});\nexport type GhostLinkedGame = z.infer<typeof GhostLinkedGameSchema>;\n\nexport const StatsDestinationChangeSchema = z.strictObject({\n  ref: z.string().min(1),\n  field: z.string().min(1),\n  before: z.record(z.string(), z.number()).nullable(),\n  after: z.record(z.string(), z.number()).nullable(),\n});\nexport type StatsDestinationChange = z.infer<typeof StatsDestinationChangeSchema>;\n\nexport const GhostPlayerStatsOperationSchema = z\n  .strictObject({\n    ...operationBase,\n    kind: z.literal('ghostPlayerStats' satisfies StatsOperationKind),\n    scope: z.discriminatedUnion('action', [\n      z.strictObject({\n        action: z.literal('link' satisfies GhostStatsOperationAction),\n        teamId: teamIdSchema,\n        ghostUserId: userIdSchema,\n        userId: userIdSchema,\n      }),\n      z.strictObject({\n        action: z.literal('removal' satisfies GhostStatsOperationAction),\n        teamId: teamIdSchema,\n        ghostUserId: userIdSchema,\n      }),\n    ]),\n    // Present only on an operation stored with a reason. A removal's is dropped on read; a link's\n    // is kept, so its stored operation still resumes.\n    reason: repairReasonSchema.optional(),\n    removedFinishedGameEntries: z.array(GhostRemovedFinishedEntrySchema).optional(),\n    linkedGames: z.array(GhostLinkedGameSchema).optional(),\n    destinationChanges: z.array(StatsDestinationChangeSchema).optional(),\n    membershipOutcome: z.enum(GHOST_LINK_MEMBERSHIP_OUTCOME_KEYS).optional(),\n  })\n  .overwrite((operation) => {\n    if (operation.scope.action !== 'removal' || operation.reason === undefined) return operation;\n    const { reason: _reason, ...withoutReason } = operation;\n    return withoutReason;\n  });\nexport type GhostPlayerStatsOperation = z.infer<typeof GhostPlayerStatsOperationSchema>;\n\nexport const GameDeletionOperationSchema = z.strictObject({\n  ...operationBase,\n  kind: z.literal('gameDeletion' satisfies StatsOperationKind),\n  scope: gameScope,\n});\n\nexport const StatsOperationSchema = z.discriminatedUnion('kind', [\n  LeagueStatsRebuildOperationSchema,\n  LifetimeStatsRebuildOperationSchema,\n  HallOfFameRebuildOperationSchema,\n  StatsValidationOperationSchema,\n  GameStatsCorrectionOperationSchema,\n  GameStatsRecalculationOperationSchema,\n  HistoricalStatsUpdateOperationSchema,\n  GhostPlayerStatsOperationSchema,\n  GameDeletionOperationSchema,\n]);\nexport type StatsOperation = z.infer<typeof StatsOperationSchema>;\n"]}

package/dist/doc-schemas/status-reconcile-queue.d.ts

@@ -1,9 +1,4 @@
 import { z } from 'zod';
-/**
- * A status change's Auth effect, owed until it lands. `writeId` names the status change that wrote
- * it: a removal compares it, so finishing an older change never removes the entry a newer change
- * wrote. The drain converges the account on its canonical status, never on `targetStatus`.
- */
 export declare const StatusReconcileQueueAccountStatusEntrySchema: z.ZodObject<{
     authEffect: z.ZodLiteral<"accountStatus">;
     reason: z.ZodLiteral<"statusChangePending">;
@@ -17,7 +12,6 @@ export declare const StatusReconcileQueueAccountStatusEntrySchema: z.ZodObject<{
     attemptCount: z.ZodNumber;
 }, z.core.$strict>;
 export type StatusReconcileQueueAccountStatusEntry = z.infer<typeof StatusReconcileQueueAccountStatusEntrySchema>;
-/** A failed `admin` / `referee` claim write. It carries no status. */
 export declare const StatusReconcileQueueRoleClaimsEntrySchema: z.ZodObject<{
     authEffect: z.ZodLiteral<"roleClaims">;
     reason: z.ZodLiteral<"postCommitAuthEffectFailed">;

package/dist/doc-schemas/status-reconcile-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status-reconcile-queue.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/status-reconcile-queue.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;GAIG;AACH,eAAO,MAAM,4CAA4C;;;;;;;;;;;kBAMvD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,yCAAyC;;;;;;kBAIpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;kCAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}
+{"version":3,"file":"status-reconcile-queue.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/status-reconcile-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,eAAO,MAAM,4CAA4C;;;;;;;;;;;kBAMvD,CAAC;AACH,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAC1D,OAAO,4CAA4C,CACpD,CAAC;AAEF,eAAO,MAAM,yCAAyC;;;;;;kBAIpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CACvD,OAAO,yCAAyC,CACjD,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;kCAG1C,CAAC;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC"}

package/dist/doc-schemas/status-reconcile-queue.js

@@ -1,10 +1,3 @@
-// `statusReconcileQueue/{userId}` — the backend-only retry queue for an account's post-commit
-// Firebase Auth effects (RULE-STD-QUALITY-104, RULE-STD-BACKEND-302). One entry per account, id = the userId, whichever
-// effect queued it. A status change writes its entry in the status transaction itself; a role-claim
-// entry is written when a roster change committed but its claim write failed. The drain re-converges
-// every Auth-side mirror of the account from its canonical documents and deletes the entry once it
-// has, so the entry names why the account was queued, never what to apply. Only the retry ledger
-// (`attemptCount`, `lastAttemptAt`) is written back.
 import { z } from 'zod';
 import { ACCOUNT_STATUS_AUTH_EFFECT, ROLE_CLAIMS_EFFECT } from '../types/unions.js';
 import { countSchema, documentIdSegmentSchema, epochMsSchema, userStatusSchema } from './atoms.js';
@@ -13,11 +6,6 @@ const statusReconcileQueueEntryBase = {
     lastAttemptAt: epochMsSchema.optional(),
     attemptCount: countSchema,
 };
-/**
- * A status change's Auth effect, owed until it lands. `writeId` names the status change that wrote
- * it: a removal compares it, so finishing an older change never removes the entry a newer change
- * wrote. The drain converges the account on its canonical status, never on `targetStatus`.
- */
 export const StatusReconcileQueueAccountStatusEntrySchema = z.strictObject({
     ...statusReconcileQueueEntryBase,
     authEffect: z.literal(ACCOUNT_STATUS_AUTH_EFFECT),
@@ -25,7 +13,6 @@ export const StatusReconcileQueueAccountStatusEntrySchema = z.strictObject({
     targetStatus: userStatusSchema,
     writeId: documentIdSegmentSchema,
 });
-/** A failed `admin` / `referee` claim write. It carries no status. */
 export const StatusReconcileQueueRoleClaimsEntrySchema = z.strictObject({
     ...statusReconcileQueueEntryBase,
     authEffect: z.literal(ROLE_CLAIMS_EFFECT),

package/dist/doc-schemas/status-reconcile-queue.js.map

@@ -1 +1 @@
-{"version":3,"file":"status-reconcile-queue.js","sourceRoot":"","sources":["../../src/doc-schemas/status-reconcile-queue.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wHAAwH;AACxH,oGAAoG;AACpG,qGAAqG;AACrG,mGAAmG;AACnG,iGAAiG;AACjG,qDAAqD;AAErD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnG,MAAM,6BAA6B,GAAG;IACpC,UAAU,EAAE,aAAa;IACzB,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,WAAW;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,CAAC,YAAY,CAAC;IACzE,GAAG,6BAA6B;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IACxC,YAAY,EAAE,gBAAgB;IAC9B,OAAO,EAAE,uBAAuB;CACjC,CAAC,CAAC;AAKH,sEAAsE;AACtE,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC,YAAY,CAAC;IACtE,GAAG,6BAA6B;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC;CAChD,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE;IAChF,4CAA4C;IAC5C,yCAAyC;CAC1C,CAAC,CAAC","sourcesContent":["// `statusReconcileQueue/{userId}` — the backend-only retry queue for an account's post-commit\n// Firebase Auth effects (RULE-STD-QUALITY-104, RULE-STD-BACKEND-302). One entry per account, id = the userId, whichever\n// effect queued it. A status change writes its entry in the status transaction itself; a role-claim\n// entry is written when a roster change committed but its claim write failed. The drain re-converges\n// every Auth-side mirror of the account from its canonical documents and deletes the entry once it\n// has, so the entry names why the account was queued, never what to apply. Only the retry ledger\n// (`attemptCount`, `lastAttemptAt`) is written back.\n\nimport { z } from 'zod';\nimport { ACCOUNT_STATUS_AUTH_EFFECT, ROLE_CLAIMS_EFFECT } from '../types/unions.js';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema, userStatusSchema } from './atoms.js';\n\nconst statusReconcileQueueEntryBase = {\n  enqueuedAt: epochMsSchema,\n  lastAttemptAt: epochMsSchema.optional(),\n  attemptCount: countSchema,\n};\n\n/**\n * A status change's Auth effect, owed until it lands. `writeId` names the status change that wrote\n * it: a removal compares it, so finishing an older change never removes the entry a newer change\n * wrote. The drain converges the account on its canonical status, never on `targetStatus`.\n */\nexport const StatusReconcileQueueAccountStatusEntrySchema = z.strictObject({\n  ...statusReconcileQueueEntryBase,\n  authEffect: z.literal(ACCOUNT_STATUS_AUTH_EFFECT),\n  reason: z.literal('statusChangePending'),\n  targetStatus: userStatusSchema,\n  writeId: documentIdSegmentSchema,\n});\nexport type StatusReconcileQueueAccountStatusEntry = z.infer<\n  typeof StatusReconcileQueueAccountStatusEntrySchema\n>;\n\n/** A failed `admin` / `referee` claim write. It carries no status. */\nexport const StatusReconcileQueueRoleClaimsEntrySchema = z.strictObject({\n  ...statusReconcileQueueEntryBase,\n  authEffect: z.literal(ROLE_CLAIMS_EFFECT),\n  reason: z.literal('postCommitAuthEffectFailed'),\n});\nexport type StatusReconcileQueueRoleClaimsEntry = z.infer<\n  typeof StatusReconcileQueueRoleClaimsEntrySchema\n>;\n\nexport const StatusReconcileQueueEntrySchema = z.discriminatedUnion('authEffect', [\n  StatusReconcileQueueAccountStatusEntrySchema,\n  StatusReconcileQueueRoleClaimsEntrySchema,\n]);\nexport type StatusReconcileQueueEntry = z.infer<typeof StatusReconcileQueueEntrySchema>;\n"]}
+{"version":3,"file":"status-reconcile-queue.js","sourceRoot":"","sources":["../../src/doc-schemas/status-reconcile-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnG,MAAM,6BAA6B,GAAG;IACpC,UAAU,EAAE,aAAa;IACzB,aAAa,EAAE,aAAa,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,WAAW;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,CAAC,YAAY,CAAC;IACzE,GAAG,6BAA6B;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC;IACjD,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC;IACxC,YAAY,EAAE,gBAAgB;IAC9B,OAAO,EAAE,uBAAuB;CACjC,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC,YAAY,CAAC;IACtE,GAAG,6BAA6B;IAChC,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAAC;IACzC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,4BAA4B,CAAC;CAChD,CAAC,CAAC;AAKH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,kBAAkB,CAAC,YAAY,EAAE;IAChF,4CAA4C;IAC5C,yCAAyC;CAC1C,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { ACCOUNT_STATUS_AUTH_EFFECT, ROLE_CLAIMS_EFFECT } from '../types/unions.js';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema, userStatusSchema } from './atoms.js';\n\nconst statusReconcileQueueEntryBase = {\n  enqueuedAt: epochMsSchema,\n  lastAttemptAt: epochMsSchema.optional(),\n  attemptCount: countSchema,\n};\n\nexport const StatusReconcileQueueAccountStatusEntrySchema = z.strictObject({\n  ...statusReconcileQueueEntryBase,\n  authEffect: z.literal(ACCOUNT_STATUS_AUTH_EFFECT),\n  reason: z.literal('statusChangePending'),\n  targetStatus: userStatusSchema,\n  writeId: documentIdSegmentSchema,\n});\nexport type StatusReconcileQueueAccountStatusEntry = z.infer<\n  typeof StatusReconcileQueueAccountStatusEntrySchema\n>;\n\nexport const StatusReconcileQueueRoleClaimsEntrySchema = z.strictObject({\n  ...statusReconcileQueueEntryBase,\n  authEffect: z.literal(ROLE_CLAIMS_EFFECT),\n  reason: z.literal('postCommitAuthEffectFailed'),\n});\nexport type StatusReconcileQueueRoleClaimsEntry = z.infer<\n  typeof StatusReconcileQueueRoleClaimsEntrySchema\n>;\n\nexport const StatusReconcileQueueEntrySchema = z.discriminatedUnion('authEffect', [\n  StatusReconcileQueueAccountStatusEntrySchema,\n  StatusReconcileQueueRoleClaimsEntrySchema,\n]);\nexport type StatusReconcileQueueEntry = z.infer<typeof StatusReconcileQueueEntrySchema>;\n"]}

package/dist/doc-schemas/sweep-state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sweep-state.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/sweep-state.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,wBAAwB;;;;;;;;;6BA0BjC,CAAC;AACL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAI1E,eAAO,MAAM,sBAAsB;;;;;kBASxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,sBAAsB;;;kBAKxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;iBAsBzB,CAAC;AACL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"sweep-state.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/sweep-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,wBAAwB;;;;;;;;;6BA0BjC,CAAC;AACL,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,eAAO,MAAM,sBAAsB;;;;;kBAOxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAItE,eAAO,MAAM,sBAAsB;;;kBAKxB,CAAC;AACZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;iBAoBzB,CAAC;AACL,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/doc-schemas/sweep-state.js

@@ -1,18 +1,8 @@
-// `sweepState/{sweepName}` — where a scheduled pass over a bounded, ordered source keeps its
-// position (RULE-STD-BACKEND-112), one document per `SWEEP_STATE_NAMES` name. Backend-only: no client reads
-// or writes it.
 import { z } from 'zod';
 import { SWEEP_STATE_MAX_DEFERRED } from '../constants/scheduled-jobs.js';
 import { epochMsSchema } from './atoms.js';
-// Where a pass stands in its source.
-//   absent — no lap has run: the next pass starts one at the beginning.
-//   inLap  — the next page starts strictly after the last row the lap moved past. `afterKey` is
-//            that row's document id; `afterValue` is its value of the numeric field the query
-//            orders by first, when it orders by one. The query orders by the field and then by the
-//            key and resumes after both, never `field > value`, which skips every row tied with it.
-//   done   — the last lap reached the end of its source. The pass that exhausted it records that
-//            here rather than starting page one again in the same run; the next pass starts a new
-//            lap, so rows added behind the cursor are reached on the next lap.
+// The query orders by the field and then by the key and resumes after both, never
+// `field > value`, which skips every row tied with it.
 export const SweepRollingCursorSchema = z
     .discriminatedUnion('state', [
     z
@@ -40,20 +30,16 @@ export const SweepRollingCursorSchema = z
         });
     }
 });
-// A row the cursor moved past without clearing it (a failed read or write). The pass retries it from
-// here once it is due instead of stopping at it, so one failing row never pins the window (RULE-STD-BACKEND-309).
 export const SweepDeferredRowSchema = z
     .object({
     key: z.string().min(1),
     value: z.number().optional(),
-    /** Epoch ms from which a pass may retry it. */
     nextAttemptAt: epochMsSchema,
-    /** Passes that examined it without clearing it; the pass that deferred it is the first. */
     attemptCount: z.number().int().positive(),
 })
     .strict();
-// Where a weekly full sign-in account scan stands in its lap. Firebase Auth lists accounts only by
-// page token, with no key to resume after; a token it no longer accepts restarts the lap.
+// Firebase Auth lists accounts only by page token, with no key to resume after; a token it no
+// longer accepts restarts the lap.
 export const SweepAuthScanLapSchema = z
     .object({
     pageToken: z.string().min(1),
@@ -62,9 +48,7 @@ export const SweepAuthScanLapSchema = z
     .strict();
 export const SweepStateSchema = z
     .object({
-    /** Wall-clock ms the last full sign-in account scan reached the end of its lap (absent = never). */
     fullScanLastRunAt: epochMsSchema.optional(),
-    /** The full scan's lap in progress; absent between laps. */
     fullScanLap: SweepAuthScanLapSchema.optional(),
     rollingCursor: SweepRollingCursorSchema.optional(),
     deferred: z.array(SweepDeferredRowSchema).max(SWEEP_STATE_MAX_DEFERRED).optional(),

package/dist/doc-schemas/sweep-state.js.map

@@ -1 +1 @@
-{"version":3,"file":"sweep-state.js","sourceRoot":"","sources":["../../src/doc-schemas/sweep-state.ts"],"names":[],"mappings":"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","sourcesContent":["// `sweepState/{sweepName}` — where a scheduled pass over a bounded, ordered source keeps its\n// position (RULE-STD-BACKEND-112), one document per `SWEEP_STATE_NAMES` name. Backend-only: no client reads\n// or writes it.\n\nimport { z } from 'zod';\nimport { SWEEP_STATE_MAX_DEFERRED } from '../constants/scheduled-jobs.js';\nimport { epochMsSchema } from './atoms.js';\n\n// Where a pass stands in its source.\n//   absent — no lap has run: the next pass starts one at the beginning.\n//   inLap  — the next page starts strictly after the last row the lap moved past. `afterKey` is\n//            that row's document id; `afterValue` is its value of the numeric field the query\n//            orders by first, when it orders by one. The query orders by the field and then by the\n//            key and resumes after both, never `field > value`, which skips every row tied with it.\n//   done   — the last lap reached the end of its source. The pass that exhausted it records that\n//            here rather than starting page one again in the same run; the next pass starts a new\n//            lap, so rows added behind the cursor are reached on the next lap.\nexport const SweepRollingCursorSchema = z\n  .discriminatedUnion('state', [\n    z\n      .object({\n        state: z.literal('inLap'),\n        afterKey: z.string().min(1),\n        afterValue: z.number().optional(),\n        lapStartedAt: epochMsSchema,\n      })\n      .strict(),\n    z\n      .object({\n        state: z.literal('done'),\n        lapStartedAt: epochMsSchema,\n        lapCompletedAt: epochMsSchema,\n      })\n      .strict(),\n  ])\n  .superRefine((value, ctx) => {\n    if (value.state === 'done' && value.lapCompletedAt < value.lapStartedAt) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['lapCompletedAt'],\n        message: 'a lap completes no earlier than it started',\n      });\n    }\n  });\nexport type SweepRollingCursor = z.infer<typeof SweepRollingCursorSchema>;\n\n// A row the cursor moved past without clearing it (a failed read or write). The pass retries it from\n// here once it is due instead of stopping at it, so one failing row never pins the window (RULE-STD-BACKEND-309).\nexport const SweepDeferredRowSchema = z\n  .object({\n    key: z.string().min(1),\n    value: z.number().optional(),\n    /** Epoch ms from which a pass may retry it. */\n    nextAttemptAt: epochMsSchema,\n    /** Passes that examined it without clearing it; the pass that deferred it is the first. */\n    attemptCount: z.number().int().positive(),\n  })\n  .strict();\nexport type SweepDeferredRow = z.infer<typeof SweepDeferredRowSchema>;\n\n// Where a weekly full sign-in account scan stands in its lap. Firebase Auth lists accounts only by\n// page token, with no key to resume after; a token it no longer accepts restarts the lap.\nexport const SweepAuthScanLapSchema = z\n  .object({\n    pageToken: z.string().min(1),\n    lapStartedAt: epochMsSchema,\n  })\n  .strict();\nexport type SweepAuthScanLap = z.infer<typeof SweepAuthScanLapSchema>;\n\nexport const SweepStateSchema = z\n  .object({\n    /** Wall-clock ms the last full sign-in account scan reached the end of its lap (absent = never). */\n    fullScanLastRunAt: epochMsSchema.optional(),\n    /** The full scan's lap in progress; absent between laps. */\n    fullScanLap: SweepAuthScanLapSchema.optional(),\n    rollingCursor: SweepRollingCursorSchema.optional(),\n    deferred: z.array(SweepDeferredRowSchema).max(SWEEP_STATE_MAX_DEFERRED).optional(),\n    updatedAt: epochMsSchema,\n  })\n  .superRefine((value, ctx) => {\n    const seen = new Set<string>();\n    (value.deferred ?? []).forEach((row, index) => {\n      if (seen.has(row.key)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['deferred', index, 'key'],\n          message: 'a row is deferred at most once',\n        });\n      }\n      seen.add(row.key);\n    });\n  });\nexport type SweepState = z.infer<typeof SweepStateSchema>;\n"]}
+{"version":3,"file":"sweep-state.js","sourceRoot":"","sources":["../../src/doc-schemas/sweep-state.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport { SWEEP_STATE_MAX_DEFERRED } from '../constants/scheduled-jobs.js';\nimport { epochMsSchema } from './atoms.js';\n\n// The query orders by the field and then by the key and resumes after both, never\n// `field > value`, which skips every row tied with it.\nexport const SweepRollingCursorSchema = z\n  .discriminatedUnion('state', [\n    z\n      .object({\n        state: z.literal('inLap'),\n        afterKey: z.string().min(1),\n        afterValue: z.number().optional(),\n        lapStartedAt: epochMsSchema,\n      })\n      .strict(),\n    z\n      .object({\n        state: z.literal('done'),\n        lapStartedAt: epochMsSchema,\n        lapCompletedAt: epochMsSchema,\n      })\n      .strict(),\n  ])\n  .superRefine((value, ctx) => {\n    if (value.state === 'done' && value.lapCompletedAt < value.lapStartedAt) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['lapCompletedAt'],\n        message: 'a lap completes no earlier than it started',\n      });\n    }\n  });\nexport type SweepRollingCursor = z.infer<typeof SweepRollingCursorSchema>;\n\nexport const SweepDeferredRowSchema = z\n  .object({\n    key: z.string().min(1),\n    value: z.number().optional(),\n    nextAttemptAt: epochMsSchema,\n    attemptCount: z.number().int().positive(),\n  })\n  .strict();\nexport type SweepDeferredRow = z.infer<typeof SweepDeferredRowSchema>;\n\n// Firebase Auth lists accounts only by page token, with no key to resume after; a token it no\n// longer accepts restarts the lap.\nexport const SweepAuthScanLapSchema = z\n  .object({\n    pageToken: z.string().min(1),\n    lapStartedAt: epochMsSchema,\n  })\n  .strict();\nexport type SweepAuthScanLap = z.infer<typeof SweepAuthScanLapSchema>;\n\nexport const SweepStateSchema = z\n  .object({\n    fullScanLastRunAt: epochMsSchema.optional(),\n    fullScanLap: SweepAuthScanLapSchema.optional(),\n    rollingCursor: SweepRollingCursorSchema.optional(),\n    deferred: z.array(SweepDeferredRowSchema).max(SWEEP_STATE_MAX_DEFERRED).optional(),\n    updatedAt: epochMsSchema,\n  })\n  .superRefine((value, ctx) => {\n    const seen = new Set<string>();\n    (value.deferred ?? []).forEach((row, index) => {\n      if (seen.has(row.key)) {\n        ctx.addIssue({\n          code: 'custom',\n          path: ['deferred', index, 'key'],\n          message: 'a row is deferred at most once',\n        });\n      }\n      seen.add(row.key);\n    });\n  });\nexport type SweepState = z.infer<typeof SweepStateSchema>;\n"]}

package/dist/doc-schemas/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/system.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA4BxB,eAAO,MAAM,eAAe;;;;;;iBAS1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAIxD,eAAO,MAAM,uBAAuB;;;;;;;;;iBAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAS5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAK5D,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAMxD,eAAO,MAAM,8BAA8B,2IAMzC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAUjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;kBAKpC,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,4BAA4B;;;;;;kBAMvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAYtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,eAAO,MAAM,eAAe;;;;;;iBAO1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,uBAAuB;;;;;;;;;iBAKlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;iBAS5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,eAAO,MAAM,8BAA8B,2IAMzC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;kBAQjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,0BAA0B;;;kBAKpC,CAAC;AACJ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,4BAA4B;;;;;;kBAMvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAUtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/doc-schemas/system.js

@@ -1,58 +1,36 @@
-// Fixed-ID system documents in the underscore buckets, plus the derived stat documents. Every one
-// is callable-only for writes.
 import { z } from 'zod';
 import { MAX_ANNOUNCEMENT_MESSAGE_LENGTH, MAX_APP_VERSION_LENGTH, MAX_LANDING_ABOUT_TEXT_LENGTH, MAX_LANDING_HERO_TITLE_LENGTH, MAX_MAINTENANCE_MESSAGE_LENGTH, } from '../constants/business.js';
 import { MAX_STATS_VALIDATION_DISCREPANCIES } from '../constants/sports.js';
 import { GallerySummarySchema } from './gallery.js';
 import { countSchema, documentIdSegmentSchema, epochMsSchema, gameIdSchema, leagueIdSchema, statsBeaconActionSchema, statsDiscrepancyKindSchema, statsOperationIdSchema, teamIdSchema, userIdSchema, } from './atoms.js';
-// `_appConfig/app` — the app-wide operational levers, set through the audited updateAppConfig
-// callable. `appVersion` is what a live client compares itself against to force a refresh. It is
-// written whole through `mergeAppConfigUpdate` and read one lever at a time through
-// `readAppConfigLever` (../utils/app-config.ts). Every text lever carries the same cap as its
-// updateAppConfig input field, so no writer can store a value the input would refuse.
 export const AppConfigSchema = z.object({
     // `''` is valid here — no version published yet; only the update input requires a value.
     appVersion: z.string().max(MAX_APP_VERSION_LENGTH),
     maintenanceMode: z.boolean(),
     maintenanceMessage: z.string().max(MAX_MAINTENANCE_MESSAGE_LENGTH).optional(),
     registrationEnabled: z.boolean(),
-    // Empty means no banner — there is no separate on/off flag. Non-empty is the band above every
-    // page.
     announcementMessage: z.string().max(MAX_ANNOUNCEMENT_MESSAGE_LENGTH).optional(),
 });
-// `_appConfig/landingPage` — admin-authored landing page copy, written by adminUpdateLandingPage,
-// plus the landing gallery's summary, which only the picture core writes.
 export const LandingPageConfigSchema = z.object({
     heroTitle: z.string().max(MAX_LANDING_HERO_TITLE_LENGTH),
     aboutCompany: z.string().max(MAX_LANDING_ABOUT_TEXT_LENGTH),
     pictures: GallerySummarySchema.optional(),
     updatedAt: epochMsSchema,
 });
-// `_appConfig/statsBeacon` — the signal watching clients refresh their stats on, replaced whole by
-// every write. The scope ids say what changed; an action that spans more than one game or league
-// omits them, and because every write replaces the document, an omitted id never survives from an
-// earlier write.
 export const StatsBeaconSchema = z.object({
     updatedAt: epochMsSchema,
     // A fresh document id minted by every write, so two commits in the same millisecond still move
-    // the beacon. Absent on a beacon stored before writes carried one.
+    // the beacon.
     changeId: documentIdSegmentSchema.optional(),
     action: statsBeaconActionSchema,
     leagueId: leagueIdSchema.optional(),
     gameId: gameIdSchema.optional(),
     teamIds: z.array(teamIdSchema).optional(),
 });
-// `_systemData/adminList` — the admin and referee rosters. The source of truth the `admin` and
-// `referee` custom claims are minted from, written only by the audited updateAdminList callable;
-// the first admin of a fresh environment is seeded in the console.
 export const AdminListSchema = z.object({
     admins: z.array(userIdSchema),
     referees: z.array(userIdSchema),
 });
-// `statsValidationReports/{reportId}` — one stats check: every place a game's stored numbers, or a
-// derived aggregate, disagree with what the game's events and the completed games say they should
-// be. Its id is the check's operation id, which the admin's browser mints, so two checks never share
-// a report. Written only by the check, page by page; `complete` turns true with its last page.
 export const STATS_DISCREPANCY_VALUE_SCHEMA = z.union([
     z.number(),
     z.string(),
@@ -63,9 +41,7 @@ export const STATS_DISCREPANCY_VALUE_SCHEMA = z.union([
 export const StatsDiscrepancySchema = z.strictObject({
     kind: statsDiscrepancyKindSchema,
     gameId: gameIdSchema.optional(),
-    // The slash path of the document the finding is about.
     path: z.string().min(1),
-    // The line or entry within it — a team id, a roster-entry id, a user id — when there is one.
     key: z.string().min(1).optional(),
     field: z.string().min(1).optional(),
     expected: STATS_DISCREPANCY_VALUE_SCHEMA.optional(),
@@ -88,9 +64,7 @@ export const StatsValidationReportSchema = z.strictObject({
     ranByUserId: userIdSchema,
     scope: StatsValidationScopeSchema,
     complete: z.boolean(),
-    // Game-tier findings first, then aggregate ones, at most MAX_STATS_VALIDATION_DISCREPANCIES.
     discrepancies: z.array(StatsDiscrepancySchema).max(MAX_STATS_VALIDATION_DISCREPANCIES),
-    // Every finding, kept or not, counted by kind.
     discrepancyCounts: z.partialRecord(statsDiscrepancyKindSchema, countSchema),
     summary: StatsValidationSummarySchema,
 });

package/dist/doc-schemas/system.js.map

@@ -1 +1 @@
-{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/doc-schemas/system.ts"],"names":[],"mappings":"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","sourcesContent":["// Fixed-ID system documents in the underscore buckets, plus the derived stat documents. Every one\n// is callable-only for writes.\n\nimport { z } from 'zod';\nimport {\n  MAX_ANNOUNCEMENT_MESSAGE_LENGTH,\n  MAX_APP_VERSION_LENGTH,\n  MAX_LANDING_ABOUT_TEXT_LENGTH,\n  MAX_LANDING_HERO_TITLE_LENGTH,\n  MAX_MAINTENANCE_MESSAGE_LENGTH,\n} from '../constants/business.js';\nimport { MAX_STATS_VALIDATION_DISCREPANCIES } from '../constants/sports.js';\nimport { GallerySummarySchema } from './gallery.js';\nimport {\n  countSchema,\n  documentIdSegmentSchema,\n  epochMsSchema,\n  gameIdSchema,\n  leagueIdSchema,\n  statsBeaconActionSchema,\n  statsDiscrepancyKindSchema,\n  statsOperationIdSchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\n\n// `_appConfig/app` — the app-wide operational levers, set through the audited updateAppConfig\n// callable. `appVersion` is what a live client compares itself against to force a refresh. It is\n// written whole through `mergeAppConfigUpdate` and read one lever at a time through\n// `readAppConfigLever` (../utils/app-config.ts). Every text lever carries the same cap as its\n// updateAppConfig input field, so no writer can store a value the input would refuse.\nexport const AppConfigSchema = z.object({\n  // `''` is valid here — no version published yet; only the update input requires a value.\n  appVersion: z.string().max(MAX_APP_VERSION_LENGTH),\n  maintenanceMode: z.boolean(),\n  maintenanceMessage: z.string().max(MAX_MAINTENANCE_MESSAGE_LENGTH).optional(),\n  registrationEnabled: z.boolean(),\n  // Empty means no banner — there is no separate on/off flag. Non-empty is the band above every\n  // page.\n  announcementMessage: z.string().max(MAX_ANNOUNCEMENT_MESSAGE_LENGTH).optional(),\n});\nexport type AppConfig = z.infer<typeof AppConfigSchema>;\n\n// `_appConfig/landingPage` — admin-authored landing page copy, written by adminUpdateLandingPage,\n// plus the landing gallery's summary, which only the picture core writes.\nexport const LandingPageConfigSchema = z.object({\n  heroTitle: z.string().max(MAX_LANDING_HERO_TITLE_LENGTH),\n  aboutCompany: z.string().max(MAX_LANDING_ABOUT_TEXT_LENGTH),\n  pictures: GallerySummarySchema.optional(),\n  updatedAt: epochMsSchema,\n});\nexport type LandingPageConfig = z.infer<typeof LandingPageConfigSchema>;\n\n// `_appConfig/statsBeacon` — the signal watching clients refresh their stats on, replaced whole by\n// every write. The scope ids say what changed; an action that spans more than one game or league\n// omits them, and because every write replaces the document, an omitted id never survives from an\n// earlier write.\nexport const StatsBeaconSchema = z.object({\n  updatedAt: epochMsSchema,\n  // A fresh document id minted by every write, so two commits in the same millisecond still move\n  // the beacon. Absent on a beacon stored before writes carried one.\n  changeId: documentIdSegmentSchema.optional(),\n  action: statsBeaconActionSchema,\n  leagueId: leagueIdSchema.optional(),\n  gameId: gameIdSchema.optional(),\n  teamIds: z.array(teamIdSchema).optional(),\n});\nexport type StatsBeacon = z.infer<typeof StatsBeaconSchema>;\n\n// `_systemData/adminList` — the admin and referee rosters. The source of truth the `admin` and\n// `referee` custom claims are minted from, written only by the audited updateAdminList callable;\n// the first admin of a fresh environment is seeded in the console.\nexport const AdminListSchema = z.object({\n  admins: z.array(userIdSchema),\n  referees: z.array(userIdSchema),\n});\nexport type AdminList = z.infer<typeof AdminListSchema>;\n\n// `statsValidationReports/{reportId}` — one stats check: every place a game's stored numbers, or a\n// derived aggregate, disagree with what the game's events and the completed games say they should\n// be. Its id is the check's operation id, which the admin's browser mints, so two checks never share\n// a report. Written only by the check, page by page; `complete` turns true with its last page.\nexport const STATS_DISCREPANCY_VALUE_SCHEMA = z.union([\n  z.number(),\n  z.string(),\n  z.array(z.number().nullable()),\n  z.record(z.string(), z.number()),\n  z.null(),\n]);\n\nexport const StatsDiscrepancySchema = z.strictObject({\n  kind: statsDiscrepancyKindSchema,\n  gameId: gameIdSchema.optional(),\n  // The slash path of the document the finding is about.\n  path: z.string().min(1),\n  // The line or entry within it — a team id, a roster-entry id, a user id — when there is one.\n  key: z.string().min(1).optional(),\n  field: z.string().min(1).optional(),\n  expected: STATS_DISCREPANCY_VALUE_SCHEMA.optional(),\n  actual: STATS_DISCREPANCY_VALUE_SCHEMA.optional(),\n});\nexport type StatsDiscrepancy = z.infer<typeof StatsDiscrepancySchema>;\n\nexport const StatsValidationScopeSchema = z\n  .strictObject({ gameId: gameIdSchema.optional(), leagueId: leagueIdSchema.optional() })\n  .refine(\n    (scope) => scope.gameId === undefined || scope.leagueId === undefined,\n    'One game or one league, not both.',\n  );\nexport type StatsValidationScope = z.infer<typeof StatsValidationScopeSchema>;\n\nexport const StatsValidationSummarySchema = z.strictObject({\n  totalGamesChecked: countSchema,\n  totalUsersChecked: countSchema,\n  totalTeamsChecked: countSchema,\n  totalLeaguesChecked: countSchema,\n  discrepanciesFound: countSchema,\n});\nexport type StatsValidationSummary = z.infer<typeof StatsValidationSummarySchema>;\n\nexport const StatsValidationReportSchema = z.strictObject({\n  reportId: z.string().min(1),\n  operationId: statsOperationIdSchema,\n  ranAt: epochMsSchema,\n  ranByUserId: userIdSchema,\n  scope: StatsValidationScopeSchema,\n  complete: z.boolean(),\n  // Game-tier findings first, then aggregate ones, at most MAX_STATS_VALIDATION_DISCREPANCIES.\n  discrepancies: z.array(StatsDiscrepancySchema).max(MAX_STATS_VALIDATION_DISCREPANCIES),\n  // Every finding, kept or not, counted by kind.\n  discrepancyCounts: z.partialRecord(statsDiscrepancyKindSchema, countSchema),\n  summary: StatsValidationSummarySchema,\n});\nexport type StatsValidationReport = z.infer<typeof StatsValidationReportSchema>;\n"]}
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/doc-schemas/system.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  MAX_ANNOUNCEMENT_MESSAGE_LENGTH,\n  MAX_APP_VERSION_LENGTH,\n  MAX_LANDING_ABOUT_TEXT_LENGTH,\n  MAX_LANDING_HERO_TITLE_LENGTH,\n  MAX_MAINTENANCE_MESSAGE_LENGTH,\n} from '../constants/business.js';\nimport { MAX_STATS_VALIDATION_DISCREPANCIES } from '../constants/sports.js';\nimport { GallerySummarySchema } from './gallery.js';\nimport {\n  countSchema,\n  documentIdSegmentSchema,\n  epochMsSchema,\n  gameIdSchema,\n  leagueIdSchema,\n  statsBeaconActionSchema,\n  statsDiscrepancyKindSchema,\n  statsOperationIdSchema,\n  teamIdSchema,\n  userIdSchema,\n} from './atoms.js';\n\nexport const AppConfigSchema = z.object({\n  // `''` is valid here — no version published yet; only the update input requires a value.\n  appVersion: z.string().max(MAX_APP_VERSION_LENGTH),\n  maintenanceMode: z.boolean(),\n  maintenanceMessage: z.string().max(MAX_MAINTENANCE_MESSAGE_LENGTH).optional(),\n  registrationEnabled: z.boolean(),\n  announcementMessage: z.string().max(MAX_ANNOUNCEMENT_MESSAGE_LENGTH).optional(),\n});\nexport type AppConfig = z.infer<typeof AppConfigSchema>;\n\nexport const LandingPageConfigSchema = z.object({\n  heroTitle: z.string().max(MAX_LANDING_HERO_TITLE_LENGTH),\n  aboutCompany: z.string().max(MAX_LANDING_ABOUT_TEXT_LENGTH),\n  pictures: GallerySummarySchema.optional(),\n  updatedAt: epochMsSchema,\n});\nexport type LandingPageConfig = z.infer<typeof LandingPageConfigSchema>;\n\nexport const StatsBeaconSchema = z.object({\n  updatedAt: epochMsSchema,\n  // A fresh document id minted by every write, so two commits in the same millisecond still move\n  // the beacon.\n  changeId: documentIdSegmentSchema.optional(),\n  action: statsBeaconActionSchema,\n  leagueId: leagueIdSchema.optional(),\n  gameId: gameIdSchema.optional(),\n  teamIds: z.array(teamIdSchema).optional(),\n});\nexport type StatsBeacon = z.infer<typeof StatsBeaconSchema>;\n\nexport const AdminListSchema = z.object({\n  admins: z.array(userIdSchema),\n  referees: z.array(userIdSchema),\n});\nexport type AdminList = z.infer<typeof AdminListSchema>;\n\nexport const STATS_DISCREPANCY_VALUE_SCHEMA = z.union([\n  z.number(),\n  z.string(),\n  z.array(z.number().nullable()),\n  z.record(z.string(), z.number()),\n  z.null(),\n]);\n\nexport const StatsDiscrepancySchema = z.strictObject({\n  kind: statsDiscrepancyKindSchema,\n  gameId: gameIdSchema.optional(),\n  path: z.string().min(1),\n  key: z.string().min(1).optional(),\n  field: z.string().min(1).optional(),\n  expected: STATS_DISCREPANCY_VALUE_SCHEMA.optional(),\n  actual: STATS_DISCREPANCY_VALUE_SCHEMA.optional(),\n});\nexport type StatsDiscrepancy = z.infer<typeof StatsDiscrepancySchema>;\n\nexport const StatsValidationScopeSchema = z\n  .strictObject({ gameId: gameIdSchema.optional(), leagueId: leagueIdSchema.optional() })\n  .refine(\n    (scope) => scope.gameId === undefined || scope.leagueId === undefined,\n    'One game or one league, not both.',\n  );\nexport type StatsValidationScope = z.infer<typeof StatsValidationScopeSchema>;\n\nexport const StatsValidationSummarySchema = z.strictObject({\n  totalGamesChecked: countSchema,\n  totalUsersChecked: countSchema,\n  totalTeamsChecked: countSchema,\n  totalLeaguesChecked: countSchema,\n  discrepanciesFound: countSchema,\n});\nexport type StatsValidationSummary = z.infer<typeof StatsValidationSummarySchema>;\n\nexport const StatsValidationReportSchema = z.strictObject({\n  reportId: z.string().min(1),\n  operationId: statsOperationIdSchema,\n  ranAt: epochMsSchema,\n  ranByUserId: userIdSchema,\n  scope: StatsValidationScopeSchema,\n  complete: z.boolean(),\n  discrepancies: z.array(StatsDiscrepancySchema).max(MAX_STATS_VALIDATION_DISCREPANCIES),\n  discrepancyCounts: z.partialRecord(statsDiscrepancyKindSchema, countSchema),\n  summary: StatsValidationSummarySchema,\n});\nexport type StatsValidationReport = z.infer<typeof StatsValidationReportSchema>;\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"team-membership.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/team-membership.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;iBAc/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;iBAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAGlE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAIpE,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"team-membership.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/team-membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;iBAS/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAOhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

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

@@ -1,9 +1,5 @@
-// The documents that put a user on a team: the membership itself and the three ways to reach one.
-// Every one of them stores user ids only — names resolve from `publicUsers` (RULE-STD-ARCH-103).
 import { z } from 'zod';
 import { epochMsSchema, teamJoinRequestStatusSchema, leagueIdSchema, teamIdSchema, teamInvitationStatusSchema, teamJoinMethodSchema, teamMembershipStatusSchema, teamRoleSchema, userIdSchema, } from './atoms.js';
-// `teamMemberships/{leagueId}_{teamId}_{userId}` — canonical membership and team role. The id is
-// load-bearing: rules and callables read a membership by id to decide captain authority.
 export const TeamMembershipSchema = z.object({
     leagueId: leagueIdSchema,
     teamId: teamIdSchema,
@@ -12,14 +8,11 @@ export const TeamMembershipSchema = z.object({
     status: teamMembershipStatusSchema,
     isGhost: z.boolean(),
     joinedVia: teamJoinMethodSchema.optional(),
-    // The invite this membership came from, when `joinedVia` is `invite`.
     teamInvitationId: z.string().optional(),
-    // The ghost id this real user's membership replaced, when a ghost was linked to them.
     linkedFromGhostUserId: z.string().optional(),
     joinedAt: epochMsSchema,
     updatedAt: epochMsSchema,
 });
-// `teamInvitations/{inviteId}` — a captain invites a user onto their team.
 export const TeamInvitationSchema = z.object({
     leagueId: leagueIdSchema,
     teamId: teamIdSchema,
@@ -30,7 +23,6 @@ export const TeamInvitationSchema = z.object({
     createdAt: epochMsSchema,
     respondedAt: epochMsSchema.optional(),
 });
-// `teamJoinRequests/{requestId}` — a player asks to join a team.
 export const TeamJoinRequestSchema = z.object({
     leagueId: leagueIdSchema,
     teamId: teamIdSchema,
@@ -39,8 +31,6 @@ export const TeamJoinRequestSchema = z.object({
     status: teamJoinRequestStatusSchema,
     createdAt: epochMsSchema,
 });
-// `leagueFreeAgents/{leagueId}_{userId}` — a player available for assignment in a league. The
-// document exists while the player is available and is deleted when they are placed or withdraw.
 export const LeagueFreeAgentSchema = z.object({
     leagueId: leagueIdSchema,
     userId: userIdSchema,

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

@@ -1 +1 @@
-{"version":3,"file":"team-membership.js","sourceRoot":"","sources":["../../src/doc-schemas/team-membership.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,iGAAiG;AAEjG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,cAAc,EACd,YAAY,EACZ,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,iGAAiG;AACjG,yFAAyF;AACzF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,0BAA0B;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,SAAS,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC1C,sEAAsE;IACtE,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,sFAAsF;IACtF,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,aAAa,EAAE,YAAY;IAC3B,eAAe,EAAE,YAAY;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,0BAA0B;IAClC,SAAS,EAAE,aAAa;IACxB,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAGH,iEAAiE;AACjE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,8FAA8F;AAC9F,iGAAiG;AACjG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC","sourcesContent":["// The documents that put a user on a team: the membership itself and the three ways to reach one.\n// Every one of them stores user ids only — names resolve from `publicUsers` (RULE-STD-ARCH-103).\n\nimport { z } from 'zod';\nimport {\n  epochMsSchema,\n  teamJoinRequestStatusSchema,\n  leagueIdSchema,\n  teamIdSchema,\n  teamInvitationStatusSchema,\n  teamJoinMethodSchema,\n  teamMembershipStatusSchema,\n  teamRoleSchema,\n  userIdSchema,\n} from './atoms.js';\n\n// `teamMemberships/{leagueId}_{teamId}_{userId}` — canonical membership and team role. The id is\n// load-bearing: rules and callables read a membership by id to decide captain authority.\nexport const TeamMembershipSchema = z.object({\n  leagueId: leagueIdSchema,\n  teamId: teamIdSchema,\n  userId: userIdSchema,\n  role: teamRoleSchema,\n  status: teamMembershipStatusSchema,\n  isGhost: z.boolean(),\n  joinedVia: teamJoinMethodSchema.optional(),\n  // The invite this membership came from, when `joinedVia` is `invite`.\n  teamInvitationId: z.string().optional(),\n  // The ghost id this real user's membership replaced, when a ghost was linked to them.\n  linkedFromGhostUserId: z.string().optional(),\n  joinedAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type TeamMembership = z.infer<typeof TeamMembershipSchema>;\n\n// `teamInvitations/{inviteId}` — a captain invites a user onto their team.\nexport const TeamInvitationSchema = z.object({\n  leagueId: leagueIdSchema,\n  teamId: teamIdSchema,\n  invitedUserId: userIdSchema,\n  invitedByUserId: userIdSchema,\n  message: z.string(),\n  status: teamInvitationStatusSchema,\n  createdAt: epochMsSchema,\n  respondedAt: epochMsSchema.optional(),\n});\nexport type TeamInvitation = z.infer<typeof TeamInvitationSchema>;\n\n// `teamJoinRequests/{requestId}` — a player asks to join a team.\nexport const TeamJoinRequestSchema = z.object({\n  leagueId: leagueIdSchema,\n  teamId: teamIdSchema,\n  userId: userIdSchema,\n  message: z.string(),\n  status: teamJoinRequestStatusSchema,\n  createdAt: epochMsSchema,\n});\nexport type TeamJoinRequest = z.infer<typeof TeamJoinRequestSchema>;\n\n// `leagueFreeAgents/{leagueId}_{userId}` — a player available for assignment in a league. The\n// document exists while the player is available and is deleted when they are placed or withdraw.\nexport const LeagueFreeAgentSchema = z.object({\n  leagueId: leagueIdSchema,\n  userId: userIdSchema,\n  createdAt: epochMsSchema,\n});\nexport type LeagueFreeAgent = z.infer<typeof LeagueFreeAgentSchema>;\n"]}
+{"version":3,"file":"team-membership.js","sourceRoot":"","sources":["../../src/doc-schemas/team-membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,cAAc,EACd,YAAY,EACZ,0BAA0B,EAC1B,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,0BAA0B;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,SAAS,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IAC1C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5C,QAAQ,EAAE,aAAa;IACvB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,aAAa,EAAE,YAAY;IAC3B,eAAe,EAAE,YAAY;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,0BAA0B;IAClC,SAAS,EAAE,aAAa;IACxB,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  epochMsSchema,\n  teamJoinRequestStatusSchema,\n  leagueIdSchema,\n  teamIdSchema,\n  teamInvitationStatusSchema,\n  teamJoinMethodSchema,\n  teamMembershipStatusSchema,\n  teamRoleSchema,\n  userIdSchema,\n} from './atoms.js';\n\nexport const TeamMembershipSchema = z.object({\n  leagueId: leagueIdSchema,\n  teamId: teamIdSchema,\n  userId: userIdSchema,\n  role: teamRoleSchema,\n  status: teamMembershipStatusSchema,\n  isGhost: z.boolean(),\n  joinedVia: teamJoinMethodSchema.optional(),\n  teamInvitationId: z.string().optional(),\n  linkedFromGhostUserId: z.string().optional(),\n  joinedAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type TeamMembership = z.infer<typeof TeamMembershipSchema>;\n\nexport const TeamInvitationSchema = z.object({\n  leagueId: leagueIdSchema,\n  teamId: teamIdSchema,\n  invitedUserId: userIdSchema,\n  invitedByUserId: userIdSchema,\n  message: z.string(),\n  status: teamInvitationStatusSchema,\n  createdAt: epochMsSchema,\n  respondedAt: epochMsSchema.optional(),\n});\nexport type TeamInvitation = z.infer<typeof TeamInvitationSchema>;\n\nexport const TeamJoinRequestSchema = z.object({\n  leagueId: leagueIdSchema,\n  teamId: teamIdSchema,\n  userId: userIdSchema,\n  message: z.string(),\n  status: teamJoinRequestStatusSchema,\n  createdAt: epochMsSchema,\n});\nexport type TeamJoinRequest = z.infer<typeof TeamJoinRequestSchema>;\n\nexport const LeagueFreeAgentSchema = z.object({\n  leagueId: leagueIdSchema,\n  userId: userIdSchema,\n  createdAt: epochMsSchema,\n});\nexport type LeagueFreeAgent = z.infer<typeof LeagueFreeAgentSchema>;\n"]}

package/dist/doc-schemas/user-profile.d.ts

@@ -62,6 +62,5 @@ export declare const HistoricalStatsSchema: z.ZodObject<{
     gamesPlayed: z.ZodNumber;
 }, z.core.$strict>;
 export type HistoricalStats = z.infer<typeof HistoricalStatsSchema>;
-/** A baseline's totals, in the order an admin enters them. */
 export declare const HISTORICAL_STAT_KEYS: readonly (keyof HistoricalStats)[];
 //# sourceMappingURL=user-profile.d.ts.map

package/dist/doc-schemas/user-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/user-profile.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,eAAe;;;;EAAsB,CAAC;AAGnD,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAiBhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAMpE,eAAO,MAAM,qBAAqB;;;;;kBAA6D,CAAC;AAChG,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAWpE,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,EAE5B,SAAS,CAAC,MAAM,eAAe,CAAC,EAAE,CAAC"}
+{"version":3,"file":"user-profile.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/user-profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,eAAe;;;;EAAsB,CAAC;AAEnD,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAU5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAQhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,qBAAqB;;;;;kBAA6D,CAAC;AAChG,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AASpE,eAAO,MAAM,oBAAoB,EAE5B,SAAS,CAAC,MAAM,eAAe,CAAC,EAAE,CAAC"}