@ttt-productions/q-core 0.1.28 → 0.1.30

package/dist/doc-schemas/atoms.js

@@ -1,5 +1,3 @@
-// Field atoms shared by the document schemas and the callable schemas. Every enum derives from its
-// one canonical key array in ../types — never re-declared.
 import { z } from 'zod';
 import { checkInputFormat, } from '@ttt-productions/input-format-core';
 import { REPAIR_REASON_INPUT_FORMAT } from '../input-formats/input-formats.js';
@@ -8,28 +6,15 @@ import { isStagingId } from '../ids/picture-ids.js';
 import { isDocumentIdSegment } from '../paths/utils.js';
 import { BASKETBALL_BULK_STAT_KEYS, LEAGUE_TYPE_KEYS, SPORT_KEYS, STAT_COUNTER_KEYS, } from '../types/sports.js';
 import { GAME_STATUS_KEYS, HARDWARE_LOAN_CONTRACT_STATUS_KEYS, MEMBERSHIP_ROSTER_SYNC_STATUS_KEYS, TEAM_JOIN_REQUEST_STATUS_KEYS, LEAGUE_MODE_KEYS, LEAGUE_STATUS_KEYS, STATS_BEACON_ACTION_KEYS, STATS_DISCREPANCY_KIND_KEYS, TEAM_ICON_KEYS, TEAM_INVITATION_STATUS_KEYS, TEAM_JOIN_METHOD_KEYS, TEAM_MEMBERSHIP_STATUS_KEYS, TEAM_ROLE_KEYS, SYSTEM_ROLE_KEYS, TEAM_TYPE_KEYS, USER_STATUS_KEYS, WAIVER_WITNESS_AUTHORITY_KEYS, } from '../types/unions.js';
-// Every persisted moment is an epoch-millisecond number (RULE-STD-ARCH-105).
 export const epochMsSchema = z.number().int().nonnegative();
-// A tally: a stat line's counter, a games-played count, a run's page counts.
 export const countSchema = z.number().int().nonnegative();
-// A change revision: advanced by one with every change to what it versions, so the first writes 1.
 export const revisionSchema = z.number().int().positive();
-// The revision a reconciler last finished: 0 before its first finish, never past the revision.
 export const appliedRevisionSchema = z.number().int().nonnegative();
-/**
- * Why `checkInputFormat` refused a text, as a field's wire schema words it, with the declaration's
- * bounds: a required field left blank is "Required.", a short one names its minimum, a long one its
- * maximum.
- */
 export const TEXT_FIELD_ISSUE_MESSAGES = {
     tooShort: ({ min }) => (min <= 1 ? 'Required.' : `At least ${min} characters.`),
     tooLong: ({ max }) => `At most ${max} characters.`,
     invalidCharacters: () => 'Holds a character this field does not allow.',
 };
-/**
- * Checks `text` against its field's declaration: the value the field keeps, or the sentence that
- * refuses it — the same words `textFieldSchema` gives the wire.
- */
 export function checkTextField(declaration, text) {
     const result = checkInputFormat(text, declaration);
     if (result.ok)
@@ -50,15 +35,8 @@ export function textFieldSchema(declaration) {
         return z.NEVER;
     });
 }
-// Required on every repair action and recorded with the state it replaced (RULE-STD-BACKEND-212): the
-// callable's input, and the correction event and stats operation that store it.
 export const repairReasonSchema = textFieldSchema(REPAIR_REASON_INPUT_FORMAT);
-/** The shape of a calendar date, `YYYY-MM-DD`; a form names the issue it raises by this pattern. */
 export const CALENDAR_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
-// A calendar date with no time or zone: `YYYY-MM-DD`, naming a day that exists — the pattern alone
-// admits `2026-02-31`. League start/end dates and a game's dayKey. Two of them compare correctly as
-// strings. A value that fails the pattern stops there: an empty or misshapen value is not a date at
-// all, so it carries the one pattern issue (a form's "Choose a date."), never a second about the day.
 export const calendarDateSchema = z
     .string()
     .regex(CALENDAR_DATE_PATTERN, { abort: true })
@@ -66,11 +44,6 @@ export const calendarDateSchema = z
     const day = new Date(`${value}T00:00:00.000Z`);
     return !Number.isNaN(day.getTime()) && day.toISOString().startsWith(value);
 }, 'Not a real calendar date.');
-// Every id a document path is built from is exactly one path segment (RULE-STD-ARCH-106): a client-sent id
-// holding a `/` or empty would address another document, a subcollection, or the collection itself.
-// Each entity's atom builds on this one; there is no generic idSchema for a field to use instead. An
-// empty id stops at its one length issue — a form's "Required." for a choice left unmade — never a
-// second about the segment.
 export const documentIdSegmentSchema = z
     .string()
     .min(1, { abort: true })
@@ -79,21 +52,12 @@ export const userIdSchema = documentIdSegmentSchema;
 export const leagueIdSchema = documentIdSegmentSchema;
 export const teamIdSchema = documentIdSegmentSchema;
 export const gameIdSchema = documentIdSegmentSchema;
-// A week of a league's schedule. A week has no document: its games carry the id and the week's
-// shared fields, and the league's weeks are rebuilt by grouping its games on it.
 export const scheduleWeekIdSchema = documentIdSegmentSchema;
-// A game roster entry, `{teamId}_{userId}`: its roster document id, the key of its line in the
-// game's `stats.playerStats`, and its member of the game's absence and participation lists.
 export const gameRosterPlayerIdSchema = documentIdSegmentSchema.refine((id) => parseGameRosterPlayerId(id) !== null, 'Not a game roster entry id.');
-// Equal to the stat event's document id.
 export const statEventIdSchema = documentIdSegmentSchema;
 export const statsOperationIdSchema = documentIdSegmentSchema;
-// A stats check's report is keyed by the check's operation id.
 export const statsValidationReportIdSchema = statsOperationIdSchema;
-// A hardware loan contract's id, minted by the creating callable.
 export const hardwareLoanContractIdSchema = documentIdSegmentSchema;
-// The id a client mints for one upload, the last segment of its staging path: a lowercase UUID. A
-// picture's id is its upload's staging id, so `pictureIdSchema` is this atom.
 export const stagingIdSchema = z.string().refine(isStagingId, 'Not a staging id.');
 export const leagueTypeSchema = z.enum(LEAGUE_TYPE_KEYS);
 export const sportKeySchema = z.enum(SPORT_KEYS);

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

@@ -1 +1 @@
-{"version":3,"file":"atoms.js","sourceRoot":"","sources":["../../src/doc-schemas/atoms.ts"],"names":[],"mappings":"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","sourcesContent":["// Field atoms shared by the document schemas and the callable schemas. Every enum derives from its\n// one canonical key array in ../types — never re-declared.\n\nimport { z } from 'zod';\nimport {\n  checkInputFormat,\n  type DeclaredInputFormat,\n  type InputFormatIssue,\n} from '@ttt-productions/input-format-core';\nimport { REPAIR_REASON_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport { parseGameRosterPlayerId } from '../ids/compound-ids.js';\nimport { isStagingId } from '../ids/picture-ids.js';\nimport { isDocumentIdSegment } from '../paths/utils.js';\nimport {\n  BASKETBALL_BULK_STAT_KEYS,\n  LEAGUE_TYPE_KEYS,\n  SPORT_KEYS,\n  STAT_COUNTER_KEYS,\n} from '../types/sports.js';\nimport {\n  GAME_STATUS_KEYS,\n  HARDWARE_LOAN_CONTRACT_STATUS_KEYS,\n  MEMBERSHIP_ROSTER_SYNC_STATUS_KEYS,\n  TEAM_JOIN_REQUEST_STATUS_KEYS,\n  LEAGUE_MODE_KEYS,\n  LEAGUE_STATUS_KEYS,\n  STATS_BEACON_ACTION_KEYS,\n  STATS_DISCREPANCY_KIND_KEYS,\n  TEAM_ICON_KEYS,\n  TEAM_INVITATION_STATUS_KEYS,\n  TEAM_JOIN_METHOD_KEYS,\n  TEAM_MEMBERSHIP_STATUS_KEYS,\n  TEAM_ROLE_KEYS,\n  SYSTEM_ROLE_KEYS,\n  TEAM_TYPE_KEYS,\n  USER_STATUS_KEYS,\n  WAIVER_WITNESS_AUTHORITY_KEYS,\n} from '../types/unions.js';\n\n// Every persisted moment is an epoch-millisecond number (RULE-STD-ARCH-105).\nexport const epochMsSchema = z.number().int().nonnegative();\n\n// A tally: a stat line's counter, a games-played count, a run's page counts.\nexport const countSchema = z.number().int().nonnegative();\n\n// A change revision: advanced by one with every change to what it versions, so the first writes 1.\nexport const revisionSchema = z.number().int().positive();\n\n// The revision a reconciler last finished: 0 before its first finish, never past the revision.\nexport const appliedRevisionSchema = z.number().int().nonnegative();\n\n/**\n * Why `checkInputFormat` refused a text, as a field's wire schema words it, with the declaration's\n * bounds: a required field left blank is \"Required.\", a short one names its minimum, a long one its\n * maximum.\n */\nexport const TEXT_FIELD_ISSUE_MESSAGES: Readonly<\n  Record<InputFormatIssue, (declaration: DeclaredInputFormat) => string>\n> = {\n  tooShort: ({ min }) => (min <= 1 ? 'Required.' : `At least ${min} characters.`),\n  tooLong: ({ max }) => `At most ${max} characters.`,\n  invalidCharacters: () => 'Holds a character this field does not allow.',\n};\n\n/**\n * A text field's wire schema, built from the field's one declaration: it runs input-format-core's\n * check — trim, then min, max, and the format's characters — and parses to the text the check keeps.\n * The form's input reads the same declaration, so the two accept exactly the same text (RULE-STD-ARCH-102). A\n * refusal carries the issue and the declaration's bounds, so a form can say which bound was missed.\n */\n/** A text field's declaration, as a form and its wire schema both read it. */\nexport type TextFieldDeclaration = DeclaredInputFormat;\n\nexport type TextFieldResult =\n  { readonly ok: true; readonly value: string } | { readonly ok: false; readonly reason: string };\n\n/**\n * Checks `text` against its field's declaration: the value the field keeps, or the sentence that\n * refuses it — the same words `textFieldSchema` gives the wire.\n */\nexport function checkTextField(declaration: TextFieldDeclaration, text: string): TextFieldResult {\n  const result = checkInputFormat(text, declaration);\n  if (result.ok) return { ok: true, value: result.value };\n  return { ok: false, reason: TEXT_FIELD_ISSUE_MESSAGES[result.issue](declaration) };\n}\n\nexport function textFieldSchema(declaration: DeclaredInputFormat) {\n  return z.string().transform((text, ctx) => {\n    const result = checkInputFormat(text, declaration);\n    if (result.ok) return result.value;\n    ctx.addIssue({\n      code: 'custom',\n      message: TEXT_FIELD_ISSUE_MESSAGES[result.issue](declaration),\n      input: text,\n      params: { issue: result.issue, min: declaration.min, max: declaration.max },\n    });\n    return z.NEVER;\n  });\n}\n\n// Required on every repair action and recorded with the state it replaced (RULE-STD-BACKEND-212): the\n// callable's input, and the correction event and stats operation that store it.\nexport const repairReasonSchema = textFieldSchema(REPAIR_REASON_INPUT_FORMAT);\n\n/** The shape of a calendar date, `YYYY-MM-DD`; a form names the issue it raises by this pattern. */\nexport const CALENDAR_DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/;\n\n// A calendar date with no time or zone: `YYYY-MM-DD`, naming a day that exists — the pattern alone\n// admits `2026-02-31`. League start/end dates and a game's dayKey. Two of them compare correctly as\n// strings. A value that fails the pattern stops there: an empty or misshapen value is not a date at\n// all, so it carries the one pattern issue (a form's \"Choose a date.\"), never a second about the day.\nexport const calendarDateSchema = z\n  .string()\n  .regex(CALENDAR_DATE_PATTERN, { abort: true })\n  .refine((value) => {\n    const day = new Date(`${value}T00:00:00.000Z`);\n    return !Number.isNaN(day.getTime()) && day.toISOString().startsWith(value);\n  }, 'Not a real calendar date.');\n\n// Every id a document path is built from is exactly one path segment (RULE-STD-ARCH-106): a client-sent id\n// holding a `/` or empty would address another document, a subcollection, or the collection itself.\n// Each entity's atom builds on this one; there is no generic idSchema for a field to use instead. An\n// empty id stops at its one length issue — a form's \"Required.\" for a choice left unmade — never a\n// second about the segment.\nexport const documentIdSegmentSchema = z\n  .string()\n  .min(1, { abort: true })\n  .refine(isDocumentIdSegment, 'Not a document id.');\n\nexport const userIdSchema = documentIdSegmentSchema;\nexport const leagueIdSchema = documentIdSegmentSchema;\nexport const teamIdSchema = documentIdSegmentSchema;\nexport const gameIdSchema = documentIdSegmentSchema;\n// A week of a league's schedule. A week has no document: its games carry the id and the week's\n// shared fields, and the league's weeks are rebuilt by grouping its games on it.\nexport const scheduleWeekIdSchema = documentIdSegmentSchema;\n// A game roster entry, `{teamId}_{userId}`: its roster document id, the key of its line in the\n// game's `stats.playerStats`, and its member of the game's absence and participation lists.\nexport const gameRosterPlayerIdSchema = documentIdSegmentSchema.refine(\n  (id) => parseGameRosterPlayerId(id) !== null,\n  'Not a game roster entry id.',\n);\n// Equal to the stat event's document id.\nexport const statEventIdSchema = documentIdSegmentSchema;\nexport const statsOperationIdSchema = documentIdSegmentSchema;\n// A stats check's report is keyed by the check's operation id.\nexport const statsValidationReportIdSchema = statsOperationIdSchema;\n// A hardware loan contract's id, minted by the creating callable.\nexport const hardwareLoanContractIdSchema = documentIdSegmentSchema;\n// The id a client mints for one upload, the last segment of its staging path: a lowercase UUID. A\n// picture's id is its upload's staging id, so `pictureIdSchema` is this atom.\nexport const stagingIdSchema = z.string().refine(isStagingId, 'Not a staging id.');\n\nexport const leagueTypeSchema = z.enum(LEAGUE_TYPE_KEYS);\nexport const sportKeySchema = z.enum(SPORT_KEYS);\nexport const leagueStatusSchema = z.enum(LEAGUE_STATUS_KEYS);\nexport const leagueModeSchema = z.enum(LEAGUE_MODE_KEYS);\nexport const teamTypeSchema = z.enum(TEAM_TYPE_KEYS);\nexport const teamIconSchema = z.enum(TEAM_ICON_KEYS);\nexport const teamRoleSchema = z.enum(TEAM_ROLE_KEYS);\nexport const systemRoleSchema = z.enum(SYSTEM_ROLE_KEYS);\nexport const userStatusSchema = z.enum(USER_STATUS_KEYS);\nexport const teamMembershipStatusSchema = z.enum(TEAM_MEMBERSHIP_STATUS_KEYS);\nexport const teamJoinMethodSchema = z.enum(TEAM_JOIN_METHOD_KEYS);\nexport const gameStatusSchema = z.enum(GAME_STATUS_KEYS);\nexport const teamInvitationStatusSchema = z.enum(TEAM_INVITATION_STATUS_KEYS);\nexport const teamJoinRequestStatusSchema = z.enum(TEAM_JOIN_REQUEST_STATUS_KEYS);\nexport const hardwareLoanContractStatusSchema = z.enum(HARDWARE_LOAN_CONTRACT_STATUS_KEYS);\nexport const membershipRosterSyncStatusSchema = z.enum(MEMBERSHIP_ROSTER_SYNC_STATUS_KEYS);\nexport const waiverWitnessAuthoritySchema = z.enum(WAIVER_WITNESS_AUTHORITY_KEYS);\nexport const statsBeaconActionSchema = z.enum(STATS_BEACON_ACTION_KEYS);\nexport const statsDiscrepancyKindSchema = z.enum(STATS_DISCREPANCY_KIND_KEYS);\nexport const basketballBulkStatKeySchema = z.enum(BASKETBALL_BULK_STAT_KEYS);\nexport const statCounterKeySchema = z.enum(STAT_COUNTER_KEYS);\n"]}
+{"version":3,"file":"atoms.js","sourceRoot":"","sources":["../../src/doc-schemas/atoms.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from 'zod';\nimport {\n  checkInputFormat,\n  type DeclaredInputFormat,\n  type InputFormatIssue,\n} from '@ttt-productions/input-format-core';\nimport { REPAIR_REASON_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport { parseGameRosterPlayerId } from '../ids/compound-ids.js';\nimport { isStagingId } from '../ids/picture-ids.js';\nimport { isDocumentIdSegment } from '../paths/utils.js';\nimport {\n  BASKETBALL_BULK_STAT_KEYS,\n  LEAGUE_TYPE_KEYS,\n  SPORT_KEYS,\n  STAT_COUNTER_KEYS,\n} from '../types/sports.js';\nimport {\n  GAME_STATUS_KEYS,\n  HARDWARE_LOAN_CONTRACT_STATUS_KEYS,\n  MEMBERSHIP_ROSTER_SYNC_STATUS_KEYS,\n  TEAM_JOIN_REQUEST_STATUS_KEYS,\n  LEAGUE_MODE_KEYS,\n  LEAGUE_STATUS_KEYS,\n  STATS_BEACON_ACTION_KEYS,\n  STATS_DISCREPANCY_KIND_KEYS,\n  TEAM_ICON_KEYS,\n  TEAM_INVITATION_STATUS_KEYS,\n  TEAM_JOIN_METHOD_KEYS,\n  TEAM_MEMBERSHIP_STATUS_KEYS,\n  TEAM_ROLE_KEYS,\n  SYSTEM_ROLE_KEYS,\n  TEAM_TYPE_KEYS,\n  USER_STATUS_KEYS,\n  WAIVER_WITNESS_AUTHORITY_KEYS,\n} from '../types/unions.js';\n\nexport const epochMsSchema = z.number().int().nonnegative();\n\nexport const countSchema = z.number().int().nonnegative();\n\nexport const revisionSchema = z.number().int().positive();\n\nexport const appliedRevisionSchema = z.number().int().nonnegative();\n\nexport const TEXT_FIELD_ISSUE_MESSAGES: Readonly<\n  Record<InputFormatIssue, (declaration: DeclaredInputFormat) => string>\n> = {\n  tooShort: ({ min }) => (min <= 1 ? 'Required.' : `At least ${min} characters.`),\n  tooLong: ({ max }) => `At most ${max} characters.`,\n  invalidCharacters: () => 'Holds a character this field does not allow.',\n};\n\nexport type TextFieldDeclaration = DeclaredInputFormat;\n\nexport type TextFieldResult =\n  { readonly ok: true; readonly value: string } | { readonly ok: false; readonly reason: string };\n\nexport function checkTextField(declaration: TextFieldDeclaration, text: string): TextFieldResult {\n  const result = checkInputFormat(text, declaration);\n  if (result.ok) return { ok: true, value: result.value };\n  return { ok: false, reason: TEXT_FIELD_ISSUE_MESSAGES[result.issue](declaration) };\n}\n\nexport function textFieldSchema(declaration: DeclaredInputFormat) {\n  return z.string().transform((text, ctx) => {\n    const result = checkInputFormat(text, declaration);\n    if (result.ok) return result.value;\n    ctx.addIssue({\n      code: 'custom',\n      message: TEXT_FIELD_ISSUE_MESSAGES[result.issue](declaration),\n      input: text,\n      params: { issue: result.issue, min: declaration.min, max: declaration.max },\n    });\n    return z.NEVER;\n  });\n}\n\nexport const repairReasonSchema = textFieldSchema(REPAIR_REASON_INPUT_FORMAT);\n\nexport const CALENDAR_DATE_PATTERN = /^\\d{4}-\\d{2}-\\d{2}$/;\n\nexport const calendarDateSchema = z\n  .string()\n  .regex(CALENDAR_DATE_PATTERN, { abort: true })\n  .refine((value) => {\n    const day = new Date(`${value}T00:00:00.000Z`);\n    return !Number.isNaN(day.getTime()) && day.toISOString().startsWith(value);\n  }, 'Not a real calendar date.');\n\nexport const documentIdSegmentSchema = z\n  .string()\n  .min(1, { abort: true })\n  .refine(isDocumentIdSegment, 'Not a document id.');\n\nexport const userIdSchema = documentIdSegmentSchema;\nexport const leagueIdSchema = documentIdSegmentSchema;\nexport const teamIdSchema = documentIdSegmentSchema;\nexport const gameIdSchema = documentIdSegmentSchema;\nexport const scheduleWeekIdSchema = documentIdSegmentSchema;\nexport const gameRosterPlayerIdSchema = documentIdSegmentSchema.refine(\n  (id) => parseGameRosterPlayerId(id) !== null,\n  'Not a game roster entry id.',\n);\nexport const statEventIdSchema = documentIdSegmentSchema;\nexport const statsOperationIdSchema = documentIdSegmentSchema;\nexport const statsValidationReportIdSchema = statsOperationIdSchema;\nexport const hardwareLoanContractIdSchema = documentIdSegmentSchema;\nexport const stagingIdSchema = z.string().refine(isStagingId, 'Not a staging id.');\n\nexport const leagueTypeSchema = z.enum(LEAGUE_TYPE_KEYS);\nexport const sportKeySchema = z.enum(SPORT_KEYS);\nexport const leagueStatusSchema = z.enum(LEAGUE_STATUS_KEYS);\nexport const leagueModeSchema = z.enum(LEAGUE_MODE_KEYS);\nexport const teamTypeSchema = z.enum(TEAM_TYPE_KEYS);\nexport const teamIconSchema = z.enum(TEAM_ICON_KEYS);\nexport const teamRoleSchema = z.enum(TEAM_ROLE_KEYS);\nexport const systemRoleSchema = z.enum(SYSTEM_ROLE_KEYS);\nexport const userStatusSchema = z.enum(USER_STATUS_KEYS);\nexport const teamMembershipStatusSchema = z.enum(TEAM_MEMBERSHIP_STATUS_KEYS);\nexport const teamJoinMethodSchema = z.enum(TEAM_JOIN_METHOD_KEYS);\nexport const gameStatusSchema = z.enum(GAME_STATUS_KEYS);\nexport const teamInvitationStatusSchema = z.enum(TEAM_INVITATION_STATUS_KEYS);\nexport const teamJoinRequestStatusSchema = z.enum(TEAM_JOIN_REQUEST_STATUS_KEYS);\nexport const hardwareLoanContractStatusSchema = z.enum(HARDWARE_LOAN_CONTRACT_STATUS_KEYS);\nexport const membershipRosterSyncStatusSchema = z.enum(MEMBERSHIP_ROSTER_SYNC_STATUS_KEYS);\nexport const waiverWitnessAuthoritySchema = z.enum(WAIVER_WITNESS_AUTHORITY_KEYS);\nexport const statsBeaconActionSchema = z.enum(STATS_BEACON_ACTION_KEYS);\nexport const statsDiscrepancyKindSchema = z.enum(STATS_DISCREPANCY_KIND_KEYS);\nexport const basketballBulkStatKeySchema = z.enum(BASKETBALL_BULK_STAT_KEYS);\nexport const statCounterKeySchema = z.enum(STAT_COUNTER_KEYS);\n"]}

package/dist/doc-schemas/audit-event.d.ts

@@ -49,6 +49,7 @@ export declare const auditEventTypeSchema: z.ZodEnum<{
     "award.deleted": "award.deleted";
     "award.granted": "award.granted";
     "award.revoked": "award.revoked";
+    "award.groupDecisionOpened": "award.groupDecisionOpened";
     "hardwareLoanContract.created": "hardwareLoanContract.created";
     "hardwareLoanContract.signed": "hardwareLoanContract.signed";
     "hardwareLoanContract.returned": "hardwareLoanContract.returned";
@@ -165,6 +166,7 @@ export declare const AuditEventSchema: z.ZodObject<{
         "award.deleted": "award.deleted";
         "award.granted": "award.granted";
         "award.revoked": "award.revoked";
+        "award.groupDecisionOpened": "award.groupDecisionOpened";
         "hardwareLoanContract.created": "hardwareLoanContract.created";
         "hardwareLoanContract.signed": "hardwareLoanContract.signed";
         "hardwareLoanContract.returned": "hardwareLoanContract.returned";

package/dist/doc-schemas/audit-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-event.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/audit-event.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;iCAgB3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAe3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"audit-event.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/audit-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAgC,CAAC;AAElE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;iCAgB3B,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;iBAG5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC"}

package/dist/doc-schemas/audit-event.js

@@ -1,10 +1,3 @@
-// `auditEvents/{auditEventId}` — the append-only record of sensitive actions and their rejected
-// attempts (RULE-STD-BACKEND-202..205). Written only by Cloud Functions through the audit writer, in the
-// same transaction or batch as the action it records; no client reads or writes it.
-//
-// The envelope is `@ttt-productions/audit-core`'s `AuditEvent`; Q-Sports supplies the event-type
-// union and the actor / target shapes. The admin modes carry the global role they acted with and the
-// others carry none (RULE-STD-BACKEND-205).
 import { z } from 'zod';
 import { AUDIT_ADMIN_ACTOR_MODE_KEYS, AUDIT_EVENT_TYPE_KEYS, AUDIT_NON_ADMIN_ACTOR_MODE_KEYS, AUDIT_RESULT_KEYS, } from '../types/audit.js';
 import { epochMsSchema, systemRoleSchema, userIdSchema } from './atoms.js';
@@ -40,7 +33,6 @@ export const AuditEventSchema = z.object({
     ip: z.string().nullable(),
     userAgent: z.string().nullable(),
     region: z.string().nullable(),
-    // Event-specific facts: prior and new values, the role changed, a repair's reason.
     metadata: z.record(z.string(), z.unknown()),
     result: z.enum(AUDIT_RESULT_KEYS),
     failureReason: z.string().nullable(),

package/dist/doc-schemas/audit-event.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-event.js","sourceRoot":"","sources":["../../src/doc-schemas/audit-event.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,yGAAyG;AACzG,oFAAoF;AACpF,EAAE;AACF,iGAAiG;AACjG,qGAAqG;AACrG,4CAA4C;AAE5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,WAAW,EAAE;IAChE,CAAC;SACE,MAAM,CAAC;QACN,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC;KACnD,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC;QAC9C,UAAU,EAAE,gBAAgB;KAC7B,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,oBAAoB;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,aAAa;IACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,mFAAmF;IACnF,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC","sourcesContent":["// `auditEvents/{auditEventId}` — the append-only record of sensitive actions and their rejected\n// attempts (RULE-STD-BACKEND-202..205). Written only by Cloud Functions through the audit writer, in the\n// same transaction or batch as the action it records; no client reads or writes it.\n//\n// The envelope is `@ttt-productions/audit-core`'s `AuditEvent`; Q-Sports supplies the event-type\n// union and the actor / target shapes. The admin modes carry the global role they acted with and the\n// others carry none (RULE-STD-BACKEND-205).\n\nimport { z } from 'zod';\nimport {\n  AUDIT_ADMIN_ACTOR_MODE_KEYS,\n  AUDIT_EVENT_TYPE_KEYS,\n  AUDIT_NON_ADMIN_ACTOR_MODE_KEYS,\n  AUDIT_RESULT_KEYS,\n} from '../types/audit.js';\nimport { epochMsSchema, systemRoleSchema, userIdSchema } from './atoms.js';\n\nexport const auditEventTypeSchema = z.enum(AUDIT_EVENT_TYPE_KEYS);\n\nexport const AuditActorSchema = z.discriminatedUnion('actorMode', [\n  z\n    .object({\n      uid: userIdSchema.nullable(),\n      isAdmin: z.boolean(),\n      actorMode: z.enum(AUDIT_NON_ADMIN_ACTOR_MODE_KEYS),\n    })\n    .strict(),\n  z\n    .object({\n      uid: userIdSchema.nullable(),\n      isAdmin: z.boolean(),\n      actorMode: z.enum(AUDIT_ADMIN_ACTOR_MODE_KEYS),\n      systemRole: systemRoleSchema,\n    })\n    .strict(),\n]);\n\nexport const AuditTargetSchema = z.object({\n  uid: userIdSchema.nullable(),\n  ref: z.string().nullable(),\n});\n\nexport const AuditEventSchema = z.object({\n  id: z.string().min(1),\n  type: auditEventTypeSchema,\n  schemaVersion: z.number().int().positive(),\n  actor: AuditActorSchema.nullable(),\n  target: AuditTargetSchema.nullable(),\n  timestamp: epochMsSchema,\n  ip: z.string().nullable(),\n  userAgent: z.string().nullable(),\n  region: z.string().nullable(),\n  // Event-specific facts: prior and new values, the role changed, a repair's reason.\n  metadata: z.record(z.string(), z.unknown()),\n  result: z.enum(AUDIT_RESULT_KEYS),\n  failureReason: z.string().nullable(),\n  correlationId: z.string().nullable(),\n});\nexport type AuditEvent = z.infer<typeof AuditEventSchema>;\n"]}
+{"version":3,"file":"audit-event.js","sourceRoot":"","sources":["../../src/doc-schemas/audit-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,+BAA+B,EAC/B,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,kBAAkB,CAAC,WAAW,EAAE;IAChE,CAAC;SACE,MAAM,CAAC;QACN,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,+BAA+B,CAAC;KACnD,CAAC;SACD,MAAM,EAAE;IACX,CAAC;SACE,MAAM,CAAC;QACN,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE;QAC5B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC;QAC9C,UAAU,EAAE,gBAAgB;KAC7B,CAAC;SACD,MAAM,EAAE;CACZ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC5B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,IAAI,EAAE,oBAAoB;IAC1B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC1C,KAAK,EAAE,gBAAgB,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACpC,SAAS,EAAE,aAAa;IACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC;IACjC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport {\n  AUDIT_ADMIN_ACTOR_MODE_KEYS,\n  AUDIT_EVENT_TYPE_KEYS,\n  AUDIT_NON_ADMIN_ACTOR_MODE_KEYS,\n  AUDIT_RESULT_KEYS,\n} from '../types/audit.js';\nimport { epochMsSchema, systemRoleSchema, userIdSchema } from './atoms.js';\n\nexport const auditEventTypeSchema = z.enum(AUDIT_EVENT_TYPE_KEYS);\n\nexport const AuditActorSchema = z.discriminatedUnion('actorMode', [\n  z\n    .object({\n      uid: userIdSchema.nullable(),\n      isAdmin: z.boolean(),\n      actorMode: z.enum(AUDIT_NON_ADMIN_ACTOR_MODE_KEYS),\n    })\n    .strict(),\n  z\n    .object({\n      uid: userIdSchema.nullable(),\n      isAdmin: z.boolean(),\n      actorMode: z.enum(AUDIT_ADMIN_ACTOR_MODE_KEYS),\n      systemRole: systemRoleSchema,\n    })\n    .strict(),\n]);\n\nexport const AuditTargetSchema = z.object({\n  uid: userIdSchema.nullable(),\n  ref: z.string().nullable(),\n});\n\nexport const AuditEventSchema = z.object({\n  id: z.string().min(1),\n  type: auditEventTypeSchema,\n  schemaVersion: z.number().int().positive(),\n  actor: AuditActorSchema.nullable(),\n  target: AuditTargetSchema.nullable(),\n  timestamp: epochMsSchema,\n  ip: z.string().nullable(),\n  userAgent: z.string().nullable(),\n  region: z.string().nullable(),\n  metadata: z.record(z.string(), z.unknown()),\n  result: z.enum(AUDIT_RESULT_KEYS),\n  failureReason: z.string().nullable(),\n  correlationId: z.string().nullable(),\n});\nexport type AuditEvent = z.infer<typeof AuditEventSchema>;\n"]}

package/dist/doc-schemas/award-group-grant.d.ts

@@ -8,8 +8,8 @@ export declare const awardGroupGrantActionSchema: z.ZodEnum<{
     revoke: "revoke";
 }>;
 export declare const awardGroupGrantStatusSchema: z.ZodEnum<{
-    pending: "pending";
     complete: "complete";
+    pending: "pending";
 }>;
 export declare const awardGroupGrantDecisionSchema: z.ZodNumber;
 export declare const AwardGroupGrantSchema: z.ZodObject<{
@@ -28,8 +28,8 @@ export declare const AwardGroupGrantSchema: z.ZodObject<{
     decision: z.ZodNumber;
     actorUid: z.ZodString;
     status: z.ZodEnum<{
-        pending: "pending";
         complete: "complete";
+        pending: "pending";
     }>;
     createdAt: z.ZodNumber;
     completedAt: z.ZodOptional<z.ZodNumber>;
@@ -38,12 +38,6 @@ export declare const AwardGroupGrantSchema: z.ZodObject<{
     lastError: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type AwardGroupGrant = z.infer<typeof AwardGroupGrantSchema>;
-/**
- * Whether a request opens a new decision on an award for a group, given the group's latest decision
- * (`null` when it has none): a grant opens unless the latest is a grant, and a take-back opens only
- * when it is. A request the latest decision already settles opens nothing. The server applies it in
- * the transaction that opens the decision; the admin surface offers only the request it opens.
- */
 export declare function awardGroupGrantOpens(latest: Pick<AwardGroupGrant, 'action'> | null, action: AwardGroupGrant['action']): boolean;
 export declare const AwardGroupGrantPersonSchema: z.ZodObject<{
     userId: z.ZodString;

package/dist/doc-schemas/award-group-grant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"award-group-grant.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/award-group-grant.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,oBAAoB;;;EAAgC,CAAC;AAClE,eAAO,MAAM,2BAA2B;;;EAAwC,CAAC;AACjF,eAAO,MAAM,2BAA2B;;;EAAwC,CAAC;AAGjF,eAAO,MAAM,6BAA6B,aAAiB,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;kBAqC9B,CAAC;AACL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,IAAI,EAC9C,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAChC,OAAO,CAET;AAMD,eAAO,MAAM,2BAA2B;;;;;;;;;;kBAOtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}
+{"version":3,"file":"award-group-grant.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/award-group-grant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,eAAO,MAAM,oBAAoB;;;EAAgC,CAAC;AAClE,eAAO,MAAM,2BAA2B;;;EAAwC,CAAC;AACjF,eAAO,MAAM,2BAA2B;;;EAAwC,CAAC;AAEjF,eAAO,MAAM,6BAA6B,aAAiB,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;kBAiC9B,CAAC;AACL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG,IAAI,EAC9C,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAChC,OAAO,CAET;AAED,eAAO,MAAM,2BAA2B;;;;;;;;;;kBAOtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC"}

package/dist/doc-schemas/award-group-grant.js

@@ -1,13 +1,3 @@
-// `awardGroupGrants/{grantId}` — one decision on one award for one group (a team, or a whole league):
-// grant the award to the group's active members, or take back what the group's grants gave. The
-// people are reached a page at a time, after the decision opens in its own small transaction. Written
-// only by Cloud Functions; an admin reads a decision through the status callable.
-//
-// A grant records each person in `awardGroupGrantPeople` before it changes their profile, so a re-run
-// after any interruption finds every recorded person and finishes them, and its revoke reverses exactly
-// the people it gave the award to. Someone who already held the award is recorded as holding it before,
-// and a revoke leaves them holding it. `status` stays `pending` until every page is done; the retry
-// ledger lets a decision that keeps failing back off instead of holding the resume's window.
 import { z } from 'zod';
 import { buildAwardGroupGrantId, buildAwardGroupGrantTargetKey } from '../ids/award-grant-ids.js';
 import { AWARD_GROUP_GRANT_ACTION_KEYS, AWARD_GROUP_GRANT_STATUS_KEYS, AWARD_GROUP_REVOKE_SKIP_KEYS, AWARD_GROUP_TYPE_KEYS, } from '../types/unions.js';
@@ -16,7 +6,6 @@ import { awardIdSchema } from './catalogs.js';
 export const awardGroupTypeSchema = z.enum(AWARD_GROUP_TYPE_KEYS);
 export const awardGroupGrantActionSchema = z.enum(AWARD_GROUP_GRANT_ACTION_KEYS);
 export const awardGroupGrantStatusSchema = z.enum(AWARD_GROUP_GRANT_STATUS_KEYS);
-// A decision's number among every decision on its award and group: the first is 1.
 export const awardGroupGrantDecisionSchema = revisionSchema;
 export const AwardGroupGrantSchema = z
     .strictObject({
@@ -24,11 +13,9 @@ export const AwardGroupGrantSchema = z
     action: awardGroupGrantActionSchema,
     awardId: awardIdSchema,
     groupType: awardGroupTypeSchema,
-    // The team id or the league id, as `groupType` says.
     groupId: documentIdSegmentSchema,
     targetKey: z.string().min(1),
     decision: awardGroupGrantDecisionSchema,
-    // The admin who decided. Each person's audit event is recorded as their action.
     actorUid: userIdSchema,
     status: awardGroupGrantStatusSchema,
     createdAt: epochMsSchema,
@@ -38,8 +25,6 @@ export const AwardGroupGrantSchema = z
     lastError: z.string().optional(),
 })
     .superRefine((grant, ctx) => {
-    // The key and the id are derived fields: a decision whose stored key or id disagrees with its
-    // award, group, and number would sit outside that pair's decision sequence.
     const targetKey = buildAwardGroupGrantTargetKey(grant);
     if (grant.targetKey !== targetKey) {
         ctx.addIssue({
@@ -56,19 +41,9 @@ export const AwardGroupGrantSchema = z
         });
     }
 });
-/**
- * Whether a request opens a new decision on an award for a group, given the group's latest decision
- * (`null` when it has none): a grant opens unless the latest is a grant, and a take-back opens only
- * when it is. A request the latest decision already settles opens nothing. The server applies it in
- * the transaction that opens the decision; the admin surface offers only the request it opens.
- */
 export function awardGroupGrantOpens(latest, action) {
     return action === 'grant' ? latest?.action !== 'grant' : latest?.action === 'grant';
 }
-// `awardGroupGrants/{grantId}/awardGroupGrantPeople/{userId}` — one person a grant decision reached,
-// recorded before their profile changed. `heldBefore` says they already held the award, so the grant
-// gave them nothing. `revoked` turns true once a revoke has dealt with them; `revokeSkipped` says why
-// that revoke left them holding the award.
 export const AwardGroupGrantPersonSchema = z.strictObject({
     userId: userIdSchema,
     heldBefore: z.boolean(),

package/dist/doc-schemas/award-group-grant.js.map

@@ -1 +1 @@
-{"version":3,"file":"award-group-grant.js","sourceRoot":"","sources":["../../src/doc-schemas/award-group-grant.ts"],"names":[],"mappings":"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","sourcesContent":["// `awardGroupGrants/{grantId}` — one decision on one award for one group (a team, or a whole league):\n// grant the award to the group's active members, or take back what the group's grants gave. The\n// people are reached a page at a time, after the decision opens in its own small transaction. Written\n// only by Cloud Functions; an admin reads a decision through the status callable.\n//\n// A grant records each person in `awardGroupGrantPeople` before it changes their profile, so a re-run\n// after any interruption finds every recorded person and finishes them, and its revoke reverses exactly\n// the people it gave the award to. Someone who already held the award is recorded as holding it before,\n// and a revoke leaves them holding it. `status` stays `pending` until every page is done; the retry\n// ledger lets a decision that keeps failing back off instead of holding the resume's window.\n\nimport { z } from 'zod';\nimport { buildAwardGroupGrantId, buildAwardGroupGrantTargetKey } from '../ids/award-grant-ids.js';\nimport {\n  AWARD_GROUP_GRANT_ACTION_KEYS,\n  AWARD_GROUP_GRANT_STATUS_KEYS,\n  AWARD_GROUP_REVOKE_SKIP_KEYS,\n  AWARD_GROUP_TYPE_KEYS,\n} from '../types/unions.js';\nimport {\n  countSchema,\n  documentIdSegmentSchema,\n  epochMsSchema,\n  revisionSchema,\n  userIdSchema,\n} from './atoms.js';\nimport { awardIdSchema } from './catalogs.js';\n\nexport const awardGroupTypeSchema = z.enum(AWARD_GROUP_TYPE_KEYS);\nexport const awardGroupGrantActionSchema = z.enum(AWARD_GROUP_GRANT_ACTION_KEYS);\nexport const awardGroupGrantStatusSchema = z.enum(AWARD_GROUP_GRANT_STATUS_KEYS);\n\n// A decision's number among every decision on its award and group: the first is 1.\nexport const awardGroupGrantDecisionSchema = revisionSchema;\n\nexport const AwardGroupGrantSchema = z\n  .strictObject({\n    grantId: z.string().min(1),\n    action: awardGroupGrantActionSchema,\n    awardId: awardIdSchema,\n    groupType: awardGroupTypeSchema,\n    // The team id or the league id, as `groupType` says.\n    groupId: documentIdSegmentSchema,\n    targetKey: z.string().min(1),\n    decision: awardGroupGrantDecisionSchema,\n    // The admin who decided. Each person's audit event is recorded as their action.\n    actorUid: userIdSchema,\n    status: awardGroupGrantStatusSchema,\n    createdAt: epochMsSchema,\n    completedAt: epochMsSchema.optional(),\n    attemptCount: countSchema,\n    nextAttemptAt: epochMsSchema,\n    lastError: z.string().optional(),\n  })\n  .superRefine((grant, ctx) => {\n    // The key and the id are derived fields: a decision whose stored key or id disagrees with its\n    // award, group, and number would sit outside that pair's decision sequence.\n    const targetKey = buildAwardGroupGrantTargetKey(grant);\n    if (grant.targetKey !== targetKey) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['targetKey'],\n        message: 'targetKey must be the award and group target key.',\n      });\n    }\n    if (grant.grantId !== buildAwardGroupGrantId(targetKey, grant.decision)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['grantId'],\n        message: 'grantId must be the target key and the decision.',\n      });\n    }\n  });\nexport type AwardGroupGrant = z.infer<typeof AwardGroupGrantSchema>;\n\n/**\n * Whether a request opens a new decision on an award for a group, given the group's latest decision\n * (`null` when it has none): a grant opens unless the latest is a grant, and a take-back opens only\n * when it is. A request the latest decision already settles opens nothing. The server applies it in\n * the transaction that opens the decision; the admin surface offers only the request it opens.\n */\nexport function awardGroupGrantOpens(\n  latest: Pick<AwardGroupGrant, 'action'> | null,\n  action: AwardGroupGrant['action'],\n): boolean {\n  return action === 'grant' ? latest?.action !== 'grant' : latest?.action === 'grant';\n}\n\n// `awardGroupGrants/{grantId}/awardGroupGrantPeople/{userId}` — one person a grant decision reached,\n// recorded before their profile changed. `heldBefore` says they already held the award, so the grant\n// gave them nothing. `revoked` turns true once a revoke has dealt with them; `revokeSkipped` says why\n// that revoke left them holding the award.\nexport const AwardGroupGrantPersonSchema = z.strictObject({\n  userId: userIdSchema,\n  heldBefore: z.boolean(),\n  recordedAt: epochMsSchema,\n  revoked: z.boolean(),\n  revokedAt: epochMsSchema.optional(),\n  revokeSkipped: z.enum(AWARD_GROUP_REVOKE_SKIP_KEYS).optional(),\n});\nexport type AwardGroupGrantPerson = z.infer<typeof AwardGroupGrantPersonSchema>;\n"]}
+{"version":3,"file":"award-group-grant.js","sourceRoot":"","sources":["../../src/doc-schemas/award-group-grant.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,uBAAuB,EACvB,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;AACjF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;AAEjF,MAAM,CAAC,MAAM,6BAA6B,GAAG,cAAc,CAAC;AAE5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,YAAY,CAAC;IACZ,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,2BAA2B;IACnC,OAAO,EAAE,aAAa;IACtB,SAAS,EAAE,oBAAoB;IAC/B,OAAO,EAAE,uBAAuB;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,6BAA6B;IACvC,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,2BAA2B;IACnC,SAAS,EAAE,aAAa;IACxB,WAAW,EAAE,aAAa,CAAC,QAAQ,EAAE;IACrC,YAAY,EAAE,WAAW;IACzB,aAAa,EAAE,aAAa;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1B,MAAM,SAAS,GAAG,6BAA6B,CAAC,KAAK,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,WAAW,CAAC;YACnB,OAAO,EAAE,mDAAmD;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,sBAAsB,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxE,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,SAAS,CAAC;YACjB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAGL,MAAM,UAAU,oBAAoB,CAClC,MAA8C,EAC9C,MAAiC;IAEjC,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;AACtF,CAAC;AAED,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,YAAY,CAAC;IACxD,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE;IACvB,UAAU,EAAE,aAAa;IACzB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,SAAS,EAAE,aAAa,CAAC,QAAQ,EAAE;IACnC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { buildAwardGroupGrantId, buildAwardGroupGrantTargetKey } from '../ids/award-grant-ids.js';\nimport {\n  AWARD_GROUP_GRANT_ACTION_KEYS,\n  AWARD_GROUP_GRANT_STATUS_KEYS,\n  AWARD_GROUP_REVOKE_SKIP_KEYS,\n  AWARD_GROUP_TYPE_KEYS,\n} from '../types/unions.js';\nimport {\n  countSchema,\n  documentIdSegmentSchema,\n  epochMsSchema,\n  revisionSchema,\n  userIdSchema,\n} from './atoms.js';\nimport { awardIdSchema } from './catalogs.js';\n\nexport const awardGroupTypeSchema = z.enum(AWARD_GROUP_TYPE_KEYS);\nexport const awardGroupGrantActionSchema = z.enum(AWARD_GROUP_GRANT_ACTION_KEYS);\nexport const awardGroupGrantStatusSchema = z.enum(AWARD_GROUP_GRANT_STATUS_KEYS);\n\nexport const awardGroupGrantDecisionSchema = revisionSchema;\n\nexport const AwardGroupGrantSchema = z\n  .strictObject({\n    grantId: z.string().min(1),\n    action: awardGroupGrantActionSchema,\n    awardId: awardIdSchema,\n    groupType: awardGroupTypeSchema,\n    groupId: documentIdSegmentSchema,\n    targetKey: z.string().min(1),\n    decision: awardGroupGrantDecisionSchema,\n    actorUid: userIdSchema,\n    status: awardGroupGrantStatusSchema,\n    createdAt: epochMsSchema,\n    completedAt: epochMsSchema.optional(),\n    attemptCount: countSchema,\n    nextAttemptAt: epochMsSchema,\n    lastError: z.string().optional(),\n  })\n  .superRefine((grant, ctx) => {\n    const targetKey = buildAwardGroupGrantTargetKey(grant);\n    if (grant.targetKey !== targetKey) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['targetKey'],\n        message: 'targetKey must be the award and group target key.',\n      });\n    }\n    if (grant.grantId !== buildAwardGroupGrantId(targetKey, grant.decision)) {\n      ctx.addIssue({\n        code: 'custom',\n        path: ['grantId'],\n        message: 'grantId must be the target key and the decision.',\n      });\n    }\n  });\nexport type AwardGroupGrant = z.infer<typeof AwardGroupGrantSchema>;\n\nexport function awardGroupGrantOpens(\n  latest: Pick<AwardGroupGrant, 'action'> | null,\n  action: AwardGroupGrant['action'],\n): boolean {\n  return action === 'grant' ? latest?.action !== 'grant' : latest?.action === 'grant';\n}\n\nexport const AwardGroupGrantPersonSchema = z.strictObject({\n  userId: userIdSchema,\n  heldBefore: z.boolean(),\n  recordedAt: epochMsSchema,\n  revoked: z.boolean(),\n  revokedAt: epochMsSchema.optional(),\n  revokeSkipped: z.enum(AWARD_GROUP_REVOKE_SKIP_KEYS).optional(),\n});\nexport type AwardGroupGrantPerson = z.infer<typeof AwardGroupGrantPersonSchema>;\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"catalogs.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/catalogs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,aAAa,aAA0B,CAAC;AAGrD,eAAO,MAAM,eAAe,wDAA2C,CAAC;AASxE,eAAO,MAAM,qBAAqB;;;;;;kBAMhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"catalogs.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/catalogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,aAAa,aAA0B,CAAC;AAErD,eAAO,MAAM,eAAe,wDAA2C,CAAC;AAExE,eAAO,MAAM,qBAAqB;;;;;;kBAMhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/doc-schemas/catalogs.js

@@ -1,21 +1,9 @@
-// The award catalog. Each award is its own document, keeping the id granted awards already
-// reference. The venue catalog is ./game-location.ts.
 import { z } from 'zod';
 import { AWARD_NAME_INPUT_FORMAT } from '../input-formats/input-formats.js';
 import { countSchema, documentIdSegmentSchema, epochMsSchema, textFieldSchema } from './atoms.js';
 import { pictureIdSchema } from './gallery.js';
-// An award's id, which every grant names and so never changes: an award created by its badge upload
-// takes that upload's staging id.
 export const awardIdSchema = documentIdSegmentSchema;
-// An award's name, as the catalog stores it and the creating upload sends it.
 export const awardNameSchema = textFieldSchema(AWARD_NAME_INPUT_FORMAT);
-// `awardDefinitions/{awardId}` — one award in the catalog. It is created by the publication of its
-// first badge, so an award created that way always has one; an award with no badge yet gets one from
-// the next badge upload for it. A badge is replaced only by a newer upload, never removed on its own.
-//
-// `holderCount` is how many accounts hold the award now. Every grant and revoke moves it in the
-// transaction that writes the grant, so a deletion — refused while anyone holds the award — and a
-// concurrent grant conflict on this document instead of racing past each other.
 export const AwardDefinitionSchema = z.strictObject({
     name: awardNameSchema,
     badgePictureId: pictureIdSchema.optional(),

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

@@ -1 +1 @@
-{"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../../src/doc-schemas/catalogs.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,sDAAsD;AAEtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,oGAAoG;AACpG,kCAAkC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAErD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,uBAAuB,CAAC,CAAC;AAExE,mGAAmG;AACnG,qGAAqG;AACrG,sGAAsG;AACtG,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,gFAAgF;AAChF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,YAAY,CAAC;IAClD,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC1C,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC","sourcesContent":["// The award catalog. Each award is its own document, keeping the id granted awards already\n// reference. The venue catalog is ./game-location.ts.\n\nimport { z } from 'zod';\nimport { AWARD_NAME_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema, textFieldSchema } from './atoms.js';\nimport { pictureIdSchema } from './gallery.js';\n\n// An award's id, which every grant names and so never changes: an award created by its badge upload\n// takes that upload's staging id.\nexport const awardIdSchema = documentIdSegmentSchema;\n\n// An award's name, as the catalog stores it and the creating upload sends it.\nexport const awardNameSchema = textFieldSchema(AWARD_NAME_INPUT_FORMAT);\n\n// `awardDefinitions/{awardId}` — one award in the catalog. It is created by the publication of its\n// first badge, so an award created that way always has one; an award with no badge yet gets one from\n// the next badge upload for it. A badge is replaced only by a newer upload, never removed on its own.\n//\n// `holderCount` is how many accounts hold the award now. Every grant and revoke moves it in the\n// transaction that writes the grant, so a deletion — refused while anyone holds the award — and a\n// concurrent grant conflict on this document instead of racing past each other.\nexport const AwardDefinitionSchema = z.strictObject({\n  name: awardNameSchema,\n  badgePictureId: pictureIdSchema.optional(),\n  holderCount: countSchema,\n  createdAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type AwardDefinition = z.infer<typeof AwardDefinitionSchema>;\n"]}
+{"version":3,"file":"catalogs.js","sourceRoot":"","sources":["../../src/doc-schemas/catalogs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,uBAAuB,CAAC;AAErD,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,uBAAuB,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,YAAY,CAAC;IAClD,IAAI,EAAE,eAAe;IACrB,cAAc,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC1C,WAAW,EAAE,WAAW;IACxB,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { AWARD_NAME_INPUT_FORMAT } from '../input-formats/input-formats.js';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema, textFieldSchema } from './atoms.js';\nimport { pictureIdSchema } from './gallery.js';\n\nexport const awardIdSchema = documentIdSegmentSchema;\n\nexport const awardNameSchema = textFieldSchema(AWARD_NAME_INPUT_FORMAT);\n\nexport const AwardDefinitionSchema = z.strictObject({\n  name: awardNameSchema,\n  badgePictureId: pictureIdSchema.optional(),\n  holderCount: countSchema,\n  createdAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type AwardDefinition = z.infer<typeof AwardDefinitionSchema>;\n"]}

package/dist/doc-schemas/firestore-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-primitives.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/firestore-primitives.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,IAAI,MAAM,CAAC;IACnB,MAAM,IAAI,IAAI,CAAC;CAChB;AAcD,eAAO,MAAM,wBAAwB,6DAEnC,CAAC"}
+{"version":3,"file":"firestore-primitives.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/firestore-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,IAAI,MAAM,CAAC;IACnB,MAAM,IAAI,IAAI,CAAC;CAChB;AAcD,eAAO,MAAM,wBAAwB,6DAEnC,CAAC"}

package/dist/doc-schemas/firestore-primitives.js

@@ -1,8 +1,3 @@
-// Structural model of a Firestore Timestamp, so this package imports neither Firebase SDK.
-//
-// Every persisted moment is an epoch-millisecond number (RULE-STD-ARCH-105), except a field a native-TTL
-// policy reads — the admin notification documents' `expireAt` — which the service honours only on a
-// real Timestamp.
 import { z } from 'zod';
 function isFirestoreTimestamp(value) {
     if (typeof value !== 'object' || value === null)

package/dist/doc-schemas/firestore-primitives.js.map

@@ -1 +1 @@
-{"version":3,"file":"firestore-primitives.js","sourceRoot":"","sources":["../../src/doc-schemas/firestore-primitives.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,EAAE;AACF,yGAAyG;AACzG,oGAAoG;AACpG,kBAAkB;AAElB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAwC,CAAC;IAC3D,OAAO,CACL,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;QACrC,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;QACzC,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU;QACxC,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU,CACvC,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAyB,oBAAoB,EAAE;IAC7F,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC","sourcesContent":["// Structural model of a Firestore Timestamp, so this package imports neither Firebase SDK.\n//\n// Every persisted moment is an epoch-millisecond number (RULE-STD-ARCH-105), except a field a native-TTL\n// policy reads — the admin notification documents' `expireAt` — which the service honours only on a\n// real Timestamp.\n\nimport { z } from 'zod';\n\nexport interface FirestoreTimestampLike {\n  seconds: number;\n  nanoseconds: number;\n  toMillis(): number;\n  toDate(): Date;\n}\n\nfunction isFirestoreTimestamp(value: unknown): value is FirestoreTimestampLike {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as Partial<FirestoreTimestampLike>;\n  return (\n    typeof candidate.seconds === 'number' &&\n    typeof candidate.nanoseconds === 'number' &&\n    typeof candidate.toMillis === 'function' &&\n    typeof candidate.toDate === 'function'\n  );\n}\n\n// z.custom validates without transforming, so a real Timestamp passes through with its methods.\nexport const FirestoreTimestampSchema = z.custom<FirestoreTimestampLike>(isFirestoreTimestamp, {\n  message: 'Expected a Firestore Timestamp',\n});\n"]}
+{"version":3,"file":"firestore-primitives.js","sourceRoot":"","sources":["../../src/doc-schemas/firestore-primitives.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,SAAS,oBAAoB,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAwC,CAAC;IAC3D,OAAO,CACL,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ;QACrC,OAAO,SAAS,CAAC,WAAW,KAAK,QAAQ;QACzC,OAAO,SAAS,CAAC,QAAQ,KAAK,UAAU;QACxC,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU,CACvC,CAAC;AACJ,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAyB,oBAAoB,EAAE;IAC7F,OAAO,EAAE,gCAAgC;CAC1C,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\n\nexport interface FirestoreTimestampLike {\n  seconds: number;\n  nanoseconds: number;\n  toMillis(): number;\n  toDate(): Date;\n}\n\nfunction isFirestoreTimestamp(value: unknown): value is FirestoreTimestampLike {\n  if (typeof value !== 'object' || value === null) return false;\n  const candidate = value as Partial<FirestoreTimestampLike>;\n  return (\n    typeof candidate.seconds === 'number' &&\n    typeof candidate.nanoseconds === 'number' &&\n    typeof candidate.toMillis === 'function' &&\n    typeof candidate.toDate === 'function'\n  );\n}\n\n// z.custom validates without transforming, so a real Timestamp passes through with its methods.\nexport const FirestoreTimestampSchema = z.custom<FirestoreTimestampLike>(isFirestoreTimestamp, {\n  message: 'Expected a Firestore Timestamp',\n});\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/gallery.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,sBAAsB;;;;;;EAAkC,CAAC;AACtE,eAAO,MAAM,sBAAsB;;;;EAAkC,CAAC;AAGtE,eAAO,MAAM,eAAe,aAAkB,CAAC;AAE/C,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAW/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;iBAW7B,CAAC;AACL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
+{"version":3,"file":"gallery.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/gallery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,sBAAsB;;;;;;EAAkC,CAAC;AACtE,eAAO,MAAM,sBAAsB;;;;EAAkC,CAAC;AAEtE,eAAO,MAAM,eAAe,aAAkB,CAAC;AAE/C,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAW7B,CAAC;AACL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,eAAO,MAAM,oBAAoB;;;;iBAS7B,CAAC;AACL,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/doc-schemas/gallery.js

@@ -1,34 +1,25 @@
-// Picture galleries — the league's, each team's, and the landing page's.
-//
-// Each picture in a gallery is its own `galleryPictures/{pictureId}` document, publicly readable
-// and written only by the picture core. The owner document carries its gallery's summary as its
-// optional `pictures` field: a card or a header reads the featured picture off the owner it
-// already holds, and `count` tells a display how many pictures there are without a count query.
-// An absent `pictures` field is an empty gallery, so no copy action or create core writes one.
 import { z } from 'zod';
 import { GALLERY_OWNER_KIND_KEYS, PICTURE_OWNER_KIND_KEYS } from '../types/picture-owners.js';
-import { countSchema, epochMsSchema, stagingIdSchema } from './atoms.js';
+import { isPictureOwnerId } from '../paths/picture-owner-paths.js';
+import { countSchema, documentIdSegmentSchema, epochMsSchema, stagingIdSchema } from './atoms.js';
 export const pictureOwnerKindSchema = z.enum(PICTURE_OWNER_KIND_KEYS);
 export const galleryOwnerKindSchema = z.enum(GALLERY_OWNER_KIND_KEYS);
-// A picture id is its upload's staging id; every stored size lives under it.
 export const pictureIdSchema = stagingIdSchema;
-export const GalleryPictureSchema = z.object({
+export const GalleryPictureSchema = z
+    .object({
     ownerKind: galleryOwnerKindSchema,
-    // The league or team id; the landing page's gallery uses `SPECIAL_DOCS.LANDING_PAGE`.
-    ownerId: z.string().min(1),
-    // A fractional sort key: a move rewrites only the moved picture's key, strictly between its new
-    // neighbours, and a gallery's first page is read ordered by it.
+    ownerId: documentIdSegmentSchema,
     position: z.string().min(1),
-    // Set only on a picture the migration carried from V1: its position in the V1 source list, which
-    // places a later-finishing carried picture among its carried neighbours in V1's order.
     sourceIndex: countSchema.optional(),
     createdAt: epochMsSchema,
+})
+    .refine((picture) => isPictureOwnerId(picture.ownerKind, picture.ownerId), {
+    message: 'Not an owner of that kind.',
+    path: ['ownerId'],
 });
 export const GallerySummarySchema = z
     .object({
-    // Exact: every gallery change rewrites the summary inside its own transaction.
     count: countSchema,
-    // Always one of the owner's pictures, so no reader needs a fallback rule.
     featuredPictureId: pictureIdSchema.optional(),
     updatedAt: epochMsSchema,
 })

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

@@ -1 +1 @@
-{"version":3,"file":"gallery.js","sourceRoot":"","sources":["../../src/doc-schemas/gallery.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,EAAE;AACF,iGAAiG;AACjG,gGAAgG;AAChG,4FAA4F;AAC5F,gGAAgG;AAChG,+FAA+F;AAE/F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAEtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,sBAAsB;IACjC,sFAAsF;IACtF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,gGAAgG;IAChG,gEAAgE;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,iGAAiG;IACjG,uFAAuF;IACvF,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,+EAA+E;IAC/E,KAAK,EAAE,WAAW;IAClB,0EAA0E;IAC1E,iBAAiB,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,aAAa;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,CAAC,EAAE;IACpF,OAAO,EAAE,uEAAuE;IAChF,IAAI,EAAE,CAAC,mBAAmB,CAAC;CAC5B,CAAC,CAAC","sourcesContent":["// Picture galleries — the league's, each team's, and the landing page's.\n//\n// Each picture in a gallery is its own `galleryPictures/{pictureId}` document, publicly readable\n// and written only by the picture core. The owner document carries its gallery's summary as its\n// optional `pictures` field: a card or a header reads the featured picture off the owner it\n// already holds, and `count` tells a display how many pictures there are without a count query.\n// An absent `pictures` field is an empty gallery, so no copy action or create core writes one.\n\nimport { z } from 'zod';\nimport { GALLERY_OWNER_KIND_KEYS, PICTURE_OWNER_KIND_KEYS } from '../types/picture-owners.js';\nimport { countSchema, epochMsSchema, stagingIdSchema } from './atoms.js';\n\nexport const pictureOwnerKindSchema = z.enum(PICTURE_OWNER_KIND_KEYS);\nexport const galleryOwnerKindSchema = z.enum(GALLERY_OWNER_KIND_KEYS);\n\n// A picture id is its upload's staging id; every stored size lives under it.\nexport const pictureIdSchema = stagingIdSchema;\n\nexport const GalleryPictureSchema = z.object({\n  ownerKind: galleryOwnerKindSchema,\n  // The league or team id; the landing page's gallery uses `SPECIAL_DOCS.LANDING_PAGE`.\n  ownerId: z.string().min(1),\n  // A fractional sort key: a move rewrites only the moved picture's key, strictly between its new\n  // neighbours, and a gallery's first page is read ordered by it.\n  position: z.string().min(1),\n  // Set only on a picture the migration carried from V1: its position in the V1 source list, which\n  // places a later-finishing carried picture among its carried neighbours in V1's order.\n  sourceIndex: countSchema.optional(),\n  createdAt: epochMsSchema,\n});\nexport type GalleryPicture = z.infer<typeof GalleryPictureSchema>;\n\nexport const GallerySummarySchema = z\n  .object({\n    // Exact: every gallery change rewrites the summary inside its own transaction.\n    count: countSchema,\n    // Always one of the owner's pictures, so no reader needs a fallback rule.\n    featuredPictureId: pictureIdSchema.optional(),\n    updatedAt: epochMsSchema,\n  })\n  .refine((summary) => summary.count > 0 === (summary.featuredPictureId !== undefined), {\n    message: 'featuredPictureId is present exactly when the gallery holds a picture',\n    path: ['featuredPictureId'],\n  });\nexport type GallerySummary = z.infer<typeof GallerySummarySchema>;\n"]}
+{"version":3,"file":"gallery.js","sourceRoot":"","sources":["../../src/doc-schemas/gallery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAEtE,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,uBAAuB;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,aAAa;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;IACzE,OAAO,EAAE,4BAA4B;IACrC,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CAAC,CAAC;AAGL,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC;KAClC,MAAM,CAAC;IACN,KAAK,EAAE,WAAW;IAClB,iBAAiB,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,aAAa;CACzB,CAAC;KACD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,CAAC,EAAE;IACpF,OAAO,EAAE,uEAAuE;IAChF,IAAI,EAAE,CAAC,mBAAmB,CAAC;CAC5B,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { GALLERY_OWNER_KIND_KEYS, PICTURE_OWNER_KIND_KEYS } from '../types/picture-owners.js';\nimport { isPictureOwnerId } from '../paths/picture-owner-paths.js';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema, stagingIdSchema } from './atoms.js';\n\nexport const pictureOwnerKindSchema = z.enum(PICTURE_OWNER_KIND_KEYS);\nexport const galleryOwnerKindSchema = z.enum(GALLERY_OWNER_KIND_KEYS);\n\nexport const pictureIdSchema = stagingIdSchema;\n\nexport const GalleryPictureSchema = z\n  .object({\n    ownerKind: galleryOwnerKindSchema,\n    ownerId: documentIdSegmentSchema,\n    position: z.string().min(1),\n    sourceIndex: countSchema.optional(),\n    createdAt: epochMsSchema,\n  })\n  .refine((picture) => isPictureOwnerId(picture.ownerKind, picture.ownerId), {\n    message: 'Not an owner of that kind.',\n    path: ['ownerId'],\n  });\nexport type GalleryPicture = z.infer<typeof GalleryPictureSchema>;\n\nexport const GallerySummarySchema = z\n  .object({\n    count: countSchema,\n    featuredPictureId: pictureIdSchema.optional(),\n    updatedAt: epochMsSchema,\n  })\n  .refine((summary) => summary.count > 0 === (summary.featuredPictureId !== undefined), {\n    message: 'featuredPictureId is present exactly when the gallery holds a picture',\n    path: ['featuredPictureId'],\n  });\nexport type GallerySummary = z.infer<typeof GallerySummarySchema>;\n"]}

package/dist/doc-schemas/game-location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-location.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/game-location.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB,aAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;iBAY7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,eAAO,MAAM,0BAA0B;;kBAErC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"game-location.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/game-location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,oBAAoB,aAA0B,CAAC;AAE5D,eAAO,MAAM,kBAAkB;;;;;;;;iBAQ7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,eAAO,MAAM,0BAA0B;;kBAErC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC"}

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

@@ -1,6 +1,3 @@
-// `gameLocations/{gameLocationId}` — one venue games are played at. Games name it by id
-// (`gameLocationId`) beside their own free-text label, so a game still reads correctly after its
-// venue is deleted.
 import { z } from 'zod';
 import { countSchema, documentIdSegmentSchema, epochMsSchema } from './atoms.js';
 import { pictureIdSchema } from './gallery.js';
@@ -8,20 +5,14 @@ export const gameLocationIdSchema = documentIdSegmentSchema;
 export const GameLocationSchema = z.object({
     name: z.string().min(1),
     streetAddress: z.string(),
-    // Courts, sheets, or rooms within the venue.
     subLocations: z.array(z.string()),
-    // Directions for players; absent when there are none.
     memo: z.string().min(1).optional(),
-    // The venue's picture. Only the picture pipeline writes it (RULE-STD-ARCH-001); the location callables
-    // write the fields above and never this one.
     pictureId: pictureIdSchema.optional(),
     createdAt: epochMsSchema,
     updatedAt: epochMsSchema,
 });
-// `_serverData/gameLocationRegistry` — the fence of the venue cap. Venue creation counts the venues
-// in its transaction against MAX_GAME_LOCATIONS, and a query does not lock against an insert, so each
-// creation advances `locationRevision` here: two creations at the cap conflict instead of both
-// passing (RULE-STD-BACKEND-116). Only its changing matters; absent until the first creation.
+// `_serverData/gameLocationRegistry` — the write fence of the venue cap (RULE-STD-BACKEND-116):
+// only its changing matters.
 export const GameLocationRegistrySchema = z.strictObject({
     locationRevision: countSchema,
 });

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

@@ -1 +1 @@
-{"version":3,"file":"game-location.js","sourceRoot":"","sources":["../../src/doc-schemas/game-location.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,iGAAiG;AACjG,oBAAoB;AAEpB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,6CAA6C;IAC7C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,sDAAsD;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,uGAAuG;IACvG,6CAA6C;IAC7C,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,oGAAoG;AACpG,sGAAsG;AACtG,+FAA+F;AAC/F,8FAA8F;AAC9F,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,YAAY,CAAC;IACvD,gBAAgB,EAAE,WAAW;CAC9B,CAAC,CAAC","sourcesContent":["// `gameLocations/{gameLocationId}` — one venue games are played at. Games name it by id\n// (`gameLocationId`) beside their own free-text label, so a game still reads correctly after its\n// venue is deleted.\n\nimport { z } from 'zod';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema } from './atoms.js';\nimport { pictureIdSchema } from './gallery.js';\n\nexport const gameLocationIdSchema = documentIdSegmentSchema;\n\nexport const GameLocationSchema = z.object({\n  name: z.string().min(1),\n  streetAddress: z.string(),\n  // Courts, sheets, or rooms within the venue.\n  subLocations: z.array(z.string()),\n  // Directions for players; absent when there are none.\n  memo: z.string().min(1).optional(),\n  // The venue's picture. Only the picture pipeline writes it (RULE-STD-ARCH-001); the location callables\n  // write the fields above and never this one.\n  pictureId: pictureIdSchema.optional(),\n  createdAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type GameLocation = z.infer<typeof GameLocationSchema>;\n\n// `_serverData/gameLocationRegistry` — the fence of the venue cap. Venue creation counts the venues\n// in its transaction against MAX_GAME_LOCATIONS, and a query does not lock against an insert, so each\n// creation advances `locationRevision` here: two creations at the cap conflict instead of both\n// passing (RULE-STD-BACKEND-116). Only its changing matters; absent until the first creation.\nexport const GameLocationRegistrySchema = z.strictObject({\n  locationRevision: countSchema,\n});\nexport type GameLocationRegistry = z.infer<typeof GameLocationRegistrySchema>;\n"]}
+{"version":3,"file":"game-location.js","sourceRoot":"","sources":["../../src/doc-schemas/game-location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,aAAa;IACxB,SAAS,EAAE,aAAa;CACzB,CAAC,CAAC;AAGH,gGAAgG;AAChG,6BAA6B;AAC7B,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,YAAY,CAAC;IACvD,gBAAgB,EAAE,WAAW;CAC9B,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { countSchema, documentIdSegmentSchema, epochMsSchema } from './atoms.js';\nimport { pictureIdSchema } from './gallery.js';\n\nexport const gameLocationIdSchema = documentIdSegmentSchema;\n\nexport const GameLocationSchema = z.object({\n  name: z.string().min(1),\n  streetAddress: z.string(),\n  subLocations: z.array(z.string()),\n  memo: z.string().min(1).optional(),\n  pictureId: pictureIdSchema.optional(),\n  createdAt: epochMsSchema,\n  updatedAt: epochMsSchema,\n});\nexport type GameLocation = z.infer<typeof GameLocationSchema>;\n\n// `_serverData/gameLocationRegistry` — the write fence of the venue cap (RULE-STD-BACKEND-116):\n// only its changing matters.\nexport const GameLocationRegistrySchema = z.strictObject({\n  locationRevision: countSchema,\n});\nexport type GameLocationRegistry = z.infer<typeof GameLocationRegistrySchema>;\n"]}

package/dist/doc-schemas/game-stat-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"game-stat-history.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/game-stat-history.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBASzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAIpG,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}
+{"version":3,"file":"game-stat-history.d.ts","sourceRoot":"","sources":["../../src/doc-schemas/game-stat-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,qCAAqC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAKhD,CAAC;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAIpG,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAGpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC"}

package/dist/doc-schemas/game-stat-history.js

@@ -1,25 +1,16 @@
-// `sportGames/{gameId}/gameStatHistory/{pageId}` — a completed game's finalized record: every event
-// document of the game, exactly as stored and in `sequence` order, in pages of up to
-// STAT_HISTORY_PAGE_SIZE, the page ids from `buildStatHistoryPageId(index)`.
-//
-// The first page also carries what finalize applied: the sport, the teams, and the participation
-// snapshot, so the record alone reproduces a completed game's contribution without the game
-// document a hand edit can reach (RULE-QS-SPORT-924). It exists exactly while the game is `completed`.
 import { z } from 'zod';
-import { STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';
+import { MAX_STAT_HISTORY_PAGES, STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';
 import { gameRosterPlayerIdSchema, leagueTypeSchema, teamIdSchema } from './atoms.js';
 import { GameStatEventSchema } from './game-stats.js';
 const pageEventsSchema = z
     .array(GameStatEventSchema)
     .max(STAT_HISTORY_PAGE_SIZE)
     .refine((events) => events.every((event, index) => index === 0 || events[index - 1].sequence < event.sequence), 'A page holds its events in sequence order.');
-// A game whose replay is its empty stats has a first page and no events.
 export const GameStatHistoryFirstPageSchema = z.strictObject({
     events: pageEventsSchema,
-    pageCount: z.number().int().positive(),
+    pageCount: z.number().int().positive().max(MAX_STAT_HISTORY_PAGES),
     leagueType: leagueTypeSchema,
     teamIds: z.array(teamIdSchema).min(1).max(2),
-    // The participation snapshot, as roster-entry ids.
     rosterPlayerIds: z.array(gameRosterPlayerIdSchema),
     absentRosterPlayerIds: z.array(gameRosterPlayerIdSchema),
     nonScoringRosterPlayerIds: z.array(gameRosterPlayerIdSchema),

package/dist/doc-schemas/game-stat-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"game-stat-history.js","sourceRoot":"","sources":["../../src/doc-schemas/game-stat-history.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,qFAAqF;AACrF,6EAA6E;AAC7E,EAAE;AACF,iGAAiG;AACjG,4FAA4F;AAC5F,uGAAuG;AAEvG,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,gBAAgB,GAAG,CAAC;KACvB,KAAK,CAAC,mBAAmB,CAAC;KAC1B,GAAG,CAAC,sBAAsB,CAAC;KAC3B,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,EAC5F,4CAA4C,CAC7C,CAAC;AAEJ,yEAAyE;AACzE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3D,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACtC,UAAU,EAAE,gBAAgB;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,mDAAmD;IACnD,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAClD,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IACxD,yBAAyB,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;CAC7D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,YAAY,CAAC;IAClE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAC7B,mCAAmC,CACpC;CACF,CAAC,CAAC;AAGH,mGAAmG;AACnG,+BAA+B;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/C,8BAA8B;IAC9B,qCAAqC;CACtC,CAAC,CAAC","sourcesContent":["// `sportGames/{gameId}/gameStatHistory/{pageId}` — a completed game's finalized record: every event\n// document of the game, exactly as stored and in `sequence` order, in pages of up to\n// STAT_HISTORY_PAGE_SIZE, the page ids from `buildStatHistoryPageId(index)`.\n//\n// The first page also carries what finalize applied: the sport, the teams, and the participation\n// snapshot, so the record alone reproduces a completed game's contribution without the game\n// document a hand edit can reach (RULE-QS-SPORT-924). It exists exactly while the game is `completed`.\n\nimport { z } from 'zod';\nimport { STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';\nimport { gameRosterPlayerIdSchema, leagueTypeSchema, teamIdSchema } from './atoms.js';\nimport { GameStatEventSchema } from './game-stats.js';\n\nconst pageEventsSchema = z\n  .array(GameStatEventSchema)\n  .max(STAT_HISTORY_PAGE_SIZE)\n  .refine(\n    (events) =>\n      events.every((event, index) => index === 0 || events[index - 1].sequence < event.sequence),\n    'A page holds its events in sequence order.',\n  );\n\n// A game whose replay is its empty stats has a first page and no events.\nexport const GameStatHistoryFirstPageSchema = z.strictObject({\n  events: pageEventsSchema,\n  pageCount: z.number().int().positive(),\n  leagueType: leagueTypeSchema,\n  teamIds: z.array(teamIdSchema).min(1).max(2),\n  // The participation snapshot, as roster-entry ids.\n  rosterPlayerIds: z.array(gameRosterPlayerIdSchema),\n  absentRosterPlayerIds: z.array(gameRosterPlayerIdSchema),\n  nonScoringRosterPlayerIds: z.array(gameRosterPlayerIdSchema),\n});\nexport type GameStatHistoryFirstPage = z.infer<typeof GameStatHistoryFirstPageSchema>;\n\nexport const GameStatHistoryContinuationPageSchema = z.strictObject({\n  events: pageEventsSchema.refine(\n    (events) => events.length > 0,\n    'A continuation page holds events.',\n  ),\n});\nexport type GameStatHistoryContinuationPage = z.infer<typeof GameStatHistoryContinuationPageSchema>;\n\n// Both page shapes are strict, so a first page missing part of its snapshot is refused rather than\n// read as a continuation page.\nexport const GameStatHistoryPageSchema = z.union([\n  GameStatHistoryFirstPageSchema,\n  GameStatHistoryContinuationPageSchema,\n]);\nexport type GameStatHistoryPage = z.infer<typeof GameStatHistoryPageSchema>;\n"]}
+{"version":3,"file":"game-stat-history.js","sourceRoot":"","sources":["../../src/doc-schemas/game-stat-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD,MAAM,gBAAgB,GAAG,CAAC;KACvB,KAAK,CAAC,mBAAmB,CAAC;KAC1B,GAAG,CAAC,sBAAsB,CAAC;KAC3B,MAAM,CACL,CAAC,MAAM,EAAE,EAAE,CACT,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,EAC5F,4CAA4C,CAC7C,CAAC;AAEJ,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,YAAY,CAAC;IAC3D,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC;IAClE,UAAU,EAAE,gBAAgB;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IAClD,qBAAqB,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;IACxD,yBAAyB,EAAE,CAAC,CAAC,KAAK,CAAC,wBAAwB,CAAC;CAC7D,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,YAAY,CAAC;IAClE,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAC7B,mCAAmC,CACpC;CACF,CAAC,CAAC;AAGH,mGAAmG;AACnG,+BAA+B;AAC/B,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC;IAC/C,8BAA8B;IAC9B,qCAAqC;CACtC,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { MAX_STAT_HISTORY_PAGES, STAT_HISTORY_PAGE_SIZE } from '../constants/sports.js';\nimport { gameRosterPlayerIdSchema, leagueTypeSchema, teamIdSchema } from './atoms.js';\nimport { GameStatEventSchema } from './game-stats.js';\n\nconst pageEventsSchema = z\n  .array(GameStatEventSchema)\n  .max(STAT_HISTORY_PAGE_SIZE)\n  .refine(\n    (events) =>\n      events.every((event, index) => index === 0 || events[index - 1].sequence < event.sequence),\n    'A page holds its events in sequence order.',\n  );\n\nexport const GameStatHistoryFirstPageSchema = z.strictObject({\n  events: pageEventsSchema,\n  pageCount: z.number().int().positive().max(MAX_STAT_HISTORY_PAGES),\n  leagueType: leagueTypeSchema,\n  teamIds: z.array(teamIdSchema).min(1).max(2),\n  rosterPlayerIds: z.array(gameRosterPlayerIdSchema),\n  absentRosterPlayerIds: z.array(gameRosterPlayerIdSchema),\n  nonScoringRosterPlayerIds: z.array(gameRosterPlayerIdSchema),\n});\nexport type GameStatHistoryFirstPage = z.infer<typeof GameStatHistoryFirstPageSchema>;\n\nexport const GameStatHistoryContinuationPageSchema = z.strictObject({\n  events: pageEventsSchema.refine(\n    (events) => events.length > 0,\n    'A continuation page holds events.',\n  ),\n});\nexport type GameStatHistoryContinuationPage = z.infer<typeof GameStatHistoryContinuationPageSchema>;\n\n// Both page shapes are strict, so a first page missing part of its snapshot is refused rather than\n// read as a continuation page.\nexport const GameStatHistoryPageSchema = z.union([\n  GameStatHistoryFirstPageSchema,\n  GameStatHistoryContinuationPageSchema,\n]);\nexport type GameStatHistoryPage = z.infer<typeof GameStatHistoryPageSchema>;\n"]}