@ttt-productions/q-core 0.1.28 → 0.1.30

package/dist/input-formats/input-formats.d.ts

@@ -1,200 +1,120 @@
-/**
- * The reason an admin gives for a repair action, as `repairReasonSchema` reads it: trimmed, then
- * bounded by the repair-reason limits, with any character and line breaks allowed.
- */
 export declare const REPAIR_REASON_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 3;
     readonly max: 500;
 }>;
-/**
- * The evidence an operator records for a cutover step the console cannot see done — an export's
- * operation name, a revocation's console record: trimmed, then bounded by the repair-reason limits,
- * line breaks allowed.
- */
 export declare const MIGRATION_EVIDENCE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 3;
     readonly max: 500;
 }>;
-/**
- * A player's message to the team they ask to join, as `teamJoinRequestMessageSchema` reads it:
- * trimmed, then bounded by the join-request message limits, with any character and line breaks
- * allowed.
- */
 export declare const TEAM_JOIN_REQUEST_MESSAGE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 10;
     readonly max: 500;
 }>;
-/**
- * The optional note a team sends with an invitation, as `teamInvitationMessageSchema` reads it:
- * trimmed, empty allowed, then bounded by the invitation note limit, line breaks allowed.
- */
 export declare const TEAM_INVITATION_MESSAGE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 0;
     readonly max: 500;
 }>;
-/**
- * A scorer's note on one person in a live game ("red shirt", "#9"), as `gameMemoSchema` reads it:
- * trimmed, one line, empty allowed — an empty memo clears the note — then bounded by the memo cap.
- */
 export declare const GAME_MEMO_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 0;
     readonly max: 30;
 }>;
-/**
- * A person's display name — an account's, or a ghost player's, as both ghost doors and the admin's
- * ghost captain ask for it — as `displayNameSchema` reads it: trimmed, one line, then bounded by the
- * display-name limits.
- */
 export declare const DISPLAY_NAME_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 3;
     readonly max: 50;
 }>;
-/**
- * A team's name, as `teamNameSchema` reads it at creation and at an admin's rename: trimmed, one
- * line, then bounded by the team-name limits.
- */
 export declare const TEAM_NAME_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 3;
     readonly max: 50;
 }>;
-/**
- * The number the league reaches a team on, as `contactPhoneSchema` reads it: trimmed, one line,
- * required, and bounded by the contact-phone cap. It is kept as typed — no format is imposed.
- */
 export declare const CONTACT_PHONE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 1;
     readonly max: 30;
 }>;
-/**
- * The account's optional default contact phone on the settings page: the contact-phone format with
- * empty allowed. Empty means remove the saved number — the form sends it as
- * `UpdateAccountSettingsInput.defaultContactPhone: null` — and any other value is held to
- * `CONTACT_PHONE_INPUT_FORMAT`'s trim, one line, and cap.
- */
 export declare const OPTIONAL_CONTACT_PHONE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 0;
     readonly max: 30;
 }>;
-/**
- * An award's name in the catalog, as `awardNameSchema` reads it — at creation, sent with the award's
- * first badge: trimmed, one line, then bounded by the award-name limits.
- */
 export declare const AWARD_NAME_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 3;
     readonly max: 60;
 }>;
-/**
- * A league's title, as `leagueTitleSchema` reads it at creation and at the settings edit: trimmed,
- * one line, then bounded by the league-title limits.
- */
 export declare const LEAGUE_TITLE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 3;
     readonly max: 100;
 }>;
-/**
- * A league's description, as `leagueDescriptionSchema` reads it at creation and at the settings
- * edit: trimmed, then bounded by the league-description limits, line breaks allowed.
- */
 export declare const LEAGUE_DESCRIPTION_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 10;
     readonly max: 5000;
 }>;
-/** A venue's name, as `gameLocationNameSchema` reads it: trimmed, one line, required, within its cap. */
 export declare const GAME_LOCATION_NAME_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 1;
     readonly max: 100;
 }>;
-/**
- * A venue's street address, as `gameLocationStreetAddressSchema` reads it: trimmed, one line,
- * required, within its cap.
- */
 export declare const GAME_LOCATION_STREET_ADDRESS_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 1;
     readonly max: 200;
 }>;
-/**
- * One court, sheet, or room of a venue, as `gameLocationSubLocationSchema` reads it: trimmed, one
- * line, required, within its cap.
- */
 export declare const GAME_LOCATION_SUB_LOCATION_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 1;
     readonly max: 60;
 }>;
-/**
- * A venue's memo, as `gameLocationMemoSchema` reads it: trimmed, line breaks allowed, empty allowed —
- * an empty memo means the venue has none — within its cap.
- */
 export declare const GAME_LOCATION_MEMO_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 0;
     readonly max: 500;
 }>;
-/** A schedule week's name, as `scheduleWeekTitleSchema` reads it: trimmed, one line, required. */
 export declare const SCHEDULE_WEEK_TITLE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 1;
     readonly max: 100;
 }>;
-/**
- * A waiver template's title, as `waiverTemplateTitleSchema` reads it. A waiver is a legal artifact a
- * player signs, so its words are kept exactly as typed; it still cannot be blank.
- */
 export declare const WAIVER_TEMPLATE_TITLE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 1;
     readonly max: 120;
     readonly keepAsTyped: true;
 }>;
-/**
- * A waiver template's wording, as `waiverTemplateTextSchema` reads it: the legal text a player signs,
- * kept exactly as typed, line breaks allowed, never blank.
- */
 export declare const WAIVER_TEMPLATE_TEXT_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 1;
     readonly max: 20000;
     readonly keepAsTyped: true;
 }>;
-/** The landing page's hero title: trimmed, one line; blank shows the default heading. */
 export declare const LANDING_HERO_TITLE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "singleLine";
     readonly min: 0;
     readonly max: 200;
 }>;
-/** The landing page's about text: trimmed, line breaks allowed, empty allowed. */
 export declare const LANDING_ABOUT_TEXT_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 0;
     readonly max: 5000;
 }>;
-/** The message shown while the app is in maintenance; empty shows none. */
 export declare const MAINTENANCE_MESSAGE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 0;
     readonly max: 2000;
 }>;
-/** The site announcement banner; empty clears it. */
 export declare const ANNOUNCEMENT_MESSAGE_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 0;
     readonly max: 300;
 }>;
-/** The published app version the version gate compares against; never blank. */
 export declare const APP_VERSION_INPUT_FORMAT: import("@ttt-productions/input-format-core").DeclaredInputFormat<{
     readonly format: "none";
     readonly min: 1;

package/dist/input-formats/input-formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"input-formats.d.ts","sourceRoot":"","sources":["../../src/input-formats/input-formats.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;EAIrC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,sCAAsC;;;;EAIjD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oCAAoC;;;;EAI/C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,yBAAyB;;;;EAIpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B;;;;EAIrC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,mCAAmC;;;;EAI9C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;EAIlC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;EAIpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,yGAAyG;AACzG,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yCAAyC;;;;EAIpD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,uCAAuC;;;;EAIlD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,kGAAkG;AAClG,eAAO,MAAM,gCAAgC;;;;EAI3C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kCAAkC;;;;;EAK7C,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iCAAiC;;;;;EAK5C,CAAC;AAEH,yFAAyF;AACzF,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,2EAA2E;AAC3E,eAAO,MAAM,gCAAgC;;;;EAI3C,CAAC;AAEH,qDAAqD;AACrD,eAAO,MAAM,iCAAiC;;;;EAI5C,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,wBAAwB;;;;EAInC,CAAC"}
+{"version":3,"file":"input-formats.d.ts","sourceRoot":"","sources":["../../src/input-formats/input-formats.ts"],"names":[],"mappings":"AAiCA,eAAO,MAAM,0BAA0B;;;;EAIrC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,eAAO,MAAM,sCAAsC;;;;EAIjD,CAAC;AAEH,eAAO,MAAM,oCAAoC;;;;EAI/C,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;EAIpC,CAAC;AAEH,eAAO,MAAM,sBAAsB;;;;EAIjC,CAAC;AAEH,eAAO,MAAM,0BAA0B;;;;EAIrC,CAAC;AAEH,eAAO,MAAM,mCAAmC;;;;EAI9C,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;EAIlC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;;EAIpC,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,eAAO,MAAM,yCAAyC;;;;EAIpD,CAAC;AAEH,eAAO,MAAM,uCAAuC;;;;EAIlD,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;EAI3C,CAAC;AAEH,eAAO,MAAM,kCAAkC;;;;;EAK7C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;;EAK5C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,eAAO,MAAM,+BAA+B;;;;EAI1C,CAAC;AAEH,eAAO,MAAM,gCAAgC;;;;EAI3C,CAAC;AAEH,eAAO,MAAM,iCAAiC;;;;EAI5C,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;EAInC,CAAC"}

package/dist/input-formats/input-formats.js

@@ -1,208 +1,122 @@
-// The declared formats of the free-text fields a form takes, each built from the limits the field
-// enforces (RULE-STD-ARCH-102). ui-core's text inputs and `ConsequenceDialog`'s reason field take only a
-// declaration, never a bare bound, and a field's wire schema is built from the same declaration
-// through `textFieldSchema`, so the form and the wire run the one check and accept exactly the same
-// text. `input-format-core` is server-safe and has no dependencies, so the declarations sit in the
-// package root, which both app roots import.
 import { defineInputFormat } from '@ttt-productions/input-format-core';
 import { MAX_ANNOUNCEMENT_MESSAGE_LENGTH, MAX_APP_VERSION_LENGTH, MAX_AWARD_NAME_LENGTH, MAX_CONTACT_PHONE_LENGTH, MAX_DISPLAY_NAME_LENGTH, MAX_GAME_LOCATION_MEMO_LENGTH, MAX_GAME_LOCATION_NAME_LENGTH, MAX_GAME_LOCATION_STREET_ADDRESS_LENGTH, MAX_GAME_LOCATION_SUB_LOCATION_LENGTH, MAX_GAME_MEMO_LENGTH, MAX_LANDING_ABOUT_TEXT_LENGTH, MAX_LANDING_HERO_TITLE_LENGTH, MAX_LEAGUE_DESCRIPTION_LENGTH, MAX_LEAGUE_TITLE_LENGTH, MAX_MAINTENANCE_MESSAGE_LENGTH, MAX_REPAIR_REASON_LENGTH, MAX_SCHEDULE_WEEK_TITLE_LENGTH, MAX_TEAM_INVITATION_MESSAGE_LENGTH, MAX_TEAM_JOIN_REQUEST_MESSAGE_LENGTH, MAX_TEAM_NAME_LENGTH, MAX_WAIVER_TEMPLATE_TEXT_LENGTH, MAX_WAIVER_TEMPLATE_TITLE_LENGTH, MIN_AWARD_NAME_LENGTH, MIN_DISPLAY_NAME_LENGTH, MIN_LEAGUE_DESCRIPTION_LENGTH, MIN_LEAGUE_TITLE_LENGTH, MIN_REPAIR_REASON_LENGTH, MIN_TEAM_JOIN_REQUEST_MESSAGE_LENGTH, MIN_TEAM_NAME_LENGTH, } from '../constants/business.js';
-/**
- * The reason an admin gives for a repair action, as `repairReasonSchema` reads it: trimmed, then
- * bounded by the repair-reason limits, with any character and line breaks allowed.
- */
 export const REPAIR_REASON_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: MIN_REPAIR_REASON_LENGTH,
     max: MAX_REPAIR_REASON_LENGTH,
 });
-/**
- * The evidence an operator records for a cutover step the console cannot see done — an export's
- * operation name, a revocation's console record: trimmed, then bounded by the repair-reason limits,
- * line breaks allowed.
- */
 export const MIGRATION_EVIDENCE_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: MIN_REPAIR_REASON_LENGTH,
     max: MAX_REPAIR_REASON_LENGTH,
 });
-/**
- * A player's message to the team they ask to join, as `teamJoinRequestMessageSchema` reads it:
- * trimmed, then bounded by the join-request message limits, with any character and line breaks
- * allowed.
- */
 export const TEAM_JOIN_REQUEST_MESSAGE_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: MIN_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,
     max: MAX_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,
 });
-/**
- * The optional note a team sends with an invitation, as `teamInvitationMessageSchema` reads it:
- * trimmed, empty allowed, then bounded by the invitation note limit, line breaks allowed.
- */
 export const TEAM_INVITATION_MESSAGE_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 0,
     max: MAX_TEAM_INVITATION_MESSAGE_LENGTH,
 });
-/**
- * A scorer's note on one person in a live game ("red shirt", "#9"), as `gameMemoSchema` reads it:
- * trimmed, one line, empty allowed — an empty memo clears the note — then bounded by the memo cap.
- */
 export const GAME_MEMO_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 0,
     max: MAX_GAME_MEMO_LENGTH,
 });
-/**
- * A person's display name — an account's, or a ghost player's, as both ghost doors and the admin's
- * ghost captain ask for it — as `displayNameSchema` reads it: trimmed, one line, then bounded by the
- * display-name limits.
- */
 export const DISPLAY_NAME_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: MIN_DISPLAY_NAME_LENGTH,
     max: MAX_DISPLAY_NAME_LENGTH,
 });
-/**
- * A team's name, as `teamNameSchema` reads it at creation and at an admin's rename: trimmed, one
- * line, then bounded by the team-name limits.
- */
 export const TEAM_NAME_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: MIN_TEAM_NAME_LENGTH,
     max: MAX_TEAM_NAME_LENGTH,
 });
-/**
- * The number the league reaches a team on, as `contactPhoneSchema` reads it: trimmed, one line,
- * required, and bounded by the contact-phone cap. It is kept as typed — no format is imposed.
- */
 export const CONTACT_PHONE_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 1,
     max: MAX_CONTACT_PHONE_LENGTH,
 });
-/**
- * The account's optional default contact phone on the settings page: the contact-phone format with
- * empty allowed. Empty means remove the saved number — the form sends it as
- * `UpdateAccountSettingsInput.defaultContactPhone: null` — and any other value is held to
- * `CONTACT_PHONE_INPUT_FORMAT`'s trim, one line, and cap.
- */
 export const OPTIONAL_CONTACT_PHONE_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 0,
     max: MAX_CONTACT_PHONE_LENGTH,
 });
-/**
- * An award's name in the catalog, as `awardNameSchema` reads it — at creation, sent with the award's
- * first badge: trimmed, one line, then bounded by the award-name limits.
- */
 export const AWARD_NAME_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: MIN_AWARD_NAME_LENGTH,
     max: MAX_AWARD_NAME_LENGTH,
 });
-/**
- * A league's title, as `leagueTitleSchema` reads it at creation and at the settings edit: trimmed,
- * one line, then bounded by the league-title limits.
- */
 export const LEAGUE_TITLE_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: MIN_LEAGUE_TITLE_LENGTH,
     max: MAX_LEAGUE_TITLE_LENGTH,
 });
-/**
- * A league's description, as `leagueDescriptionSchema` reads it at creation and at the settings
- * edit: trimmed, then bounded by the league-description limits, line breaks allowed.
- */
 export const LEAGUE_DESCRIPTION_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: MIN_LEAGUE_DESCRIPTION_LENGTH,
     max: MAX_LEAGUE_DESCRIPTION_LENGTH,
 });
-/** A venue's name, as `gameLocationNameSchema` reads it: trimmed, one line, required, within its cap. */
 export const GAME_LOCATION_NAME_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 1,
     max: MAX_GAME_LOCATION_NAME_LENGTH,
 });
-/**
- * A venue's street address, as `gameLocationStreetAddressSchema` reads it: trimmed, one line,
- * required, within its cap.
- */
 export const GAME_LOCATION_STREET_ADDRESS_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 1,
     max: MAX_GAME_LOCATION_STREET_ADDRESS_LENGTH,
 });
-/**
- * One court, sheet, or room of a venue, as `gameLocationSubLocationSchema` reads it: trimmed, one
- * line, required, within its cap.
- */
 export const GAME_LOCATION_SUB_LOCATION_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 1,
     max: MAX_GAME_LOCATION_SUB_LOCATION_LENGTH,
 });
-/**
- * A venue's memo, as `gameLocationMemoSchema` reads it: trimmed, line breaks allowed, empty allowed —
- * an empty memo means the venue has none — within its cap.
- */
 export const GAME_LOCATION_MEMO_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 0,
     max: MAX_GAME_LOCATION_MEMO_LENGTH,
 });
-/** A schedule week's name, as `scheduleWeekTitleSchema` reads it: trimmed, one line, required. */
 export const SCHEDULE_WEEK_TITLE_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 1,
     max: MAX_SCHEDULE_WEEK_TITLE_LENGTH,
 });
-/**
- * A waiver template's title, as `waiverTemplateTitleSchema` reads it. A waiver is a legal artifact a
- * player signs, so its words are kept exactly as typed; it still cannot be blank.
- */
 export const WAIVER_TEMPLATE_TITLE_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 1,
     max: MAX_WAIVER_TEMPLATE_TITLE_LENGTH,
     keepAsTyped: true,
 });
-/**
- * A waiver template's wording, as `waiverTemplateTextSchema` reads it: the legal text a player signs,
- * kept exactly as typed, line breaks allowed, never blank.
- */
 export const WAIVER_TEMPLATE_TEXT_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 1,
     max: MAX_WAIVER_TEMPLATE_TEXT_LENGTH,
     keepAsTyped: true,
 });
-/** The landing page's hero title: trimmed, one line; blank shows the default heading. */
 export const LANDING_HERO_TITLE_INPUT_FORMAT = defineInputFormat({
     format: 'singleLine',
     min: 0,
     max: MAX_LANDING_HERO_TITLE_LENGTH,
 });
-/** The landing page's about text: trimmed, line breaks allowed, empty allowed. */
 export const LANDING_ABOUT_TEXT_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 0,
     max: MAX_LANDING_ABOUT_TEXT_LENGTH,
 });
-/** The message shown while the app is in maintenance; empty shows none. */
 export const MAINTENANCE_MESSAGE_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 0,
     max: MAX_MAINTENANCE_MESSAGE_LENGTH,
 });
-/** The site announcement banner; empty clears it. */
 export const ANNOUNCEMENT_MESSAGE_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 0,
     max: MAX_ANNOUNCEMENT_MESSAGE_LENGTH,
 });
-/** The published app version the version gate compares against; never blank. */
 export const APP_VERSION_INPUT_FORMAT = defineInputFormat({
     format: 'none',
     min: 1,

package/dist/input-formats/input-formats.js.map

@@ -1 +1 @@
-{"version":3,"file":"input-formats.js","sourceRoot":"","sources":["../../src/input-formats/input-formats.ts"],"names":[],"mappings":"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","sourcesContent":["// The declared formats of the free-text fields a form takes, each built from the limits the field\n// enforces (RULE-STD-ARCH-102). ui-core's text inputs and `ConsequenceDialog`'s reason field take only a\n// declaration, never a bare bound, and a field's wire schema is built from the same declaration\n// through `textFieldSchema`, so the form and the wire run the one check and accept exactly the same\n// text. `input-format-core` is server-safe and has no dependencies, so the declarations sit in the\n// package root, which both app roots import.\n\nimport { defineInputFormat } from '@ttt-productions/input-format-core';\nimport {\n  MAX_ANNOUNCEMENT_MESSAGE_LENGTH,\n  MAX_APP_VERSION_LENGTH,\n  MAX_AWARD_NAME_LENGTH,\n  MAX_CONTACT_PHONE_LENGTH,\n  MAX_DISPLAY_NAME_LENGTH,\n  MAX_GAME_LOCATION_MEMO_LENGTH,\n  MAX_GAME_LOCATION_NAME_LENGTH,\n  MAX_GAME_LOCATION_STREET_ADDRESS_LENGTH,\n  MAX_GAME_LOCATION_SUB_LOCATION_LENGTH,\n  MAX_GAME_MEMO_LENGTH,\n  MAX_LANDING_ABOUT_TEXT_LENGTH,\n  MAX_LANDING_HERO_TITLE_LENGTH,\n  MAX_LEAGUE_DESCRIPTION_LENGTH,\n  MAX_LEAGUE_TITLE_LENGTH,\n  MAX_MAINTENANCE_MESSAGE_LENGTH,\n  MAX_REPAIR_REASON_LENGTH,\n  MAX_SCHEDULE_WEEK_TITLE_LENGTH,\n  MAX_TEAM_INVITATION_MESSAGE_LENGTH,\n  MAX_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n  MAX_TEAM_NAME_LENGTH,\n  MAX_WAIVER_TEMPLATE_TEXT_LENGTH,\n  MAX_WAIVER_TEMPLATE_TITLE_LENGTH,\n  MIN_AWARD_NAME_LENGTH,\n  MIN_DISPLAY_NAME_LENGTH,\n  MIN_LEAGUE_DESCRIPTION_LENGTH,\n  MIN_LEAGUE_TITLE_LENGTH,\n  MIN_REPAIR_REASON_LENGTH,\n  MIN_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n  MIN_TEAM_NAME_LENGTH,\n} from '../constants/business.js';\n\n/**\n * The reason an admin gives for a repair action, as `repairReasonSchema` reads it: trimmed, then\n * bounded by the repair-reason limits, with any character and line breaks allowed.\n */\nexport const REPAIR_REASON_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_REPAIR_REASON_LENGTH,\n  max: MAX_REPAIR_REASON_LENGTH,\n});\n\n/**\n * The evidence an operator records for a cutover step the console cannot see done — an export's\n * operation name, a revocation's console record: trimmed, then bounded by the repair-reason limits,\n * line breaks allowed.\n */\nexport const MIGRATION_EVIDENCE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_REPAIR_REASON_LENGTH,\n  max: MAX_REPAIR_REASON_LENGTH,\n});\n\n/**\n * A player's message to the team they ask to join, as `teamJoinRequestMessageSchema` reads it:\n * trimmed, then bounded by the join-request message limits, with any character and line breaks\n * allowed.\n */\nexport const TEAM_JOIN_REQUEST_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n  max: MAX_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n});\n\n/**\n * The optional note a team sends with an invitation, as `teamInvitationMessageSchema` reads it:\n * trimmed, empty allowed, then bounded by the invitation note limit, line breaks allowed.\n */\nexport const TEAM_INVITATION_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_TEAM_INVITATION_MESSAGE_LENGTH,\n});\n\n/**\n * A scorer's note on one person in a live game (\"red shirt\", \"#9\"), as `gameMemoSchema` reads it:\n * trimmed, one line, empty allowed — an empty memo clears the note — then bounded by the memo cap.\n */\nexport const GAME_MEMO_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 0,\n  max: MAX_GAME_MEMO_LENGTH,\n});\n\n/**\n * A person's display name — an account's, or a ghost player's, as both ghost doors and the admin's\n * ghost captain ask for it — as `displayNameSchema` reads it: trimmed, one line, then bounded by the\n * display-name limits.\n */\nexport const DISPLAY_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_DISPLAY_NAME_LENGTH,\n  max: MAX_DISPLAY_NAME_LENGTH,\n});\n\n/**\n * A team's name, as `teamNameSchema` reads it at creation and at an admin's rename: trimmed, one\n * line, then bounded by the team-name limits.\n */\nexport const TEAM_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_TEAM_NAME_LENGTH,\n  max: MAX_TEAM_NAME_LENGTH,\n});\n\n/**\n * The number the league reaches a team on, as `contactPhoneSchema` reads it: trimmed, one line,\n * required, and bounded by the contact-phone cap. It is kept as typed — no format is imposed.\n */\nexport const CONTACT_PHONE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_CONTACT_PHONE_LENGTH,\n});\n\n/**\n * The account's optional default contact phone on the settings page: the contact-phone format with\n * empty allowed. Empty means remove the saved number — the form sends it as\n * `UpdateAccountSettingsInput.defaultContactPhone: null` — and any other value is held to\n * `CONTACT_PHONE_INPUT_FORMAT`'s trim, one line, and cap.\n */\nexport const OPTIONAL_CONTACT_PHONE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 0,\n  max: MAX_CONTACT_PHONE_LENGTH,\n});\n\n/**\n * An award's name in the catalog, as `awardNameSchema` reads it — at creation, sent with the award's\n * first badge: trimmed, one line, then bounded by the award-name limits.\n */\nexport const AWARD_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_AWARD_NAME_LENGTH,\n  max: MAX_AWARD_NAME_LENGTH,\n});\n\n/**\n * A league's title, as `leagueTitleSchema` reads it at creation and at the settings edit: trimmed,\n * one line, then bounded by the league-title limits.\n */\nexport const LEAGUE_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_LEAGUE_TITLE_LENGTH,\n  max: MAX_LEAGUE_TITLE_LENGTH,\n});\n\n/**\n * A league's description, as `leagueDescriptionSchema` reads it at creation and at the settings\n * edit: trimmed, then bounded by the league-description limits, line breaks allowed.\n */\nexport const LEAGUE_DESCRIPTION_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_LEAGUE_DESCRIPTION_LENGTH,\n  max: MAX_LEAGUE_DESCRIPTION_LENGTH,\n});\n\n/** A venue's name, as `gameLocationNameSchema` reads it: trimmed, one line, required, within its cap. */\nexport const GAME_LOCATION_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_GAME_LOCATION_NAME_LENGTH,\n});\n\n/**\n * A venue's street address, as `gameLocationStreetAddressSchema` reads it: trimmed, one line,\n * required, within its cap.\n */\nexport const GAME_LOCATION_STREET_ADDRESS_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_GAME_LOCATION_STREET_ADDRESS_LENGTH,\n});\n\n/**\n * One court, sheet, or room of a venue, as `gameLocationSubLocationSchema` reads it: trimmed, one\n * line, required, within its cap.\n */\nexport const GAME_LOCATION_SUB_LOCATION_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_GAME_LOCATION_SUB_LOCATION_LENGTH,\n});\n\n/**\n * A venue's memo, as `gameLocationMemoSchema` reads it: trimmed, line breaks allowed, empty allowed —\n * an empty memo means the venue has none — within its cap.\n */\nexport const GAME_LOCATION_MEMO_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_GAME_LOCATION_MEMO_LENGTH,\n});\n\n/** A schedule week's name, as `scheduleWeekTitleSchema` reads it: trimmed, one line, required. */\nexport const SCHEDULE_WEEK_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_SCHEDULE_WEEK_TITLE_LENGTH,\n});\n\n/**\n * A waiver template's title, as `waiverTemplateTitleSchema` reads it. A waiver is a legal artifact a\n * player signs, so its words are kept exactly as typed; it still cannot be blank.\n */\nexport const WAIVER_TEMPLATE_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_WAIVER_TEMPLATE_TITLE_LENGTH,\n  keepAsTyped: true,\n});\n\n/**\n * A waiver template's wording, as `waiverTemplateTextSchema` reads it: the legal text a player signs,\n * kept exactly as typed, line breaks allowed, never blank.\n */\nexport const WAIVER_TEMPLATE_TEXT_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 1,\n  max: MAX_WAIVER_TEMPLATE_TEXT_LENGTH,\n  keepAsTyped: true,\n});\n\n/** The landing page's hero title: trimmed, one line; blank shows the default heading. */\nexport const LANDING_HERO_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 0,\n  max: MAX_LANDING_HERO_TITLE_LENGTH,\n});\n\n/** The landing page's about text: trimmed, line breaks allowed, empty allowed. */\nexport const LANDING_ABOUT_TEXT_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_LANDING_ABOUT_TEXT_LENGTH,\n});\n\n/** The message shown while the app is in maintenance; empty shows none. */\nexport const MAINTENANCE_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_MAINTENANCE_MESSAGE_LENGTH,\n});\n\n/** The site announcement banner; empty clears it. */\nexport const ANNOUNCEMENT_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_ANNOUNCEMENT_MESSAGE_LENGTH,\n});\n\n/** The published app version the version gate compares against; never blank. */\nexport const APP_VERSION_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 1,\n  max: MAX_APP_VERSION_LENGTH,\n});\n"]}
+{"version":3,"file":"input-formats.js","sourceRoot":"","sources":["../../src/input-formats/input-formats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EACL,+BAA+B,EAC/B,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,uCAAuC,EACvC,qCAAqC,EACrC,oBAAoB,EACpB,6BAA6B,EAC7B,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,8BAA8B,EAC9B,wBAAwB,EACxB,8BAA8B,EAC9B,kCAAkC,EAClC,oCAAoC,EACpC,oBAAoB,EACpB,+BAA+B,EAC/B,gCAAgC,EAChC,qBAAqB,EACrB,uBAAuB,EACvB,6BAA6B,EAC7B,uBAAuB,EACvB,wBAAwB,EACxB,oCAAoC,EACpC,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAElC,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;IAC1D,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,wBAAwB;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;IAC/D,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,wBAAwB;IAC7B,GAAG,EAAE,wBAAwB;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sCAAsC,GAAG,iBAAiB,CAAC;IACtE,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,oCAAoC;IACzC,GAAG,EAAE,oCAAoC;CAC1C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,iBAAiB,CAAC;IACpE,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,kCAAkC;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;IACtD,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,oBAAoB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;IACzD,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,uBAAuB;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;IACtD,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,oBAAoB;IACzB,GAAG,EAAE,oBAAoB;CAC1B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,iBAAiB,CAAC;IAC1D,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,wBAAwB;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mCAAmC,GAAG,iBAAiB,CAAC;IACnE,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,wBAAwB;CAC9B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;IACvD,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,qBAAqB;IAC1B,GAAG,EAAE,qBAAqB;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,iBAAiB,CAAC;IACzD,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,uBAAuB;IAC5B,GAAG,EAAE,uBAAuB;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;IAC/D,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,6BAA6B;IAClC,GAAG,EAAE,6BAA6B;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;IAC/D,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,6BAA6B;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yCAAyC,GAAG,iBAAiB,CAAC;IACzE,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,uCAAuC;CAC7C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uCAAuC,GAAG,iBAAiB,CAAC;IACvE,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,qCAAqC;CAC3C,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;IAC/D,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,6BAA6B;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAAiB,CAAC;IAChE,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,8BAA8B;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAAG,iBAAiB,CAAC;IAClE,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,gCAAgC;IACrC,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,iBAAiB,CAAC;IACjE,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,+BAA+B;IACpC,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;IAC/D,MAAM,EAAE,YAAY;IACpB,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,6BAA6B;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,+BAA+B,GAAG,iBAAiB,CAAC;IAC/D,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,6BAA6B;CACnC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gCAAgC,GAAG,iBAAiB,CAAC;IAChE,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,8BAA8B;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iCAAiC,GAAG,iBAAiB,CAAC;IACjE,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,+BAA+B;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;IACxD,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,sBAAsB;CAC5B,CAAC,CAAC","sourcesContent":["import { defineInputFormat } from '@ttt-productions/input-format-core';\nimport {\n  MAX_ANNOUNCEMENT_MESSAGE_LENGTH,\n  MAX_APP_VERSION_LENGTH,\n  MAX_AWARD_NAME_LENGTH,\n  MAX_CONTACT_PHONE_LENGTH,\n  MAX_DISPLAY_NAME_LENGTH,\n  MAX_GAME_LOCATION_MEMO_LENGTH,\n  MAX_GAME_LOCATION_NAME_LENGTH,\n  MAX_GAME_LOCATION_STREET_ADDRESS_LENGTH,\n  MAX_GAME_LOCATION_SUB_LOCATION_LENGTH,\n  MAX_GAME_MEMO_LENGTH,\n  MAX_LANDING_ABOUT_TEXT_LENGTH,\n  MAX_LANDING_HERO_TITLE_LENGTH,\n  MAX_LEAGUE_DESCRIPTION_LENGTH,\n  MAX_LEAGUE_TITLE_LENGTH,\n  MAX_MAINTENANCE_MESSAGE_LENGTH,\n  MAX_REPAIR_REASON_LENGTH,\n  MAX_SCHEDULE_WEEK_TITLE_LENGTH,\n  MAX_TEAM_INVITATION_MESSAGE_LENGTH,\n  MAX_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n  MAX_TEAM_NAME_LENGTH,\n  MAX_WAIVER_TEMPLATE_TEXT_LENGTH,\n  MAX_WAIVER_TEMPLATE_TITLE_LENGTH,\n  MIN_AWARD_NAME_LENGTH,\n  MIN_DISPLAY_NAME_LENGTH,\n  MIN_LEAGUE_DESCRIPTION_LENGTH,\n  MIN_LEAGUE_TITLE_LENGTH,\n  MIN_REPAIR_REASON_LENGTH,\n  MIN_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n  MIN_TEAM_NAME_LENGTH,\n} from '../constants/business.js';\n\nexport const REPAIR_REASON_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_REPAIR_REASON_LENGTH,\n  max: MAX_REPAIR_REASON_LENGTH,\n});\n\nexport const MIGRATION_EVIDENCE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_REPAIR_REASON_LENGTH,\n  max: MAX_REPAIR_REASON_LENGTH,\n});\n\nexport const TEAM_JOIN_REQUEST_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n  max: MAX_TEAM_JOIN_REQUEST_MESSAGE_LENGTH,\n});\n\nexport const TEAM_INVITATION_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_TEAM_INVITATION_MESSAGE_LENGTH,\n});\n\nexport const GAME_MEMO_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 0,\n  max: MAX_GAME_MEMO_LENGTH,\n});\n\nexport const DISPLAY_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_DISPLAY_NAME_LENGTH,\n  max: MAX_DISPLAY_NAME_LENGTH,\n});\n\nexport const TEAM_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_TEAM_NAME_LENGTH,\n  max: MAX_TEAM_NAME_LENGTH,\n});\n\nexport const CONTACT_PHONE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_CONTACT_PHONE_LENGTH,\n});\n\nexport const OPTIONAL_CONTACT_PHONE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 0,\n  max: MAX_CONTACT_PHONE_LENGTH,\n});\n\nexport const AWARD_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_AWARD_NAME_LENGTH,\n  max: MAX_AWARD_NAME_LENGTH,\n});\n\nexport const LEAGUE_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: MIN_LEAGUE_TITLE_LENGTH,\n  max: MAX_LEAGUE_TITLE_LENGTH,\n});\n\nexport const LEAGUE_DESCRIPTION_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: MIN_LEAGUE_DESCRIPTION_LENGTH,\n  max: MAX_LEAGUE_DESCRIPTION_LENGTH,\n});\n\nexport const GAME_LOCATION_NAME_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_GAME_LOCATION_NAME_LENGTH,\n});\n\nexport const GAME_LOCATION_STREET_ADDRESS_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_GAME_LOCATION_STREET_ADDRESS_LENGTH,\n});\n\nexport const GAME_LOCATION_SUB_LOCATION_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_GAME_LOCATION_SUB_LOCATION_LENGTH,\n});\n\nexport const GAME_LOCATION_MEMO_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_GAME_LOCATION_MEMO_LENGTH,\n});\n\nexport const SCHEDULE_WEEK_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_SCHEDULE_WEEK_TITLE_LENGTH,\n});\n\nexport const WAIVER_TEMPLATE_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 1,\n  max: MAX_WAIVER_TEMPLATE_TITLE_LENGTH,\n  keepAsTyped: true,\n});\n\nexport const WAIVER_TEMPLATE_TEXT_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 1,\n  max: MAX_WAIVER_TEMPLATE_TEXT_LENGTH,\n  keepAsTyped: true,\n});\n\nexport const LANDING_HERO_TITLE_INPUT_FORMAT = defineInputFormat({\n  format: 'singleLine',\n  min: 0,\n  max: MAX_LANDING_HERO_TITLE_LENGTH,\n});\n\nexport const LANDING_ABOUT_TEXT_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_LANDING_ABOUT_TEXT_LENGTH,\n});\n\nexport const MAINTENANCE_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_MAINTENANCE_MESSAGE_LENGTH,\n});\n\nexport const ANNOUNCEMENT_MESSAGE_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 0,\n  max: MAX_ANNOUNCEMENT_MESSAGE_LENGTH,\n});\n\nexport const APP_VERSION_INPUT_FORMAT = defineInputFormat({\n  format: 'none',\n  min: 1,\n  max: MAX_APP_VERSION_LENGTH,\n});\n"]}

package/dist/media/file-origins.d.ts

@@ -20,11 +20,8 @@ export interface PictureSize {
     readonly height: number;
 }
 export interface PictureKind {
-    /** The shape the browser crops to, the server re-crops to, and every display frames. */
     readonly aspect: PictureAspect;
-    /** Each stored size, at the kind's shape. `lg` is also the size the browser crops to. */
     readonly sizes: Readonly<Record<PictureVariantKey, PictureSize>>;
-    /** The format of the browser's crop and of every stored size. */
     readonly format: PictureStoredFormat;
     readonly cropShape: PictureCropShape;
 }

package/dist/media/file-origins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-origins.d.ts","sourceRoot":"","sources":["../../src/media/file-origins.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,mGAMtB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,qBAAqB,qDAAsD,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,gBAAgB,6IAA8D,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;AAMzD,eAAO,MAAM,wBAAwB,QAAU,CAAC;AAGhD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAIvC,eAAO,MAAM,0BAA0B,0BAA2B,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAI9E,eAAO,MAAM,uBAAuB,4BAA6B,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAIxE,eAAO,MAAM,wBAAwB,wDAAyD,CAAC;AAE/F,eAAO,MAAM,cAAc,EAAE,WAG5B,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC;IACjE,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoD6B,CAAC;AAqDxD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAElD,eAAO,MAAM,gBAAgB,EAAE,WAG9B,CAAC;AAiBF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAU5E,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAErE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}
+{"version":3,"file":"file-origins.d.ts","sourceRoot":"","sources":["../../src/media/file-origins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,eAAO,MAAM,mBAAmB,mGAMtB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,eAAO,MAAM,qBAAqB,qDAAsD,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,gBAAgB,6IAA8D,CAAC;AAC5F,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,eAAe,CAAC;AAIzD,eAAO,MAAM,wBAAwB,QAAU,CAAC;AAEhD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAIvC,eAAO,MAAM,0BAA0B,0BAA2B,CAAC;AACnE,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB,4BAA6B,CAAC;AAClE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,eAAO,MAAM,wBAAwB,wDAAyD,CAAC;AAE/F,eAAO,MAAM,cAAc,EAAE,WAG5B,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;CACtC;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmD6B,CAAC;AA+CxD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAElD,eAAO,MAAM,gBAAgB,EAAE,WAG9B,CAAC;AAiBF,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAQ5E,CAAC;AAEF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,aAAa,CAErE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEzE"}

package/dist/media/file-origins.js

@@ -1,13 +1,3 @@
-// The upload origin registry (RULE-STD-MEDIA-001, RULE-STD-MEDIA-006). One origin value binds everything an
-// upload touches: the picker spec, the staging path and its `storage.rules` cap and content type,
-// the callable that accepts the upload, and — for a picture — the processing spec and the owner the
-// picture is published to. The generic packages treat an origin id as opaque; the policy is here.
-//
-// Picture origins are processed into their kind's declared sizes and keep no master. Signature
-// origins are kept byte-exact (`preserveOriginal`) by the callable that records them and are never
-// processed. Adding an origin is one change across this registry, `storage.rules`, the processor
-// routing, and their tests; `storage.rules` restates the caps and content types, and a guard pins it
-// to this file.
 import { PICTURE_VARIANT_KEYS } from '../types/unions.js';
 import { PICTURE_ASPECT_RATIOS, pictureAspectRatio } from './picture-aspects.js';
 export const PICTURE_ORIGIN_KEYS = [
@@ -20,19 +10,12 @@ export const PICTURE_ORIGIN_KEYS = [
 export const SIGNATURE_ORIGIN_KEYS = ['waiver-signature', 'hardware-signature'];
 export const FILE_ORIGIN_KEYS = [...PICTURE_ORIGIN_KEYS, ...SIGNATURE_ORIGIN_KEYS];
 const MB = 1024 * 1024;
-// The raw cap is an abuse bound: the browser uploads a picture already cropped and shrunk to its
-// kind's largest size, so a real upload is far below it.
 export const PICTURE_UPLOAD_MAX_BYTES = 25 * MB;
-// A photo's browser crop and every stored size are JPEG at this quality.
 export const PICTURE_JPEG_QUALITY = 85;
 // What a picture kind is stored as: a photo as JPEG, a badge as PNG, which keeps the transparent
 // corners of a badge drawn round.
 export const PICTURE_STORED_FORMAT_KEYS = ['jpeg', 'png'];
-// The cropper's mask: a rectangle, or a circle for a badge — which is how a badge is drawn, though
-// the stored image is square.
 export const PICTURE_CROP_SHAPE_KEYS = ['rect', 'round'];
-// Picture formats the server's byte inspection accepts. Scriptable or unproven formats (svg, heic,
-// avif) are not accepted.
 export const PICTURE_ACCEPTED_FORMATS = ['jpeg', 'png', 'gif', 'webp', 'bmp', 'tiff'];
 export const PICTURE_ACCEPT = {
     kinds: ['image'],
@@ -79,7 +62,6 @@ export const PICTURE_KINDS = {
             lg: { width: 1280, height: 720 },
         },
     },
-    // A badge is cropped in a round mask and kept square, at the sizes every award has always had.
     'award-badge': {
         aspect: 'square',
         format: 'png',
@@ -124,9 +106,6 @@ function pictureOriginSpec(kind) {
             allowRecordAudio: false,
         },
         processing: {
-            // The server trusts nothing the browser did: an upload that bypassed the app's cropper is
-            // centre-cropped to the kind's shape (`requiredAspectRatio` with `allowAutoFormat`) before
-            // every size is cut, and a source smaller than a size is never enlarged.
             image: {
                 kind: 'image',
                 accept: PICTURE_ACCEPT,
@@ -138,9 +117,6 @@ function pictureOriginSpec(kind) {
         },
     };
 }
-// A signature is drawn on a canvas and exported as PNG, so exactly `image/png` is accepted — no
-// other image type, and never the neutral octet-stream lane. It is kept byte-exact by the callable
-// that records it, and nothing processes it.
 export const SIGNATURE_UPLOAD_MAX_BYTES = 1 * MB;
 export const SIGNATURE_CONTENT_TYPE = 'image/png';
 export const SIGNATURE_ACCEPT = {
@@ -167,9 +143,7 @@ export const MEDIA_ORIGIN_SPECS = {
     'landing-picture': pictureOriginSpec(PICTURE_KINDS['landing-picture']),
     'location-picture': pictureOriginSpec(PICTURE_KINDS['location-picture']),
     'award-badge': pictureOriginSpec(PICTURE_KINDS['award-badge']),
-    // Promoted to its kept path by the waiver-signing callable.
     'waiver-signature': signatureOriginSpec(),
-    // Promoted to its kept path by the hardware contract's signing callable.
     'hardware-signature': signatureOriginSpec(),
 };
 export function isFileOrigin(value) {

package/dist/media/file-origins.js.map

@@ -1 +1 @@
-{"version":3,"file":"file-origins.js","sourceRoot":"","sources":["../../src/media/file-origins.ts"],"names":[],"mappings":"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","sourcesContent":["// The upload origin registry (RULE-STD-MEDIA-001, RULE-STD-MEDIA-006). One origin value binds everything an\n// upload touches: the picker spec, the staging path and its `storage.rules` cap and content type,\n// the callable that accepts the upload, and — for a picture — the processing spec and the owner the\n// picture is published to. The generic packages treat an origin id as opaque; the policy is here.\n//\n// Picture origins are processed into their kind's declared sizes and keep no master. Signature\n// origins are kept byte-exact (`preserveOriginal`) by the callable that records them and are never\n// processed. Adding an origin is one change across this registry, `storage.rules`, the processor\n// routing, and their tests; `storage.rules` restates the caps and content types, and a guard pins it\n// to this file.\n\nimport type { MediaAccept, MediaOriginSpec } from '@ttt-productions/media-schemas';\nimport { PICTURE_VARIANT_KEYS } from '../types/unions.js';\nimport type { PictureVariantKey } from '../types/unions.js';\nimport { PICTURE_ASPECT_RATIOS, pictureAspectRatio } from './picture-aspects.js';\nimport type { PictureAspect } from './picture-aspects.js';\n\nexport const PICTURE_ORIGIN_KEYS = [\n  'league-picture',\n  'team-picture',\n  'landing-picture',\n  'location-picture',\n  'award-badge',\n] as const;\nexport type PictureOrigin = (typeof PICTURE_ORIGIN_KEYS)[number];\n\nexport const SIGNATURE_ORIGIN_KEYS = ['waiver-signature', 'hardware-signature'] as const;\nexport type SignatureOrigin = (typeof SIGNATURE_ORIGIN_KEYS)[number];\n\nexport const FILE_ORIGIN_KEYS = [...PICTURE_ORIGIN_KEYS, ...SIGNATURE_ORIGIN_KEYS] as const;\nexport type FileOrigin = PictureOrigin | SignatureOrigin;\n\nconst MB = 1024 * 1024;\n\n// The raw cap is an abuse bound: the browser uploads a picture already cropped and shrunk to its\n// kind's largest size, so a real upload is far below it.\nexport const PICTURE_UPLOAD_MAX_BYTES = 25 * MB;\n\n// A photo's browser crop and every stored size are JPEG at this quality.\nexport const PICTURE_JPEG_QUALITY = 85;\n\n// What a picture kind is stored as: a photo as JPEG, a badge as PNG, which keeps the transparent\n// corners of a badge drawn round.\nexport const PICTURE_STORED_FORMAT_KEYS = ['jpeg', 'png'] as const;\nexport type PictureStoredFormat = (typeof PICTURE_STORED_FORMAT_KEYS)[number];\n\n// The cropper's mask: a rectangle, or a circle for a badge — which is how a badge is drawn, though\n// the stored image is square.\nexport const PICTURE_CROP_SHAPE_KEYS = ['rect', 'round'] as const;\nexport type PictureCropShape = (typeof PICTURE_CROP_SHAPE_KEYS)[number];\n\n// Picture formats the server's byte inspection accepts. Scriptable or unproven formats (svg, heic,\n// avif) are not accepted.\nexport const PICTURE_ACCEPTED_FORMATS = ['jpeg', 'png', 'gif', 'webp', 'bmp', 'tiff'] as const;\n\nexport const PICTURE_ACCEPT: MediaAccept = {\n  kinds: ['image'],\n  formats: [...PICTURE_ACCEPTED_FORMATS],\n};\n\nexport interface PictureSize {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface PictureKind {\n  /** The shape the browser crops to, the server re-crops to, and every display frames. */\n  readonly aspect: PictureAspect;\n  /** Each stored size, at the kind's shape. `lg` is also the size the browser crops to. */\n  readonly sizes: Readonly<Record<PictureVariantKey, PictureSize>>;\n  /** The format of the browser's crop and of every stored size. */\n  readonly format: PictureStoredFormat;\n  readonly cropShape: PictureCropShape;\n}\n\nexport const PICTURE_KINDS = {\n  'league-picture': {\n    aspect: 'landscape',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 480, height: 270 },\n      md: { width: 960, height: 540 },\n      lg: { width: 1920, height: 1080 },\n    },\n  },\n  'team-picture': {\n    aspect: 'classic',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 480, height: 360 },\n      md: { width: 960, height: 720 },\n      lg: { width: 1600, height: 1200 },\n    },\n  },\n  'landing-picture': {\n    aspect: 'banner',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 720, height: 240 },\n      md: { width: 1440, height: 480 },\n      lg: { width: 2400, height: 800 },\n    },\n  },\n  'location-picture': {\n    aspect: 'landscape',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 480, height: 270 },\n      md: { width: 960, height: 540 },\n      lg: { width: 1280, height: 720 },\n    },\n  },\n  // A badge is cropped in a round mask and kept square, at the sizes every award has always had.\n  'award-badge': {\n    aspect: 'square',\n    format: 'png',\n    cropShape: 'round',\n    sizes: {\n      sm: { width: 64, height: 64 },\n      md: { width: 256, height: 256 },\n      lg: { width: 512, height: 512 },\n    },\n  },\n} as const satisfies Record<PictureOrigin, PictureKind>;\n\nfunction pictureOriginSpec(kind: PictureKind): MediaOriginSpec {\n  const ratio = pictureAspectRatio(kind.aspect);\n  const { width, height } = PICTURE_ASPECT_RATIOS[kind.aspect];\n  const variants = PICTURE_VARIANT_KEYS.map((key) => ({\n    key,\n    crop: {\n      width: kind.sizes[key].width,\n      height: kind.sizes[key].height,\n      gravity: 'center' as const,\n    },\n    format: kind.format,\n    ...(kind.format === 'jpeg' ? { quality: PICTURE_JPEG_QUALITY } : {}),\n  }));\n  return {\n    kind: 'image',\n    accept: PICTURE_ACCEPT,\n    maxBytes: PICTURE_UPLOAD_MAX_BYTES,\n    imageCrop: {\n      aspectRatio: ratio,\n      outputWidth: kind.sizes.lg.width,\n      outputHeight: kind.sizes.lg.height,\n      shape: kind.cropShape,\n      format: kind.format,\n      ...(kind.format === 'jpeg' ? { quality: PICTURE_JPEG_QUALITY } : {}),\n      aspectRatioDisplay: `${width}:${height}`,\n    },\n    client: {\n      allowPick: true,\n      allowCapturePhoto: true,\n      allowRecordVideo: false,\n      allowRecordAudio: false,\n    },\n    processing: {\n      // The server trusts nothing the browser did: an upload that bypassed the app's cropper is\n      // centre-cropped to the kind's shape (`requiredAspectRatio` with `allowAutoFormat`) before\n      // every size is cut, and a source smaller than a size is never enlarged.\n      image: {\n        kind: 'image',\n        accept: PICTURE_ACCEPT,\n        maxBytes: PICTURE_UPLOAD_MAX_BYTES,\n        requiredAspectRatio: ratio,\n        allowAutoFormat: true,\n        image: { variants, stripMetadata: true },\n      },\n    },\n  };\n}\n\n// A signature is drawn on a canvas and exported as PNG, so exactly `image/png` is accepted — no\n// other image type, and never the neutral octet-stream lane. It is kept byte-exact by the callable\n// that records it, and nothing processes it.\nexport const SIGNATURE_UPLOAD_MAX_BYTES = 1 * MB;\nexport const SIGNATURE_CONTENT_TYPE = 'image/png';\n\nexport const SIGNATURE_ACCEPT: MediaAccept = {\n  kinds: ['file'],\n  mimes: [SIGNATURE_CONTENT_TYPE],\n};\n\nfunction signatureOriginSpec(): MediaOriginSpec {\n  return {\n    kind: 'generic',\n    accept: SIGNATURE_ACCEPT,\n    maxBytes: SIGNATURE_UPLOAD_MAX_BYTES,\n    client: {\n      allowPick: false,\n      allowCapturePhoto: false,\n      allowRecordVideo: false,\n      allowRecordAudio: false,\n    },\n    preserveOriginal: true,\n  };\n}\n\nexport const MEDIA_ORIGIN_SPECS: Readonly<Record<FileOrigin, MediaOriginSpec>> = {\n  'league-picture': pictureOriginSpec(PICTURE_KINDS['league-picture']),\n  'team-picture': pictureOriginSpec(PICTURE_KINDS['team-picture']),\n  'landing-picture': pictureOriginSpec(PICTURE_KINDS['landing-picture']),\n  'location-picture': pictureOriginSpec(PICTURE_KINDS['location-picture']),\n  'award-badge': pictureOriginSpec(PICTURE_KINDS['award-badge']),\n  // Promoted to its kept path by the waiver-signing callable.\n  'waiver-signature': signatureOriginSpec(),\n  // Promoted to its kept path by the hardware contract's signing callable.\n  'hardware-signature': signatureOriginSpec(),\n};\n\nexport function isFileOrigin(value: string): value is FileOrigin {\n  return (FILE_ORIGIN_KEYS as readonly string[]).includes(value);\n}\n\nexport function isPictureOrigin(value: string): value is PictureOrigin {\n  return (PICTURE_ORIGIN_KEYS as readonly string[]).includes(value);\n}\n\nexport function isSignatureOrigin(value: string): value is SignatureOrigin {\n  return (SIGNATURE_ORIGIN_KEYS as readonly string[]).includes(value);\n}\n"]}
+{"version":3,"file":"file-origins.js","sourceRoot":"","sources":["../../src/media/file-origins.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaAccept, MediaOriginSpec } from '@ttt-productions/media-schemas';\nimport { PICTURE_VARIANT_KEYS } from '../types/unions.js';\nimport type { PictureVariantKey } from '../types/unions.js';\nimport { PICTURE_ASPECT_RATIOS, pictureAspectRatio } from './picture-aspects.js';\nimport type { PictureAspect } from './picture-aspects.js';\n\nexport const PICTURE_ORIGIN_KEYS = [\n  'league-picture',\n  'team-picture',\n  'landing-picture',\n  'location-picture',\n  'award-badge',\n] as const;\nexport type PictureOrigin = (typeof PICTURE_ORIGIN_KEYS)[number];\n\nexport const SIGNATURE_ORIGIN_KEYS = ['waiver-signature', 'hardware-signature'] as const;\nexport type SignatureOrigin = (typeof SIGNATURE_ORIGIN_KEYS)[number];\n\nexport const FILE_ORIGIN_KEYS = [...PICTURE_ORIGIN_KEYS, ...SIGNATURE_ORIGIN_KEYS] as const;\nexport type FileOrigin = PictureOrigin | SignatureOrigin;\n\nconst MB = 1024 * 1024;\n\nexport const PICTURE_UPLOAD_MAX_BYTES = 25 * MB;\n\nexport const PICTURE_JPEG_QUALITY = 85;\n\n// What a picture kind is stored as: a photo as JPEG, a badge as PNG, which keeps the transparent\n// corners of a badge drawn round.\nexport const PICTURE_STORED_FORMAT_KEYS = ['jpeg', 'png'] as const;\nexport type PictureStoredFormat = (typeof PICTURE_STORED_FORMAT_KEYS)[number];\n\nexport const PICTURE_CROP_SHAPE_KEYS = ['rect', 'round'] as const;\nexport type PictureCropShape = (typeof PICTURE_CROP_SHAPE_KEYS)[number];\n\nexport const PICTURE_ACCEPTED_FORMATS = ['jpeg', 'png', 'gif', 'webp', 'bmp', 'tiff'] as const;\n\nexport const PICTURE_ACCEPT: MediaAccept = {\n  kinds: ['image'],\n  formats: [...PICTURE_ACCEPTED_FORMATS],\n};\n\nexport interface PictureSize {\n  readonly width: number;\n  readonly height: number;\n}\n\nexport interface PictureKind {\n  readonly aspect: PictureAspect;\n  readonly sizes: Readonly<Record<PictureVariantKey, PictureSize>>;\n  readonly format: PictureStoredFormat;\n  readonly cropShape: PictureCropShape;\n}\n\nexport const PICTURE_KINDS = {\n  'league-picture': {\n    aspect: 'landscape',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 480, height: 270 },\n      md: { width: 960, height: 540 },\n      lg: { width: 1920, height: 1080 },\n    },\n  },\n  'team-picture': {\n    aspect: 'classic',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 480, height: 360 },\n      md: { width: 960, height: 720 },\n      lg: { width: 1600, height: 1200 },\n    },\n  },\n  'landing-picture': {\n    aspect: 'banner',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 720, height: 240 },\n      md: { width: 1440, height: 480 },\n      lg: { width: 2400, height: 800 },\n    },\n  },\n  'location-picture': {\n    aspect: 'landscape',\n    format: 'jpeg',\n    cropShape: 'rect',\n    sizes: {\n      sm: { width: 480, height: 270 },\n      md: { width: 960, height: 540 },\n      lg: { width: 1280, height: 720 },\n    },\n  },\n  'award-badge': {\n    aspect: 'square',\n    format: 'png',\n    cropShape: 'round',\n    sizes: {\n      sm: { width: 64, height: 64 },\n      md: { width: 256, height: 256 },\n      lg: { width: 512, height: 512 },\n    },\n  },\n} as const satisfies Record<PictureOrigin, PictureKind>;\n\nfunction pictureOriginSpec(kind: PictureKind): MediaOriginSpec {\n  const ratio = pictureAspectRatio(kind.aspect);\n  const { width, height } = PICTURE_ASPECT_RATIOS[kind.aspect];\n  const variants = PICTURE_VARIANT_KEYS.map((key) => ({\n    key,\n    crop: {\n      width: kind.sizes[key].width,\n      height: kind.sizes[key].height,\n      gravity: 'center' as const,\n    },\n    format: kind.format,\n    ...(kind.format === 'jpeg' ? { quality: PICTURE_JPEG_QUALITY } : {}),\n  }));\n  return {\n    kind: 'image',\n    accept: PICTURE_ACCEPT,\n    maxBytes: PICTURE_UPLOAD_MAX_BYTES,\n    imageCrop: {\n      aspectRatio: ratio,\n      outputWidth: kind.sizes.lg.width,\n      outputHeight: kind.sizes.lg.height,\n      shape: kind.cropShape,\n      format: kind.format,\n      ...(kind.format === 'jpeg' ? { quality: PICTURE_JPEG_QUALITY } : {}),\n      aspectRatioDisplay: `${width}:${height}`,\n    },\n    client: {\n      allowPick: true,\n      allowCapturePhoto: true,\n      allowRecordVideo: false,\n      allowRecordAudio: false,\n    },\n    processing: {\n      image: {\n        kind: 'image',\n        accept: PICTURE_ACCEPT,\n        maxBytes: PICTURE_UPLOAD_MAX_BYTES,\n        requiredAspectRatio: ratio,\n        allowAutoFormat: true,\n        image: { variants, stripMetadata: true },\n      },\n    },\n  };\n}\n\nexport const SIGNATURE_UPLOAD_MAX_BYTES = 1 * MB;\nexport const SIGNATURE_CONTENT_TYPE = 'image/png';\n\nexport const SIGNATURE_ACCEPT: MediaAccept = {\n  kinds: ['file'],\n  mimes: [SIGNATURE_CONTENT_TYPE],\n};\n\nfunction signatureOriginSpec(): MediaOriginSpec {\n  return {\n    kind: 'generic',\n    accept: SIGNATURE_ACCEPT,\n    maxBytes: SIGNATURE_UPLOAD_MAX_BYTES,\n    client: {\n      allowPick: false,\n      allowCapturePhoto: false,\n      allowRecordVideo: false,\n      allowRecordAudio: false,\n    },\n    preserveOriginal: true,\n  };\n}\n\nexport const MEDIA_ORIGIN_SPECS: Readonly<Record<FileOrigin, MediaOriginSpec>> = {\n  'league-picture': pictureOriginSpec(PICTURE_KINDS['league-picture']),\n  'team-picture': pictureOriginSpec(PICTURE_KINDS['team-picture']),\n  'landing-picture': pictureOriginSpec(PICTURE_KINDS['landing-picture']),\n  'location-picture': pictureOriginSpec(PICTURE_KINDS['location-picture']),\n  'award-badge': pictureOriginSpec(PICTURE_KINDS['award-badge']),\n  'waiver-signature': signatureOriginSpec(),\n  'hardware-signature': signatureOriginSpec(),\n};\n\nexport function isFileOrigin(value: string): value is FileOrigin {\n  return (FILE_ORIGIN_KEYS as readonly string[]).includes(value);\n}\n\nexport function isPictureOrigin(value: string): value is PictureOrigin {\n  return (PICTURE_ORIGIN_KEYS as readonly string[]).includes(value);\n}\n\nexport function isSignatureOrigin(value: string): value is SignatureOrigin {\n  return (SIGNATURE_ORIGIN_KEYS as readonly string[]).includes(value);\n}\n"]}

package/dist/media/picture-aspects.d.ts

@@ -4,7 +4,6 @@ export interface PictureAspectRatio {
     readonly width: number;
     readonly height: number;
 }
-/** Each shape as whole numbers, width to height — the form a CSS `aspect-ratio` and "16:9" take. */
 export declare const PICTURE_ASPECT_RATIOS: {
     readonly square: {
         readonly width: 1;
@@ -23,6 +22,5 @@ export declare const PICTURE_ASPECT_RATIOS: {
         readonly height: 1;
     };
 };
-/** The shape as one number, width over height — the form a crop or processing spec takes. */
 export declare function pictureAspectRatio(aspect: PictureAspect): number;
 //# sourceMappingURL=picture-aspects.d.ts.map