@ttt-productions/q-core 0.1.28 → 0.1.30

package/dist/utils/app-config.d.ts

@@ -1,79 +1,26 @@
 import type { AppConfig } from '../doc-schemas/system.js';
-/** Every operator lever of `_appConfig/app`, each at a value its schema field accepts. */
 export type AppConfigLevers = Readonly<Required<AppConfig>>;
-/** The name of one operator lever. */
 export type AppConfigLeverKey = keyof AppConfigLevers;
-/** Every lever name, derived from the document schema. */
 export declare const APP_CONFIG_LEVER_KEYS: ("appVersion" | "maintenanceMode" | "maintenanceMessage" | "registrationEnabled" | "announcementMessage")[];
-/**
- * The document a fresh environment behaves as if it held, and the value each reader falls back to
- * for a missing or unreadable field: maintenance off, registration open, no banner.
- *
- * `appVersion` is `''` — no version has been published — so the version gate stays dormant until an
- * operator sets a real one through `updateAppConfig`, whose input refuses `''`.
- */
 export declare const DEFAULT_APP_CONFIG: AppConfigLevers;
-/**
- * The line shown while maintenance is on and the operator left `maintenanceMessage` blank — on the
- * maintenance screen and in the callable refusal alike.
- */
 export declare const DEFAULT_MAINTENANCE_MESSAGE = "Q-Sports is down for maintenance right now. We will be back shortly \u2014 thank you for your patience.";
-/**
- * The code the callable maintenance refusal is thrown with. `unavailable` is also what a real outage
- * produces, so the code alone never identifies the refusal — its details do.
- */
 export declare const MAINTENANCE_REFUSAL_CODE: "unavailable";
-/** The `details.reason` the callable maintenance refusal carries. */
 export declare const MAINTENANCE_REFUSAL_REASON: "maintenance";
-/** Structured details carried by the callable maintenance refusal. */
 export interface MaintenanceRefusalDetails {
     readonly reason: typeof MAINTENANCE_REFUSAL_REASON;
 }
-/** True when `details` is the maintenance refusal's structured details. */
 export declare function isMaintenanceRefusalDetails(details: unknown): details is MaintenanceRefusalDetails;
-/**
- * True when `err` is the callable maintenance refusal — an `unavailable` error in either spelling
- * whose details carry `reason: 'maintenance'`. Works on the server-side error and on the client-side
- * callable error alike, and is decided by the code and the details, never the message, so a genuine
- * outage is never mistaken for the designed refusal.
- */
 export declare function isMaintenanceRefusalError(err: unknown): boolean;
-/** A stored lever its schema field refused, with the raw value the document held. */
 export interface AppConfigLeverRepair {
     readonly lever: AppConfigLeverKey;
     readonly storedValue: unknown;
 }
-/** The document a writer writes, and every stored lever the merge had to repair to write it. */
 export interface AppConfigMerge {
     readonly next: AppConfig;
     readonly repairs: readonly AppConfigLeverRepair[];
 }
-/**
- * The complete `_appConfig/app` document to write after applying `update` to `existing` (the
- * document as read in the writer's transaction; `null` or `undefined` when it does not exist). The
- * update's fields win, `existing` supplies the rest, and any field still missing comes from
- * DEFAULT_APP_CONFIG. An `undefined` update field changes nothing. Pure.
- *
- * A stored lever its schema refuses never blocks a save — a console typo must not disable the
- * maintenance switch. It is dropped, so the update's value replaces it when the update sends that
- * lever and its DEFAULT_APP_CONFIG value (what every reader already falls back to) otherwise, and it
- * is reported in `repairs`. A valid stored lever is carried as it is.
- *
- * Throws when the update itself would not parse, so an invalid document is never written.
- */
 export declare function mergeAppConfigUpdate(existing: Readonly<Record<string, unknown>> | null | undefined, update: Readonly<Partial<AppConfig>>): AppConfigMerge;
-/**
- * One operator lever off an unvalidated `_appConfig/app` snapshot (`null` or `undefined` when the
- * document is missing or not yet read): the stored value when its schema field accepts it, otherwise
- * the lever's DEFAULT_APP_CONFIG value — for an absent field and a refused one alike. Never throws.
- */
 export declare function readAppConfigLever<L extends AppConfigLeverKey>(snapshot: Readonly<Record<string, unknown>> | null | undefined, lever: L): AppConfigLevers[L];
-/**
- * True when an unvalidated `_appConfig/app` snapshot holds `lever` with a value its schema field
- * refuses — the value every reader passes over for the default. An absent field is not refused.
- * Never throws.
- */
 export declare function isAppConfigLeverRefused(snapshot: Readonly<Record<string, unknown>> | null | undefined, lever: AppConfigLeverKey): boolean;
-/** Every lever off an unvalidated snapshot, each through `readAppConfigLever`. Never throws. */
 export declare function readAppConfigLevers(snapshot: Readonly<Record<string, unknown>> | null | undefined): AppConfigLevers;
 //# sourceMappingURL=app-config.d.ts.map

package/dist/utils/app-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../../src/utils/app-config.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,0FAA0F;AAC1F,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAE5D,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,MAAM,eAAe,CAAC;AAEtD,0DAA0D;AAC1D,eAAO,MAAM,qBAAqB,6GAAkC,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,eAM/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,2BAA2B,4GAC8D,CAAC;AAEvG;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAG,aAAsB,CAAC;AAE/D,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,EAAG,aAAsB,CAAC;AAEjE,sEAAsE;AACtE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,0BAA0B,CAAC;CACpD;AASD,2EAA2E;AAC3E,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,yBAAyB,CAGtC;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ/D;AAMD,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,gGAAgG;AAChG,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GACnC,cAAc,CAsBhB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,iBAAiB,EAC5D,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,KAAK,EAAE,CAAC,GACP,eAAe,CAAC,CAAC,CAAC,CAKpB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAGT;AAED,gGAAgG;AAChG,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7D,eAAe,CAMjB"}
+{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../../src/utils/app-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,MAAM,eAAe,CAAC;AAEtD,eAAO,MAAM,qBAAqB,6GAAkC,CAAC;AAErE,eAAO,MAAM,kBAAkB,EAAE,eAM/B,CAAC;AAEH,eAAO,MAAM,2BAA2B,4GAC8D,CAAC;AAEvG,eAAO,MAAM,wBAAwB,EAAG,aAAsB,CAAC;AAE/D,eAAO,MAAM,0BAA0B,EAAG,aAAsB,CAAC;AAEjE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,OAAO,0BAA0B,CAAC;CACpD;AASD,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,yBAAyB,CAGtC;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ/D;AAMD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACnD;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GACnC,cAAc,CAsBhB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,iBAAiB,EAC5D,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,KAAK,EAAE,CAAC,GACP,eAAe,CAAC,CAAC,CAAC,CAKpB;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,EAC9D,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAGT;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAC7D,eAAe,CAMjB"}

package/dist/utils/app-config.js

@@ -1,27 +1,5 @@
-// The `_appConfig/app` singleton at rest, and the one rule each for writing it and reading it.
-//
-// WRITE. `mergeAppConfigUpdate(existing, update)`: the writer's update on top of the document it
-// read, any field that document lacks — and any lever it holds at a value its schema refuses —
-// taken from DEFAULT_APP_CONFIG, the whole result validated. A writer that runs first on a fresh
-// environment therefore still writes a complete, valid document rather than a partial one, and a
-// hand edit in the console that broke one lever never blocks a save of another: the merge resets it
-// and reports the repair with the value it replaced, which the writer records.
-//
-// READ. The stored document is untrusted — an operator can edit any field in the console into any
-// shape — and a config read must never take the product down by itself. `readAppConfigLever`
-// answers one lever at a time: the stored value when its schema field accepts it, otherwise the
-// lever's DEFAULT_APP_CONFIG value, so one bad field never costs the good ones. The server's cached
-// snapshot reader and the client's readers both read through it.
 import { AppConfigSchema } from '../doc-schemas/system.js';
-/** Every lever name, derived from the document schema. */
 export const APP_CONFIG_LEVER_KEYS = AppConfigSchema.keyof().options;
-/**
- * The document a fresh environment behaves as if it held, and the value each reader falls back to
- * for a missing or unreadable field: maintenance off, registration open, no banner.
- *
- * `appVersion` is `''` — no version has been published — so the version gate stays dormant until an
- * operator sets a real one through `updateAppConfig`, whose input refuses `''`.
- */
 export const DEFAULT_APP_CONFIG = Object.freeze({
     appVersion: '',
     maintenanceMode: false,
@@ -29,17 +7,8 @@ export const DEFAULT_APP_CONFIG = Object.freeze({
     registrationEnabled: true,
     announcementMessage: '',
 });
-/**
- * The line shown while maintenance is on and the operator left `maintenanceMessage` blank — on the
- * maintenance screen and in the callable refusal alike.
- */
 export const DEFAULT_MAINTENANCE_MESSAGE = 'Q-Sports is down for maintenance right now. We will be back shortly — thank you for your patience.';
-/**
- * The code the callable maintenance refusal is thrown with. `unavailable` is also what a real outage
- * produces, so the code alone never identifies the refusal — its details do.
- */
 export const MAINTENANCE_REFUSAL_CODE = 'unavailable';
-/** The `details.reason` the callable maintenance refusal carries. */
 export const MAINTENANCE_REFUSAL_REASON = 'maintenance';
 // The refusal code as the server (`unavailable`) and the Firebase client SDK
 // (`functions/unavailable`) spell it.
@@ -47,18 +16,11 @@ const MAINTENANCE_REFUSAL_CODES = new Set([
     MAINTENANCE_REFUSAL_CODE,
     `functions/${MAINTENANCE_REFUSAL_CODE}`,
 ]);
-/** True when `details` is the maintenance refusal's structured details. */
 export function isMaintenanceRefusalDetails(details) {
     if (!details || typeof details !== 'object')
         return false;
     return details.reason === MAINTENANCE_REFUSAL_REASON;
 }
-/**
- * True when `err` is the callable maintenance refusal — an `unavailable` error in either spelling
- * whose details carry `reason: 'maintenance'`. Works on the server-side error and on the client-side
- * callable error alike, and is decided by the code and the details, never the message, so a genuine
- * outage is never mistaken for the designed refusal.
- */
 export function isMaintenanceRefusalError(err) {
     if (!err || typeof err !== 'object')
         return false;
@@ -70,19 +32,6 @@ export function isMaintenanceRefusalError(err) {
 function definedFields(fields) {
     return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));
 }
-/**
- * The complete `_appConfig/app` document to write after applying `update` to `existing` (the
- * document as read in the writer's transaction; `null` or `undefined` when it does not exist). The
- * update's fields win, `existing` supplies the rest, and any field still missing comes from
- * DEFAULT_APP_CONFIG. An `undefined` update field changes nothing. Pure.
- *
- * A stored lever its schema refuses never blocks a save — a console typo must not disable the
- * maintenance switch. It is dropped, so the update's value replaces it when the update sends that
- * lever and its DEFAULT_APP_CONFIG value (what every reader already falls back to) otherwise, and it
- * is reported in `repairs`. A valid stored lever is carried as it is.
- *
- * Throws when the update itself would not parse, so an invalid document is never written.
- */
 export function mergeAppConfigUpdate(existing, update) {
     const stored = definedFields(existing ?? {});
     const repairs = [];
@@ -104,27 +53,16 @@ export function mergeAppConfigUpdate(existing, update) {
     }
     return { next: parsed.data, repairs };
 }
-/**
- * One operator lever off an unvalidated `_appConfig/app` snapshot (`null` or `undefined` when the
- * document is missing or not yet read): the stored value when its schema field accepts it, otherwise
- * the lever's DEFAULT_APP_CONFIG value — for an absent field and a refused one alike. Never throws.
- */
 export function readAppConfigLever(snapshot, lever) {
     const parsed = AppConfigSchema.shape[lever].safeParse(snapshot?.[lever]);
     return parsed.success && parsed.data !== undefined
         ? parsed.data
         : DEFAULT_APP_CONFIG[lever];
 }
-/**
- * True when an unvalidated `_appConfig/app` snapshot holds `lever` with a value its schema field
- * refuses — the value every reader passes over for the default. An absent field is not refused.
- * Never throws.
- */
 export function isAppConfigLeverRefused(snapshot, lever) {
     const stored = snapshot?.[lever];
     return stored !== undefined && !AppConfigSchema.shape[lever].safeParse(stored).success;
 }
-/** Every lever off an unvalidated snapshot, each through `readAppConfigLever`. Never throws. */
 export function readAppConfigLevers(snapshot) {
     const levers = {};
     for (const lever of APP_CONFIG_LEVER_KEYS) {

package/dist/utils/app-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"app-config.js","sourceRoot":"","sources":["../../src/utils/app-config.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,EAAE;AACF,iGAAiG;AACjG,+FAA+F;AAC/F,iGAAiG;AACjG,iGAAiG;AACjG,oGAAoG;AACpG,+EAA+E;AAC/E,EAAE;AACF,kGAAkG;AAClG,6FAA6F;AAC7F,gGAAgG;AAChG,oGAAoG;AACpG,iEAAiE;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAS3D,0DAA0D;AAC1D,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAoB,MAAM,CAAC,MAAM,CAAC;IAC/D,UAAU,EAAE,EAAE;IACd,eAAe,EAAE,KAAK;IACtB,kBAAkB,EAAE,EAAE;IACtB,mBAAmB,EAAE,IAAI;IACzB,mBAAmB,EAAE,EAAE;CACxB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,oGAAoG,CAAC;AAEvG;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,aAAsB,CAAC;AAE/D,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAsB,CAAC;AAOjE,6EAA6E;AAC7E,sCAAsC;AACtC,MAAM,yBAAyB,GAAwB,IAAI,GAAG,CAAC;IAC7D,wBAAwB;IACxB,aAAa,wBAAwB,EAAE;CACxC,CAAC,CAAC;AAEH,2EAA2E;AAC3E,MAAM,UAAU,2BAA2B,CACzC,OAAgB;IAEhB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAQ,OAAmC,CAAC,MAAM,KAAK,0BAA0B,CAAC;AACpF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAY;IACpD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,SAAS,GAAG,GAA4C,CAAC;IAC/D,OAAO,CACL,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ;QAClC,yBAAyB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;QAC7C,2BAA2B,CAAC,SAAS,CAAC,OAAO,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,MAAyC;IAC9D,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;AAC/F,CAAC;AAcD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAA8D,EAC9D,MAAoC;IAEpC,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO;YACrF,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,MAAM,GAAG,eAAe,CAAC,SAAS,CAAC;QACvC,GAAG,kBAAkB;QACrB,GAAG,MAAM;QACT,GAAG,aAAa,CAAC,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,UAAU,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,gEAAgE,KAAK,KAAK,KAAK,EAAE,OAAO,IAAI,SAAS,+BAA+B,CACrI,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA8D,EAC9D,KAAQ;IAER,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAChD,CAAC,CAAE,MAAM,CAAC,IAA2B;QACrC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA8D,EAC9D,KAAwB;IAExB,MAAM,MAAM,GAAG,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO,MAAM,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;AACzF,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,mBAAmB,CACjC,QAA8D;IAE9D,MAAM,MAAM,GAAgD,EAAE,CAAC;IAC/D,KAAK,MAAM,KAAK,IAAI,qBAAqB,EAAE,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAyB,CAAC;AACnC,CAAC","sourcesContent":["// The `_appConfig/app` singleton at rest, and the one rule each for writing it and reading it.\n//\n// WRITE. `mergeAppConfigUpdate(existing, update)`: the writer's update on top of the document it\n// read, any field that document lacks — and any lever it holds at a value its schema refuses —\n// taken from DEFAULT_APP_CONFIG, the whole result validated. A writer that runs first on a fresh\n// environment therefore still writes a complete, valid document rather than a partial one, and a\n// hand edit in the console that broke one lever never blocks a save of another: the merge resets it\n// and reports the repair with the value it replaced, which the writer records.\n//\n// READ. The stored document is untrusted — an operator can edit any field in the console into any\n// shape — and a config read must never take the product down by itself. `readAppConfigLever`\n// answers one lever at a time: the stored value when its schema field accepts it, otherwise the\n// lever's DEFAULT_APP_CONFIG value, so one bad field never costs the good ones. The server's cached\n// snapshot reader and the client's readers both read through it.\n\nimport { AppConfigSchema } from '../doc-schemas/system.js';\nimport type { AppConfig } from '../doc-schemas/system.js';\n\n/** Every operator lever of `_appConfig/app`, each at a value its schema field accepts. */\nexport type AppConfigLevers = Readonly<Required<AppConfig>>;\n\n/** The name of one operator lever. */\nexport type AppConfigLeverKey = keyof AppConfigLevers;\n\n/** Every lever name, derived from the document schema. */\nexport const APP_CONFIG_LEVER_KEYS = AppConfigSchema.keyof().options;\n\n/**\n * The document a fresh environment behaves as if it held, and the value each reader falls back to\n * for a missing or unreadable field: maintenance off, registration open, no banner.\n *\n * `appVersion` is `''` — no version has been published — so the version gate stays dormant until an\n * operator sets a real one through `updateAppConfig`, whose input refuses `''`.\n */\nexport const DEFAULT_APP_CONFIG: AppConfigLevers = Object.freeze({\n  appVersion: '',\n  maintenanceMode: false,\n  maintenanceMessage: '',\n  registrationEnabled: true,\n  announcementMessage: '',\n});\n\n/**\n * The line shown while maintenance is on and the operator left `maintenanceMessage` blank — on the\n * maintenance screen and in the callable refusal alike.\n */\nexport const DEFAULT_MAINTENANCE_MESSAGE =\n  'Q-Sports is down for maintenance right now. We will be back shortly — thank you for your patience.';\n\n/**\n * The code the callable maintenance refusal is thrown with. `unavailable` is also what a real outage\n * produces, so the code alone never identifies the refusal — its details do.\n */\nexport const MAINTENANCE_REFUSAL_CODE = 'unavailable' as const;\n\n/** The `details.reason` the callable maintenance refusal carries. */\nexport const MAINTENANCE_REFUSAL_REASON = 'maintenance' as const;\n\n/** Structured details carried by the callable maintenance refusal. */\nexport interface MaintenanceRefusalDetails {\n  readonly reason: typeof MAINTENANCE_REFUSAL_REASON;\n}\n\n// The refusal code as the server (`unavailable`) and the Firebase client SDK\n// (`functions/unavailable`) spell it.\nconst MAINTENANCE_REFUSAL_CODES: ReadonlySet<string> = new Set([\n  MAINTENANCE_REFUSAL_CODE,\n  `functions/${MAINTENANCE_REFUSAL_CODE}`,\n]);\n\n/** True when `details` is the maintenance refusal's structured details. */\nexport function isMaintenanceRefusalDetails(\n  details: unknown,\n): details is MaintenanceRefusalDetails {\n  if (!details || typeof details !== 'object') return false;\n  return (details as Record<string, unknown>).reason === MAINTENANCE_REFUSAL_REASON;\n}\n\n/**\n * True when `err` is the callable maintenance refusal — an `unavailable` error in either spelling\n * whose details carry `reason: 'maintenance'`. Works on the server-side error and on the client-side\n * callable error alike, and is decided by the code and the details, never the message, so a genuine\n * outage is never mistaken for the designed refusal.\n */\nexport function isMaintenanceRefusalError(err: unknown): boolean {\n  if (!err || typeof err !== 'object') return false;\n  const candidate = err as { code?: unknown; details?: unknown };\n  return (\n    typeof candidate.code === 'string' &&\n    MAINTENANCE_REFUSAL_CODES.has(candidate.code) &&\n    isMaintenanceRefusalDetails(candidate.details)\n  );\n}\n\nfunction definedFields(fields: Readonly<Record<string, unknown>>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));\n}\n\n/** A stored lever its schema field refused, with the raw value the document held. */\nexport interface AppConfigLeverRepair {\n  readonly lever: AppConfigLeverKey;\n  readonly storedValue: unknown;\n}\n\n/** The document a writer writes, and every stored lever the merge had to repair to write it. */\nexport interface AppConfigMerge {\n  readonly next: AppConfig;\n  readonly repairs: readonly AppConfigLeverRepair[];\n}\n\n/**\n * The complete `_appConfig/app` document to write after applying `update` to `existing` (the\n * document as read in the writer's transaction; `null` or `undefined` when it does not exist). The\n * update's fields win, `existing` supplies the rest, and any field still missing comes from\n * DEFAULT_APP_CONFIG. An `undefined` update field changes nothing. Pure.\n *\n * A stored lever its schema refuses never blocks a save — a console typo must not disable the\n * maintenance switch. It is dropped, so the update's value replaces it when the update sends that\n * lever and its DEFAULT_APP_CONFIG value (what every reader already falls back to) otherwise, and it\n * is reported in `repairs`. A valid stored lever is carried as it is.\n *\n * Throws when the update itself would not parse, so an invalid document is never written.\n */\nexport function mergeAppConfigUpdate(\n  existing: Readonly<Record<string, unknown>> | null | undefined,\n  update: Readonly<Partial<AppConfig>>,\n): AppConfigMerge {\n  const stored = definedFields(existing ?? {});\n  const repairs: AppConfigLeverRepair[] = [];\n  for (const lever of APP_CONFIG_LEVER_KEYS) {\n    if (!(lever in stored) || AppConfigSchema.shape[lever].safeParse(stored[lever]).success)\n      continue;\n    repairs.push({ lever, storedValue: stored[lever] });\n    delete stored[lever];\n  }\n  const parsed = AppConfigSchema.safeParse({\n    ...DEFAULT_APP_CONFIG,\n    ...stored,\n    ...definedFields(update),\n  });\n  if (!parsed.success) {\n    const issue = parsed.error.issues[0];\n    const field = issue?.path.join('.') || 'document';\n    throw new Error(\n      `_appConfig/app would not match its schema after this update (${field}: ${issue?.message ?? 'invalid'}). Nothing should be written.`,\n    );\n  }\n  return { next: parsed.data, repairs };\n}\n\n/**\n * One operator lever off an unvalidated `_appConfig/app` snapshot (`null` or `undefined` when the\n * document is missing or not yet read): the stored value when its schema field accepts it, otherwise\n * the lever's DEFAULT_APP_CONFIG value — for an absent field and a refused one alike. Never throws.\n */\nexport function readAppConfigLever<L extends AppConfigLeverKey>(\n  snapshot: Readonly<Record<string, unknown>> | null | undefined,\n  lever: L,\n): AppConfigLevers[L] {\n  const parsed = AppConfigSchema.shape[lever].safeParse(snapshot?.[lever]);\n  return parsed.success && parsed.data !== undefined\n    ? (parsed.data as AppConfigLevers[L])\n    : DEFAULT_APP_CONFIG[lever];\n}\n\n/**\n * True when an unvalidated `_appConfig/app` snapshot holds `lever` with a value its schema field\n * refuses — the value every reader passes over for the default. An absent field is not refused.\n * Never throws.\n */\nexport function isAppConfigLeverRefused(\n  snapshot: Readonly<Record<string, unknown>> | null | undefined,\n  lever: AppConfigLeverKey,\n): boolean {\n  const stored = snapshot?.[lever];\n  return stored !== undefined && !AppConfigSchema.shape[lever].safeParse(stored).success;\n}\n\n/** Every lever off an unvalidated snapshot, each through `readAppConfigLever`. Never throws. */\nexport function readAppConfigLevers(\n  snapshot: Readonly<Record<string, unknown>> | null | undefined,\n): AppConfigLevers {\n  const levers: Partial<Record<AppConfigLeverKey, unknown>> = {};\n  for (const lever of APP_CONFIG_LEVER_KEYS) {\n    levers[lever] = readAppConfigLever(snapshot, lever);\n  }\n  return levers as AppConfigLevers;\n}\n"]}
+{"version":3,"file":"app-config.js","sourceRoot":"","sources":["../../src/utils/app-config.ts"],"names":[],"mappings":"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","sourcesContent":["import { AppConfigSchema } from '../doc-schemas/system.js';\nimport type { AppConfig } from '../doc-schemas/system.js';\n\nexport type AppConfigLevers = Readonly<Required<AppConfig>>;\n\nexport type AppConfigLeverKey = keyof AppConfigLevers;\n\nexport const APP_CONFIG_LEVER_KEYS = AppConfigSchema.keyof().options;\n\nexport const DEFAULT_APP_CONFIG: AppConfigLevers = Object.freeze({\n  appVersion: '',\n  maintenanceMode: false,\n  maintenanceMessage: '',\n  registrationEnabled: true,\n  announcementMessage: '',\n});\n\nexport const DEFAULT_MAINTENANCE_MESSAGE =\n  'Q-Sports is down for maintenance right now. We will be back shortly — thank you for your patience.';\n\nexport const MAINTENANCE_REFUSAL_CODE = 'unavailable' as const;\n\nexport const MAINTENANCE_REFUSAL_REASON = 'maintenance' as const;\n\nexport interface MaintenanceRefusalDetails {\n  readonly reason: typeof MAINTENANCE_REFUSAL_REASON;\n}\n\n// The refusal code as the server (`unavailable`) and the Firebase client SDK\n// (`functions/unavailable`) spell it.\nconst MAINTENANCE_REFUSAL_CODES: ReadonlySet<string> = new Set([\n  MAINTENANCE_REFUSAL_CODE,\n  `functions/${MAINTENANCE_REFUSAL_CODE}`,\n]);\n\nexport function isMaintenanceRefusalDetails(\n  details: unknown,\n): details is MaintenanceRefusalDetails {\n  if (!details || typeof details !== 'object') return false;\n  return (details as Record<string, unknown>).reason === MAINTENANCE_REFUSAL_REASON;\n}\n\nexport function isMaintenanceRefusalError(err: unknown): boolean {\n  if (!err || typeof err !== 'object') return false;\n  const candidate = err as { code?: unknown; details?: unknown };\n  return (\n    typeof candidate.code === 'string' &&\n    MAINTENANCE_REFUSAL_CODES.has(candidate.code) &&\n    isMaintenanceRefusalDetails(candidate.details)\n  );\n}\n\nfunction definedFields(fields: Readonly<Record<string, unknown>>): Record<string, unknown> {\n  return Object.fromEntries(Object.entries(fields).filter(([, value]) => value !== undefined));\n}\n\nexport interface AppConfigLeverRepair {\n  readonly lever: AppConfigLeverKey;\n  readonly storedValue: unknown;\n}\n\nexport interface AppConfigMerge {\n  readonly next: AppConfig;\n  readonly repairs: readonly AppConfigLeverRepair[];\n}\n\nexport function mergeAppConfigUpdate(\n  existing: Readonly<Record<string, unknown>> | null | undefined,\n  update: Readonly<Partial<AppConfig>>,\n): AppConfigMerge {\n  const stored = definedFields(existing ?? {});\n  const repairs: AppConfigLeverRepair[] = [];\n  for (const lever of APP_CONFIG_LEVER_KEYS) {\n    if (!(lever in stored) || AppConfigSchema.shape[lever].safeParse(stored[lever]).success)\n      continue;\n    repairs.push({ lever, storedValue: stored[lever] });\n    delete stored[lever];\n  }\n  const parsed = AppConfigSchema.safeParse({\n    ...DEFAULT_APP_CONFIG,\n    ...stored,\n    ...definedFields(update),\n  });\n  if (!parsed.success) {\n    const issue = parsed.error.issues[0];\n    const field = issue?.path.join('.') || 'document';\n    throw new Error(\n      `_appConfig/app would not match its schema after this update (${field}: ${issue?.message ?? 'invalid'}). Nothing should be written.`,\n    );\n  }\n  return { next: parsed.data, repairs };\n}\n\nexport function readAppConfigLever<L extends AppConfigLeverKey>(\n  snapshot: Readonly<Record<string, unknown>> | null | undefined,\n  lever: L,\n): AppConfigLevers[L] {\n  const parsed = AppConfigSchema.shape[lever].safeParse(snapshot?.[lever]);\n  return parsed.success && parsed.data !== undefined\n    ? (parsed.data as AppConfigLevers[L])\n    : DEFAULT_APP_CONFIG[lever];\n}\n\nexport function isAppConfigLeverRefused(\n  snapshot: Readonly<Record<string, unknown>> | null | undefined,\n  lever: AppConfigLeverKey,\n): boolean {\n  const stored = snapshot?.[lever];\n  return stored !== undefined && !AppConfigSchema.shape[lever].safeParse(stored).success;\n}\n\nexport function readAppConfigLevers(\n  snapshot: Readonly<Record<string, unknown>> | null | undefined,\n): AppConfigLevers {\n  const levers: Partial<Record<AppConfigLeverKey, unknown>> = {};\n  for (const lever of APP_CONFIG_LEVER_KEYS) {\n    levers[lever] = readAppConfigLever(snapshot, lever);\n  }\n  return levers as AppConfigLevers;\n}\n"]}

package/dist/utils/display-name.d.ts

@@ -1,11 +1,4 @@
 export declare function normalizeDisplayName(displayName: string): string;
-/**
- * The `reservedDisplayNames` document id for a display name. Uniqueness is case-insensitive, so the
- * key is built from the lowercase form. It is percent-encoded because a name may hold a `/`, which
- * a document id cannot, and prefixed because percent-encoding leaves `_` and `.` alone — without
- * the prefix the name `__a__` would be an id Firestore reserves (`__.*__`) and rejects.
- */
 export declare function toReservedDisplayNameKey(displayName: string): string;
-/** The value stored in `displayName_lowercase`, which powers prefix search and uniqueness checks. */
 export declare function toDisplayNameLowercase(displayName: string): string;
 //# sourceMappingURL=display-name.d.ts.map

package/dist/utils/display-name.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"display-name.d.ts","sourceRoot":"","sources":["../../src/utils/display-name.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAID;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,qGAAqG;AACrG,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE"}
+{"version":3,"file":"display-name.d.ts","sourceRoot":"","sources":["../../src/utils/display-name.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEhE;AAID,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAElE"}

package/dist/utils/display-name.js

@@ -1,18 +1,10 @@
-// Display-name normalization shared by every writer of `displayName` / `displayName_lowercase`.
 export function normalizeDisplayName(displayName) {
     return displayName.trim();
 }
 const RESERVED_DISPLAY_NAME_KEY_PREFIX = 'name_';
-/**
- * The `reservedDisplayNames` document id for a display name. Uniqueness is case-insensitive, so the
- * key is built from the lowercase form. It is percent-encoded because a name may hold a `/`, which
- * a document id cannot, and prefixed because percent-encoding leaves `_` and `.` alone — without
- * the prefix the name `__a__` would be an id Firestore reserves (`__.*__`) and rejects.
- */
 export function toReservedDisplayNameKey(displayName) {
     return RESERVED_DISPLAY_NAME_KEY_PREFIX + encodeURIComponent(toDisplayNameLowercase(displayName));
 }
-/** The value stored in `displayName_lowercase`, which powers prefix search and uniqueness checks. */
 export function toDisplayNameLowercase(displayName) {
     return normalizeDisplayName(displayName).toLowerCase();
 }

package/dist/utils/display-name.js.map

@@ -1 +1 @@
-{"version":3,"file":"display-name.js","sourceRoot":"","sources":["../../src/utils/display-name.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAEhG,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,gCAAgC,GAAG,kBAAkB,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;AACzD,CAAC","sourcesContent":["// Display-name normalization shared by every writer of `displayName` / `displayName_lowercase`.\n\nexport function normalizeDisplayName(displayName: string): string {\n  return displayName.trim();\n}\n\nconst RESERVED_DISPLAY_NAME_KEY_PREFIX = 'name_';\n\n/**\n * The `reservedDisplayNames` document id for a display name. Uniqueness is case-insensitive, so the\n * key is built from the lowercase form. It is percent-encoded because a name may hold a `/`, which\n * a document id cannot, and prefixed because percent-encoding leaves `_` and `.` alone — without\n * the prefix the name `__a__` would be an id Firestore reserves (`__.*__`) and rejects.\n */\nexport function toReservedDisplayNameKey(displayName: string): string {\n  return RESERVED_DISPLAY_NAME_KEY_PREFIX + encodeURIComponent(toDisplayNameLowercase(displayName));\n}\n\n/** The value stored in `displayName_lowercase`, which powers prefix search and uniqueness checks. */\nexport function toDisplayNameLowercase(displayName: string): string {\n  return normalizeDisplayName(displayName).toLowerCase();\n}\n"]}
+{"version":3,"file":"display-name.js","sourceRoot":"","sources":["../../src/utils/display-name.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,gCAAgC,GAAG,OAAO,CAAC;AAEjD,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,gCAAgC,GAAG,kBAAkB,CAAC,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC;AACzD,CAAC","sourcesContent":["export function normalizeDisplayName(displayName: string): string {\n  return displayName.trim();\n}\n\nconst RESERVED_DISPLAY_NAME_KEY_PREFIX = 'name_';\n\nexport function toReservedDisplayNameKey(displayName: string): string {\n  return RESERVED_DISPLAY_NAME_KEY_PREFIX + encodeURIComponent(toDisplayNameLowercase(displayName));\n}\n\nexport function toDisplayNameLowercase(displayName: string): string {\n  return normalizeDisplayName(displayName).toLowerCase();\n}\n"]}

package/dist/utils/index.d.ts

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

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

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

package/dist/utils/index.js

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

package/dist/utils/index.js.map

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

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

@@ -1,16 +1,5 @@
-/** The calendar date an instant falls on in LEAGUE_TIME_ZONE. */
 export declare function toLeagueDayKey(epochMs: number): string;
-/**
- * The calendar date `days` days after `dayKey` (before it, when negative). Pure calendar arithmetic
- * on the date itself, so no time zone or daylight-saving change moves it.
- */
 export declare function addCalendarDays(dayKey: string, days: number): string;
-/** The time of day an instant falls at in LEAGUE_TIME_ZONE, as `HH:MM` on a 24-hour clock. */
 export declare function toLeagueTimeOfDay(epochMs: number): string;
-/**
- * The instant a calendar day and a time of day (`HH:MM`, 24-hour) name in LEAGUE_TIME_ZONE, in epoch
- * milliseconds. The zone's offset is read at the instant itself, so a day on either side of a
- * daylight-saving change reads its own offset. Throws on a day or a time that is not one.
- */
 export declare function leagueInstantOf(dayKey: string, timeOfDay: string): number;
 //# sourceMappingURL=league-calendar.d.ts.map

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

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

package/dist/utils/league-calendar.js

@@ -1,8 +1,3 @@
-// Calendar days and times of day in the leagues' own time zone. A league's dates and a game's `dayKey`
-// are calendar dates with no time or zone (`YYYY-MM-DD`), so "today" is read in LEAGUE_TIME_ZONE and
-// every comparison is between two calendar dates, never between instants. A game's start is an
-// instant, entered and shown as a day and a time of day (`HH:MM`) in LEAGUE_TIME_ZONE, whatever the
-// zone of the browser it is entered in.
 import { LEAGUE_TIME_ZONE } from '../constants/business.js';
 // `en-CA` formats a date as `YYYY-MM-DD`, the stored calendar-date shape.
 const LEAGUE_DAY_FORMAT = new Intl.DateTimeFormat('en-CA', {
@@ -12,14 +7,9 @@ const LEAGUE_DAY_FORMAT = new Intl.DateTimeFormat('en-CA', {
     day: '2-digit',
 });
 const DAY_MS = 24 * 60 * 60 * 1000;
-/** The calendar date an instant falls on in LEAGUE_TIME_ZONE. */
 export function toLeagueDayKey(epochMs) {
     return LEAGUE_DAY_FORMAT.format(new Date(epochMs));
 }
-/**
- * The calendar date `days` days after `dayKey` (before it, when negative). Pure calendar arithmetic
- * on the date itself, so no time zone or daylight-saving change moves it.
- */
 export function addCalendarDays(dayKey, days) {
     const day = new Date(`${dayKey}T00:00:00.000Z`);
     if (Number.isNaN(day.getTime())) {
@@ -27,7 +17,7 @@ export function addCalendarDays(dayKey, days) {
     }
     return new Date(day.getTime() + days * DAY_MS).toISOString().slice(0, 10);
 }
-// Every part of an instant's wall-clock reading in LEAGUE_TIME_ZONE. `h23` keeps midnight at hour 0.
+// `h23` keeps midnight at hour 0.
 const LEAGUE_WALL_CLOCK_FORMAT = new Intl.DateTimeFormat('en-US', {
     timeZone: LEAGUE_TIME_ZONE,
     hourCycle: 'h23',
@@ -40,7 +30,6 @@ const LEAGUE_WALL_CLOCK_FORMAT = new Intl.DateTimeFormat('en-US', {
 });
 const CALENDAR_DAY_SHAPE = /^(\d{4})-(\d{2})-(\d{2})$/;
 const TIME_OF_DAY_SHAPE = /^([01]\d|2[0-3]):([0-5]\d)$/;
-/** The instant's wall-clock reading in LEAGUE_TIME_ZONE, written as if that reading were UTC. */
 function leagueWallClockAsUtc(epochMs) {
     const parts = Object.fromEntries(LEAGUE_WALL_CLOCK_FORMAT.formatToParts(new Date(epochMs)).map((part) => [
         part.type,
@@ -48,18 +37,12 @@ function leagueWallClockAsUtc(epochMs) {
     ]));
     return Date.UTC(Number(parts.year), Number(parts.month) - 1, Number(parts.day), Number(parts.hour), Number(parts.minute), Number(parts.second));
 }
-/** The time of day an instant falls at in LEAGUE_TIME_ZONE, as `HH:MM` on a 24-hour clock. */
 export function toLeagueTimeOfDay(epochMs) {
     const wallClock = new Date(leagueWallClockAsUtc(epochMs));
     const hours = String(wallClock.getUTCHours()).padStart(2, '0');
     const minutes = String(wallClock.getUTCMinutes()).padStart(2, '0');
     return `${hours}:${minutes}`;
 }
-/**
- * The instant a calendar day and a time of day (`HH:MM`, 24-hour) name in LEAGUE_TIME_ZONE, in epoch
- * milliseconds. The zone's offset is read at the instant itself, so a day on either side of a
- * daylight-saving change reads its own offset. Throws on a day or a time that is not one.
- */
 export function leagueInstantOf(dayKey, timeOfDay) {
     const day = CALENDAR_DAY_SHAPE.exec(dayKey);
     const time = TIME_OF_DAY_SHAPE.exec(timeOfDay);
@@ -72,6 +55,11 @@ export function leagueInstantOf(dayKey, timeOfDay) {
     // The offset at the wall-clock reading taken as UTC is within a day of the right one; read again at
     // the instant that offset gives, so a reading on the other side of a change settles on its own.
     const firstGuess = wallClock - (leagueWallClockAsUtc(wallClock) - wallClock);
-    return wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);
+    const instant = wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);
+    // A reading the clocks skip forward over settles on another hour; only a real one reads back.
+    if (toLeagueDayKey(instant) !== dayKey || toLeagueTimeOfDay(instant) !== timeOfDay) {
+        throw new RangeError(`Not a time the league's clocks show: '${dayKey}' '${timeOfDay}'.`);
+    }
+    return instant;
 }
 //# sourceMappingURL=league-calendar.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"league-calendar.js","sourceRoot":"","sources":["../../src/utils/league-calendar.ts"],"names":[],"mappings":"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","sourcesContent":["// Calendar days and times of day in the leagues' own time zone. A league's dates and a game's `dayKey`\n// are calendar dates with no time or zone (`YYYY-MM-DD`), so \"today\" is read in LEAGUE_TIME_ZONE and\n// every comparison is between two calendar dates, never between instants. A game's start is an\n// instant, entered and shown as a day and a time of day (`HH:MM`) in LEAGUE_TIME_ZONE, whatever the\n// zone of the browser it is entered in.\n\nimport { LEAGUE_TIME_ZONE } from '../constants/business.js';\n\n// `en-CA` formats a date as `YYYY-MM-DD`, the stored calendar-date shape.\nconst LEAGUE_DAY_FORMAT = new Intl.DateTimeFormat('en-CA', {\n  timeZone: LEAGUE_TIME_ZONE,\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n});\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\n/** The calendar date an instant falls on in LEAGUE_TIME_ZONE. */\nexport function toLeagueDayKey(epochMs: number): string {\n  return LEAGUE_DAY_FORMAT.format(new Date(epochMs));\n}\n\n/**\n * The calendar date `days` days after `dayKey` (before it, when negative). Pure calendar arithmetic\n * on the date itself, so no time zone or daylight-saving change moves it.\n */\nexport function addCalendarDays(dayKey: string, days: number): string {\n  const day = new Date(`${dayKey}T00:00:00.000Z`);\n  if (Number.isNaN(day.getTime())) {\n    throw new RangeError(`Not a calendar date: '${dayKey}'.`);\n  }\n  return new Date(day.getTime() + days * DAY_MS).toISOString().slice(0, 10);\n}\n\n// Every part of an instant's wall-clock reading in LEAGUE_TIME_ZONE. `h23` keeps midnight at hour 0.\nconst LEAGUE_WALL_CLOCK_FORMAT = new Intl.DateTimeFormat('en-US', {\n  timeZone: LEAGUE_TIME_ZONE,\n  hourCycle: 'h23',\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n  hour: '2-digit',\n  minute: '2-digit',\n  second: '2-digit',\n});\n\nconst CALENDAR_DAY_SHAPE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst TIME_OF_DAY_SHAPE = /^([01]\\d|2[0-3]):([0-5]\\d)$/;\n\n/** The instant's wall-clock reading in LEAGUE_TIME_ZONE, written as if that reading were UTC. */\nfunction leagueWallClockAsUtc(epochMs: number): number {\n  const parts = Object.fromEntries(\n    LEAGUE_WALL_CLOCK_FORMAT.formatToParts(new Date(epochMs)).map((part) => [\n      part.type,\n      part.value,\n    ]),\n  );\n  return Date.UTC(\n    Number(parts.year),\n    Number(parts.month) - 1,\n    Number(parts.day),\n    Number(parts.hour),\n    Number(parts.minute),\n    Number(parts.second),\n  );\n}\n\n/** The time of day an instant falls at in LEAGUE_TIME_ZONE, as `HH:MM` on a 24-hour clock. */\nexport function toLeagueTimeOfDay(epochMs: number): string {\n  const wallClock = new Date(leagueWallClockAsUtc(epochMs));\n  const hours = String(wallClock.getUTCHours()).padStart(2, '0');\n  const minutes = String(wallClock.getUTCMinutes()).padStart(2, '0');\n  return `${hours}:${minutes}`;\n}\n\n/**\n * The instant a calendar day and a time of day (`HH:MM`, 24-hour) name in LEAGUE_TIME_ZONE, in epoch\n * milliseconds. The zone's offset is read at the instant itself, so a day on either side of a\n * daylight-saving change reads its own offset. Throws on a day or a time that is not one.\n */\nexport function leagueInstantOf(dayKey: string, timeOfDay: string): number {\n  const day = CALENDAR_DAY_SHAPE.exec(dayKey);\n  const time = TIME_OF_DAY_SHAPE.exec(timeOfDay);\n  if (!day || !time)\n    throw new RangeError(`Not a calendar day and time of day: '${dayKey}' '${timeOfDay}'.`);\n  const wallClock = Date.UTC(\n    Number(day[1]),\n    Number(day[2]) - 1,\n    Number(day[3]),\n    Number(time[1]),\n    Number(time[2]),\n  );\n  if (new Date(wallClock).toISOString().slice(0, 10) !== dayKey) {\n    throw new RangeError(`Not a calendar day: '${dayKey}'.`);\n  }\n  // The offset at the wall-clock reading taken as UTC is within a day of the right one; read again at\n  // the instant that offset gives, so a reading on the other side of a change settles on its own.\n  const firstGuess = wallClock - (leagueWallClockAsUtc(wallClock) - wallClock);\n  return wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);\n}\n"]}
+{"version":3,"file":"league-calendar.js","sourceRoot":"","sources":["../../src/utils/league-calendar.ts"],"names":[],"mappings":"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","sourcesContent":["import { LEAGUE_TIME_ZONE } from '../constants/business.js';\n\n// `en-CA` formats a date as `YYYY-MM-DD`, the stored calendar-date shape.\nconst LEAGUE_DAY_FORMAT = new Intl.DateTimeFormat('en-CA', {\n  timeZone: LEAGUE_TIME_ZONE,\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n});\n\nconst DAY_MS = 24 * 60 * 60 * 1000;\n\nexport function toLeagueDayKey(epochMs: number): string {\n  return LEAGUE_DAY_FORMAT.format(new Date(epochMs));\n}\n\nexport function addCalendarDays(dayKey: string, days: number): string {\n  const day = new Date(`${dayKey}T00:00:00.000Z`);\n  if (Number.isNaN(day.getTime())) {\n    throw new RangeError(`Not a calendar date: '${dayKey}'.`);\n  }\n  return new Date(day.getTime() + days * DAY_MS).toISOString().slice(0, 10);\n}\n\n// `h23` keeps midnight at hour 0.\nconst LEAGUE_WALL_CLOCK_FORMAT = new Intl.DateTimeFormat('en-US', {\n  timeZone: LEAGUE_TIME_ZONE,\n  hourCycle: 'h23',\n  year: 'numeric',\n  month: '2-digit',\n  day: '2-digit',\n  hour: '2-digit',\n  minute: '2-digit',\n  second: '2-digit',\n});\n\nconst CALENDAR_DAY_SHAPE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst TIME_OF_DAY_SHAPE = /^([01]\\d|2[0-3]):([0-5]\\d)$/;\n\nfunction leagueWallClockAsUtc(epochMs: number): number {\n  const parts = Object.fromEntries(\n    LEAGUE_WALL_CLOCK_FORMAT.formatToParts(new Date(epochMs)).map((part) => [\n      part.type,\n      part.value,\n    ]),\n  );\n  return Date.UTC(\n    Number(parts.year),\n    Number(parts.month) - 1,\n    Number(parts.day),\n    Number(parts.hour),\n    Number(parts.minute),\n    Number(parts.second),\n  );\n}\n\nexport function toLeagueTimeOfDay(epochMs: number): string {\n  const wallClock = new Date(leagueWallClockAsUtc(epochMs));\n  const hours = String(wallClock.getUTCHours()).padStart(2, '0');\n  const minutes = String(wallClock.getUTCMinutes()).padStart(2, '0');\n  return `${hours}:${minutes}`;\n}\n\nexport function leagueInstantOf(dayKey: string, timeOfDay: string): number {\n  const day = CALENDAR_DAY_SHAPE.exec(dayKey);\n  const time = TIME_OF_DAY_SHAPE.exec(timeOfDay);\n  if (!day || !time)\n    throw new RangeError(`Not a calendar day and time of day: '${dayKey}' '${timeOfDay}'.`);\n  const wallClock = Date.UTC(\n    Number(day[1]),\n    Number(day[2]) - 1,\n    Number(day[3]),\n    Number(time[1]),\n    Number(time[2]),\n  );\n  if (new Date(wallClock).toISOString().slice(0, 10) !== dayKey) {\n    throw new RangeError(`Not a calendar day: '${dayKey}'.`);\n  }\n  // The offset at the wall-clock reading taken as UTC is within a day of the right one; read again at\n  // the instant that offset gives, so a reading on the other side of a change settles on its own.\n  const firstGuess = wallClock - (leagueWallClockAsUtc(wallClock) - wallClock);\n  const instant = wallClock - (leagueWallClockAsUtc(firstGuess) - firstGuess);\n  // A reading the clocks skip forward over settles on another hour; only a real one reads back.\n  if (toLeagueDayKey(instant) !== dayKey || toLeagueTimeOfDay(instant) !== timeOfDay) {\n    throw new RangeError(`Not a time the league's clocks show: '${dayKey}' '${timeOfDay}'.`);\n  }\n  return instant;\n}\n"]}

package/dist/utils/league-join-warning.d.ts

@@ -18,7 +18,6 @@ export type LeagueJoinWarningAction = (typeof LEAGUE_JOIN_WARNING_ACTION_KEYS)[n
 export declare const LEAGUE_JOIN_WARNING_PERSPECTIVE_KEYS: readonly ["self", "other"];
 export type LeagueJoinWarningPerspective = (typeof LEAGUE_JOIN_WARNING_PERSPECTIVE_KEYS)[number];
 export declare const LEAGUE_JOIN_WARNING_PERSPECTIVE_BY_ACTION: Readonly<Record<LeagueJoinWarningAction, LeagueJoinWarningPerspective>>;
-/** Where the person stands in the league, as the server read it. */
 export interface LeagueJoinWarningFacts {
     memberships: readonly {
         teamId: string;
@@ -43,10 +42,6 @@ export declare const leagueJoinWarningFindingSchema: z.ZodObject<{
     teamId: z.ZodNullable<z.ZodString>;
 }, z.core.$strict>;
 export type LeagueJoinWarningFinding = z.infer<typeof leagueJoinWarningFindingSchema>;
-/**
- * Every place the person stands in the league, the acted-on item left out, in state order and then
- * team order. An empty result means no warning is shown.
- */
 export declare function computeLeagueJoinWarning(facts: LeagueJoinWarningFacts, actedOn: LeagueJoinWarningActedOn | null): LeagueJoinWarningFinding[];
 export declare const LEAGUE_JOIN_WARNING_COPY: {
     readonly title: "Already in this league";
@@ -76,15 +71,9 @@ export declare const LEAGUE_JOIN_WARNING_COPY: {
     };
 };
 export interface LeagueJoinWarningText {
-    /** One sentence per finding, in the findings' order. */
     lines: string[];
     question: string;
 }
-/**
- * The dialog's words for a warning. `teamName` resolves a finding's team id to its display name;
- * `personName` names the person for a door acting on someone else. Empty findings are no warning,
- * and a caller shows no dialog for them.
- */
 export declare function formatLeagueJoinWarning(args: {
     action: LeagueJoinWarningAction;
     findings: readonly LeagueJoinWarningFinding[];

package/dist/utils/league-join-warning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"league-join-warning.d.ts","sourceRoot":"","sources":["../../src/utils/league-join-warning.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,8BAA8B,mFAKjC,CAAC;AACX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAIrF,eAAO,MAAM,iCAAiC,mEAIpC,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9F,eAAO,MAAM,8BAA8B;;;;;;;;4BAczC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAItF,eAAO,MAAM,+BAA+B,mKASlC,CAAC;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,eAAO,MAAM,oCAAoC,4BAA6B,CAAC;AAC/E,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,oCAAoC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjG,eAAO,MAAM,yCAAyC,EAAE,QAAQ,CAC9D,MAAM,CAAC,uBAAuB,EAAE,4BAA4B,CAAC,CAU9D,CAAC;AAEF,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,mBAAmB,EAAE,SAAS;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9E,kBAAkB,EAAE,SAAS;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAGD,eAAO,MAAM,8BAA8B;;;;;;;;kBAEhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,wBAAwB,GAAG,IAAI,GACvC,wBAAwB,EAAE,CAqC5B;AAED,eAAO,MAAM,wBAAwB;;;;;oCAMd,MAAM;gDACM,MAAM;+CACP,MAAM;;;;sCAKf,MAAM,YAAY,MAAM;kDACZ,MAAM,YAAY,MAAM;iDAEzB,MAAM,YAAY,MAAM;+CAE1B,MAAM;;;;2CAMD,MAAM;0CACP,MAAM;;yCAGP,MAAM;4CACH,MAAM;0CACR,MAAM;2CACL,MAAM;;CAEnC,CAAC;AAEX,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,qBAAqB,CAUxB"}
+{"version":3,"file":"league-join-warning.d.ts","sourceRoot":"","sources":["../../src/utils/league-join-warning.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,8BAA8B,mFAKjC,CAAC;AACX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,8BAA8B,CAAC,CAAC,MAAM,CAAC,CAAC;AAErF,eAAO,MAAM,iCAAiC,mEAIpC,CAAC;AACX,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,iCAAiC,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9F,eAAO,MAAM,8BAA8B;;;;;;;;4BAczC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,eAAO,MAAM,+BAA+B,mKASlC,CAAC;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,+BAA+B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvF,eAAO,MAAM,oCAAoC,4BAA6B,CAAC;AAC/E,MAAM,MAAM,4BAA4B,GAAG,CAAC,OAAO,oCAAoC,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjG,eAAO,MAAM,yCAAyC,EAAE,QAAQ,CAC9D,MAAM,CAAC,uBAAuB,EAAE,4BAA4B,CAAC,CAU9D,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,SAAS;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3C,mBAAmB,EAAE,SAAS;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9E,kBAAkB,EAAE,SAAS;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5E,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,8BAA8B;;;;;;;;kBAEhC,CAAC;AACZ,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,EAAE,wBAAwB,GAAG,IAAI,GACvC,wBAAwB,EAAE,CAqC5B;AAED,eAAO,MAAM,wBAAwB;;;;;oCAKd,MAAM;gDACM,MAAM;+CACP,MAAM;;;;sCAIf,MAAM,YAAY,MAAM;kDACZ,MAAM,YAAY,MAAM;iDAEzB,MAAM,YAAY,MAAM;+CAE1B,MAAM;;;;2CAKD,MAAM;0CACP,MAAM;;yCAGP,MAAM;4CACH,MAAM;0CACR,MAAM;2CACL,MAAM;;CAEnC,CAAC;AAEX,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9C,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,qBAAqB,CAUxB"}

package/dist/utils/league-join-warning.js

@@ -1,25 +1,12 @@
-// The join warning: before anyone puts a person on a team in a league, or starts
-// their way onto one, they see every place that person already stands there. It warns and never
-// blocks — confirm proceeds, cancel does nothing, and no server check refuses for it.
-//
-// One decision serves every door: `computeLeagueJoinWarning` is the whole rule, and the one reader
-// of the person's standing is the server core behind `getLeagueJoinWarning` /
-// `adminGetLeagueJoinWarning`, because another person's pending requests, invitations, and signup
-// are not readable from the client. What the dialog says is `LEAGUE_JOIN_WARNING_COPY`, through
-// `formatLeagueJoinWarning` (RULE-STD-ARCH-102, RULE-STD-ENG-005). The acted-on item and a finding cross the wire, so
-// each is declared once, as its schema, and its type is inferred from it.
 import { z } from 'zod';
 import { teamIdSchema } from '../doc-schemas/atoms.js';
 import { teamInvitationIdSchema, teamJoinRequestIdSchema } from '../schemas/atoms.js';
-// The four places a person can stand in a league.
 export const LEAGUE_JOIN_WARNING_STATE_KEYS = [
     'onTeam',
     'pendingJoinRequest',
     'pendingInvitation',
     'freeAgentSignup',
 ];
-// The item a door acts on, which the warning never names: accepting a team's invitation does not
-// warn about that invitation.
 export const LEAGUE_JOIN_WARNING_ACTED_ON_KEYS = [
     'teamInvitation',
     'teamJoinRequest',
@@ -40,8 +27,6 @@ export const leagueJoinWarningActedOnSchema = z.discriminatedUnion('kind', [
         .strict(),
     z.object({ kind: z.literal('leagueFreeAgent') }).strict(),
 ]);
-// Every door that shows the warning. Each is phrased either for the person acting on their own
-// behalf or for someone acting on them.
 export const LEAGUE_JOIN_WARNING_ACTION_KEYS = [
     'createTeam',
     'acceptInvitation',
@@ -63,14 +48,9 @@ export const LEAGUE_JOIN_WARNING_PERSPECTIVE_BY_ACTION = {
     assignFreeAgent: 'other',
     closedLeagueLink: 'other',
 };
-// One place the person stands. `teamId` is null only for a free-agent signup.
 export const leagueJoinWarningFindingSchema = z
     .object({ state: z.enum(LEAGUE_JOIN_WARNING_STATE_KEYS), teamId: teamIdSchema.nullable() })
     .strict();
-/**
- * Every place the person stands in the league, the acted-on item left out, in state order and then
- * team order. An empty result means no warning is shown.
- */
 export function computeLeagueJoinWarning(facts, actedOn) {
     const byTeam = (left, right) => (left.teamId ?? '').localeCompare(right.teamId ?? '');
     const onTeam = facts.memberships.map((membership) => ({
@@ -99,21 +79,18 @@ export const LEAGUE_JOIN_WARNING_COPY = {
     title: 'Already in this league',
     confirmLabel: 'Continue',
     cancelLabel: 'Cancel',
-    // What the person acting on their own behalf is told, per state found.
     self: {
         onTeam: (teamName) => `You are already on ${teamName}.`,
         pendingJoinRequest: (teamName) => `You have a request waiting with ${teamName}.`,
         pendingInvitation: (teamName) => `You have an invitation waiting from ${teamName}.`,
         freeAgentSignup: () => 'You are signed up as a free agent in this league.',
     },
-    // What someone acting on the person is told, per state found.
     other: {
         onTeam: (personName, teamName) => `${personName} is already on ${teamName}.`,
         pendingJoinRequest: (personName, teamName) => `${personName} has asked to join ${teamName}.`,
         pendingInvitation: (personName, teamName) => `${personName} has an invitation waiting from ${teamName}.`,
         freeAgentSignup: (personName) => `${personName} is signed up as a free agent in this league.`,
     },
-    // The closing question, per door. `targetTeamName` is ignored by the doors that have no team.
     question: {
         createTeam: () => 'Do you still want to create a new team?',
         acceptInvitation: (targetTeamName) => `Do you still want to join ${targetTeamName}?`,
@@ -125,11 +102,6 @@ export const LEAGUE_JOIN_WARNING_COPY = {
         closedLeagueLink: (targetTeamName) => `Link them to ${targetTeamName} anyway?`,
     },
 };
-/**
- * The dialog's words for a warning. `teamName` resolves a finding's team id to its display name;
- * `personName` names the person for a door acting on someone else. Empty findings are no warning,
- * and a caller shows no dialog for them.
- */
 export function formatLeagueJoinWarning(args) {
     const perspective = LEAGUE_JOIN_WARNING_PERSPECTIVE_BY_ACTION[args.action];
     const lines = args.findings.map((finding) => {