tods-competition-factory 1.6.28 → 1.6.30

package/README.md

@@ -1,7 +1,7 @@
-[![NPM](https://img.shields.io/npm/v/tods-competition-factory)](https://www.npmjs.com/package/tods-competition-factory)
-
 # Competition Factory
 
+[![NPM](https://img.shields.io/npm/v/tods-competition-factory)](https://www.npmjs.com/package/tods-competition-factory)
+
 [Online Documentation with examples](https://courthive.github.io/tods-competition-factory/)
 
 ## Tournament Business Rules
@@ -39,7 +39,7 @@ By default a deep copy of documents are made as they are loaded into each state
 ## Other Utilities
 
 1. [**mocksEngine**](./overview/mocks-engine-overview) - generates complete tournament objects, or tournamentRecords, as well as mock persons, participants and matchUp outcomes.
-   It is used extensively in the ~1800 tests that are run against the factory methods before every package release.
+   It is used extensively in the ~1850 tests that are run against the factory methods before every package release.
 2. [**scoreGovernor**](./scoreGovernor) - is a collection of scoring related utilities which provide analysis/validation or generate values, but do not make any mutations.
 3. [**matchUpFormatCode**](./codes/matchup-format) - is an ITF matchUp format code parser, stringifier, and validator.
 4. [**ageCategoryCode**](./codes/age-category) - is an ITF ageCategoryCode parser.

package/dist/forge/generate.d.ts

@@ -1458,9 +1458,10 @@ type GenerateDrawDefinitionArgs = {
     considerEventEntries?: boolean;
     hydrateCollections?: boolean;
     tournamentRecord: Tournament;
-    drawMatic?: DrawMaticArgs;
+    drawTypeCoercion?: boolean;
     ignoreStageSpace?: boolean;
     qualifyingProfiles?: any[];
+    drawMatic?: DrawMaticArgs;
     qualifyingOnly?: boolean;
     drawType?: DrawTypeEnum;
     enforceGender?: boolean;

package/dist/forge/generate.mjs

@@ -750,7 +750,8 @@ var syncGlobalState$1 = {
   setSubscriptions,
   setTournamentId,
   setTournamentRecord,
-  setTournamentRecords
+  setTournamentRecords,
+  handleCaughtError
 };
 function disableNotifications$1() {
   syncGlobalState.disableNotifications = true;
@@ -856,6 +857,26 @@ function callListener({ topic, notices }) {
     method(notices);
   }
 }
+function handleCaughtError({
+  engineName,
+  methodName,
+  params,
+  err
+}) {
+  let error;
+  if (typeof err === "string") {
+    error = err.toUpperCase();
+  } else if (err instanceof Error) {
+    error = err.message;
+  }
+  console.log("ERROR", {
+    tournamentId: getTournamentId(),
+    params: JSON.stringify(params),
+    engine: engineName,
+    methodName,
+    error
+  });
+}
 
 const globalState = {
   tournamentFactoryVersion: "0.0.0",
@@ -14458,9 +14479,9 @@ function processPlayoffGroups({
   for (const playoffGroup of playoffGroups) {
     const finishingPositions = playoffGroup.finishingPositions;
     const positionsPlayedOff = positionRangeMap && finishingPositions.map((p) => positionRangeMap[p]?.finishingPositions).flat();
-    const playoffDrawType = playoffGroup.drawType || SINGLE_ELIMINATION;
     const participantsInDraw = groupCount * finishingPositions.length;
     const drawSize = nextPowerOf2(participantsInDraw);
+    const playoffDrawType = drawSize === 2 && SINGLE_ELIMINATION || playoffGroup.drawType || SINGLE_ELIMINATION;
     if (positionsPlayedOff) {
       finishingPositionOffset = Math.min(...positionsPlayedOff) - 1;
     }
@@ -20159,8 +20180,6 @@ function generateDrawStructuresAndLinks(params) {
   const {
     enforceMinimumDrawSize = true,
     overwriteExisting,
-    drawTypeCoercion,
-    // coerce to SINGLE_ELIMINATION for drawSize: 2
     appliedPolicies,
     staggeredEntry,
     // optional - specifies main structure FEED_IN for drawTypes CURTIS_CONSOLATION, FEED_IN_CHAMPIONSHIPS, FMLC
@@ -20170,8 +20189,9 @@ function generateDrawStructuresAndLinks(params) {
     isMock,
     uuids
   } = params || {};
+  const drawTypeCoercion = params.drawTypeCoercion ?? appliedPolicies?.[POLICY_TYPE_DRAWS]?.drawTypeCoercion ?? true;
   const stack = "generateDrawStructuresAndLinks";
-  let drawType = params.drawType ?? SINGLE_ELIMINATION;
+  let drawType = drawTypeCoercion && params.drawSize === 2 && DrawTypeEnum.SingleElimination || params.drawType || DrawTypeEnum.SingleElimination;
   const structures = [], links = [];
   const matchUpType = params?.matchUpType ?? SINGLES$1;
   const existingQualifyingStructures = drawDefinition?.structures?.filter(
@@ -20860,9 +20880,12 @@ function isUngrouped(entryStatus) {
 
 function checkValidEntries({
   enforceGender = true,
+  consideredEntries,
+  tournamentRecord,
   participants,
   event
 }) {
+  participants = participants || tournamentRecord?.participants;
   if (!participants)
     return { error: MISSING_PARTICIPANTS };
   if (!Array.isArray(participants))
@@ -20873,7 +20896,7 @@ function checkValidEntries({
   const participantType = eventType === TEAM_EVENT && TEAM || eventType === DOUBLES_EVENT && PAIR || INDIVIDUAL;
   const entryStatusMap = Object.assign(
     {},
-    ...(event.entries || []).map((entry) => ({
+    ...(consideredEntries || event.entries || []).map((entry) => ({
       [entry.participantId]: entry.entryStatus
     }))
   );
@@ -22647,7 +22670,6 @@ const POLICY_SEEDING_USTA = {
 function generateDrawDefinition(params) {
   const stack = "generateDrawDefinition";
   const {
-    drawType = DrawTypeEnum.SingleElimination,
     considerEventEntries = true,
     // in the absence of drawSize and drawEntries, look to event.entries
     ignoreAllowedDrawTypes,
@@ -22663,18 +22685,17 @@ function generateDrawDefinition(params) {
     placeByes,
     event
   } = params;
-  const { tournamentParticipants: participants } = getTournamentParticipants({
-    tournamentRecord,
-    inContext: true
-  });
   const appliedPolicies = getAppliedPolicies({
     tournamentRecord,
     event
   }).appliedPolicies ?? {};
+  const drawTypeCoercion = params.drawTypeCoercion ?? appliedPolicies?.[POLICY_TYPE_DRAWS]?.drawTypeCoercion ?? true;
+  const drawType = drawTypeCoercion && params.drawSize === 2 && DrawTypeEnum.SingleElimination || params.drawType || DrawTypeEnum.SingleElimination;
+  const { tournamentParticipants: participants } = getTournamentParticipants({
+    tournamentRecord,
+    inContext: true
+  });
   const enforceGender = params.enforceGender ?? policyDefinitions?.[POLICY_TYPE_MATCHUP_ACTIONS]?.participants?.enforceGender ?? appliedPolicies?.[POLICY_TYPE_MATCHUP_ACTIONS]?.participants?.enforceGender;
-  const validEntriesResult = event && participants && checkValidEntries({ event, participants, enforceGender });
-  if (validEntriesResult?.error)
-    return decorateResult({ result: validEntriesResult, stack });
   const allowedDrawTypes = !ignoreAllowedDrawTypes && tournamentRecord && getAllowedDrawTypes({
     tournamentRecord,
     categoryType: event?.category?.categoryType,
@@ -22687,6 +22708,14 @@ function generateDrawDefinition(params) {
     (entry) => entry.entryStatus && [...STRUCTURE_ENTERED_TYPES, QUALIFIER].includes(entry.entryStatus)
   ) ?? [];
   const consideredEntries = (qualifyingOnly && [] || drawEntries || (considerEventEntries ? eventEntries : [])).filter(({ entryStage }) => !entryStage || entryStage === MAIN);
+  const validEntriesResult = event && participants && checkValidEntries({
+    consideredEntries,
+    enforceGender,
+    participants,
+    event
+  });
+  if (validEntriesResult?.error)
+    return decorateResult({ result: validEntriesResult, stack });
   const derivedDrawSize = !params.drawSize && consideredEntries.length && ![
     AD_HOC,
     DOUBLE_ELIMINATION,