xpt-shared-types 1.24.0 → 1.25.0

package/dist/generated/inputs.d.ts

@@ -419,6 +419,11 @@ export interface TournamentTemplateInput {
     hasThirdPlace?: boolean;
     hasMatchLobby?: boolean;
     rules?: string;
+    platform?: RelationInput;
+    gameAccount?: RelationInput;
+    region?: RelationInput;
+    imgMain?: MediaInput;
+    prizes?: unknown;
     isDefault?: boolean;
     useCount?: number;
     lastUsedAt?: string;

package/dist/generated/models.d.ts

@@ -419,6 +419,11 @@ export interface TournamentTemplate extends StrapiDocument {
     hasThirdPlace?: boolean | null;
     hasMatchLobby?: boolean | null;
     rules?: string | null;
+    platform?: Platform | null;
+    gameAccount?: GameAccount | null;
+    region?: Region | null;
+    imgMain?: StrapiMedia | null;
+    prizes?: unknown | null;
     isDefault?: boolean | null;
     useCount?: number | null;
     lastUsedAt?: string | null;

package/dist/manual/tournamentTemplate.d.ts

@@ -10,13 +10,19 @@
  * last `LAST_RUN_WINDOW_DAYS` — so a host can repeat a night without ever
  * having saved anything.
  *
+ * What a setup carries is close to the whole publish checklist: the catalogue
+ * choice (platform and account network), the region, the banner and the prize
+ * amounts ride along with the shape and the rules. Only the date is left out,
+ * because it belongs to one event rather than to the setup.
+ *
  * Routes (all scoped to the caller):
  *  - `GET /tournament-templates/setups` → `{ data: TournamentSetupsResponse }`
  *  - `POST /tournament-templates` with `SaveTemplateBody` → `{ data: TournamentTemplateSummary }`
  *  - `PUT /tournament-templates/:id/default` → `{ data: TournamentTemplateSummary }`
  *  - `DELETE /tournament-templates/:id`
- *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules` and
- *    `template` (the documentId, for usage meta) alongside the usual fields.
+ *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules`, `region`,
+ *    `platform`, `gameAccount`, `imgMain`, `prizes` and `template` (the
+ *    documentId, for usage meta) alongside the usual fields.
  */
 import type { StrapiMedia } from '../contracts';
 import type { TournamentTeamSize } from '../generated/enums';
@@ -24,10 +30,29 @@ import type { TournamentTeamSize } from '../generated/enums';
 export declare const LAST_RUN_WINDOW_DAYS = 30;
 /** Templates a host may keep; the save route refuses the next one. */
 export declare const MAX_TEMPLATES_PER_HOST = 20;
-/** The settings a host may leave out of a template — the "Also copied" rows. */
-export declare const TEMPLATE_COPY_KEYS: readonly ["entryFee", "checkInTime", "hasMatchLobby", "hasThirdPlace", "rules"];
+/**
+ * The settings a host may leave out of a setup — the "Also copied" rows.
+ * `platform` covers the account network too: the two are chosen together and
+ * publish readiness counts them as one detail.
+ */
+export declare const TEMPLATE_COPY_KEYS: readonly ["entryFee", "prizes", "checkInTime", "platform", "region", "hasMatchLobby", "hasThirdPlace", "rules", "imgMain"];
 export type TemplateCopyKey = (typeof TEMPLATE_COPY_KEYS)[number];
 export type TemplateIncludeFlags = Record<TemplateCopyKey, boolean>;
+/** A catalogue row as a setup names it. */
+export interface SetupRef {
+    documentId: string;
+    name: string | null;
+}
+/** One placement's payout. The set of ranks is derived, never carried. */
+export interface SetupPrize {
+    rank: string;
+    value: number | null;
+}
+/** The banner, as the media row a new tournament reuses. */
+export interface SetupBanner {
+    id: number;
+    url: string | null;
+}
 export interface TournamentSetupFields {
     participants: number;
     teamSize: TournamentTeamSize;
@@ -38,6 +63,12 @@ export interface TournamentSetupFields {
     hasThirdPlace: boolean | null;
     hasMatchLobby: boolean | null;
     rules: string | null;
+    platform: SetupRef | null;
+    /** Rides with `platform`; the create refuses it if the catalogue has moved. */
+    gameAccount: SetupRef | null;
+    region: SetupRef | null;
+    imgMain: SetupBanner | null;
+    prizes: SetupPrize[];
 }
 /** What a blank tournament starts from, and what a null setting falls back to. */
 export declare const TOURNAMENT_SETUP_DEFAULTS: TournamentSetupFields;
@@ -93,9 +124,21 @@ export type SetupChoice = {
 /** Every setting resolved: nulls replaced by the XPT default. */
 export declare function resolveSetup(fields: Partial<TournamentSetupFields> | null | undefined): TournamentSetupFields;
 /**
- * The name a tournament started from a setup gets: a trailing `#N` is bumped
- * (`Friday Night Ops #3` → `Friday Night Ops #4`); anything else is copied
- * verbatim.
+ * The copy keys this setup actually has something for. A setting the host
+ * unticked when saving, or never set on the tournament, carries nothing — so
+ * the "Also copied" list offers it no row rather than a tickable blank.
+ */
+export declare function copyableSetupKeys(fields: Partial<TournamentSetupFields> | null | undefined): TemplateCopyKey[];
+/** The total a setup's prize amounts add up to. */
+export declare const setupPrizePot: (prizes: SetupPrize[] | null | undefined) => number;
+/** The tournament title rules' limit; a bumped name has to stay inside it. */
+export declare const MAX_TOURNAMENT_NAME = 50;
+/**
+ * The name a tournament started from a setup gets. A trailing `#N` is bumped
+ * (`Friday Night Ops #3` → `Friday Night Ops #4`); a name without one is
+ * treated as the first of its series and becomes `#2`. Either way the host
+ * sees a name they can keep or type over, and never one that silently
+ * duplicates the tournament it came from.
  */
 export declare function nextTournamentName(name: string): string;
 /** A template name from a tournament title: the trailing `#N`, if any, dropped. */

package/dist/manual/tournamentTemplate.js

@@ -11,17 +11,24 @@
  * last `LAST_RUN_WINDOW_DAYS` — so a host can repeat a night without ever
  * having saved anything.
  *
+ * What a setup carries is close to the whole publish checklist: the catalogue
+ * choice (platform and account network), the region, the banner and the prize
+ * amounts ride along with the shape and the rules. Only the date is left out,
+ * because it belongs to one event rather than to the setup.
+ *
  * Routes (all scoped to the caller):
  *  - `GET /tournament-templates/setups` → `{ data: TournamentSetupsResponse }`
  *  - `POST /tournament-templates` with `SaveTemplateBody` → `{ data: TournamentTemplateSummary }`
  *  - `PUT /tournament-templates/:id/default` → `{ data: TournamentTemplateSummary }`
  *  - `DELETE /tournament-templates/:id`
- *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules` and
- *    `template` (the documentId, for usage meta) alongside the usual fields.
+ *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules`, `region`,
+ *    `platform`, `gameAccount`, `imgMain`, `prizes` and `template` (the
+ *    documentId, for usage meta) alongside the usual fields.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TOURNAMENT_SETUP_DEFAULTS = exports.TEMPLATE_COPY_KEYS = exports.MAX_TEMPLATES_PER_HOST = exports.LAST_RUN_WINDOW_DAYS = void 0;
+exports.MAX_TOURNAMENT_NAME = exports.setupPrizePot = exports.TOURNAMENT_SETUP_DEFAULTS = exports.TEMPLATE_COPY_KEYS = exports.MAX_TEMPLATES_PER_HOST = exports.LAST_RUN_WINDOW_DAYS = void 0;
 exports.resolveSetup = resolveSetup;
+exports.copyableSetupKeys = copyableSetupKeys;
 exports.nextTournamentName = nextTournamentName;
 exports.templateNameFrom = templateNameFrom;
 exports.setupsForGame = setupsForGame;
@@ -34,13 +41,21 @@ exports.describeSetup = describeSetup;
 exports.LAST_RUN_WINDOW_DAYS = 30;
 /** Templates a host may keep; the save route refuses the next one. */
 exports.MAX_TEMPLATES_PER_HOST = 20;
-/** The settings a host may leave out of a template — the "Also copied" rows. */
+/**
+ * The settings a host may leave out of a setup — the "Also copied" rows.
+ * `platform` covers the account network too: the two are chosen together and
+ * publish readiness counts them as one detail.
+ */
 exports.TEMPLATE_COPY_KEYS = [
     'entryFee',
+    'prizes',
     'checkInTime',
+    'platform',
+    'region',
     'hasMatchLobby',
     'hasThirdPlace',
     'rules',
+    'imgMain',
 ];
 /** What a blank tournament starts from, and what a null setting falls back to. */
 exports.TOURNAMENT_SETUP_DEFAULTS = {
@@ -51,10 +66,15 @@ exports.TOURNAMENT_SETUP_DEFAULTS = {
     hasThirdPlace: false,
     hasMatchLobby: true,
     rules: null,
+    platform: null,
+    gameAccount: null,
+    region: null,
+    imgMain: null,
+    prizes: [],
 };
 /** Every setting resolved: nulls replaced by the XPT default. */
 function resolveSetup(fields) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
     const source = fields !== null && fields !== void 0 ? fields : {};
     return {
         participants: source.participants || exports.TOURNAMENT_SETUP_DEFAULTS.participants,
@@ -64,20 +84,55 @@ function resolveSetup(fields) {
         hasThirdPlace: (_d = source.hasThirdPlace) !== null && _d !== void 0 ? _d : exports.TOURNAMENT_SETUP_DEFAULTS.hasThirdPlace,
         hasMatchLobby: (_e = source.hasMatchLobby) !== null && _e !== void 0 ? _e : exports.TOURNAMENT_SETUP_DEFAULTS.hasMatchLobby,
         rules: (_f = source.rules) !== null && _f !== void 0 ? _f : exports.TOURNAMENT_SETUP_DEFAULTS.rules,
+        platform: (_g = source.platform) !== null && _g !== void 0 ? _g : null,
+        gameAccount: (_h = source.gameAccount) !== null && _h !== void 0 ? _h : null,
+        region: (_j = source.region) !== null && _j !== void 0 ? _j : null,
+        imgMain: (_k = source.imgMain) !== null && _k !== void 0 ? _k : null,
+        prizes: (_l = source.prizes) !== null && _l !== void 0 ? _l : [],
+    };
+}
+/**
+ * The copy keys this setup actually has something for. A setting the host
+ * unticked when saving, or never set on the tournament, carries nothing — so
+ * the "Also copied" list offers it no row rather than a tickable blank.
+ */
+function copyableSetupKeys(fields) {
+    var _a;
+    const setup = fields !== null && fields !== void 0 ? fields : {};
+    const has = {
+        entryFee: setup.entryFee != null,
+        prizes: ((_a = setup.prizes) !== null && _a !== void 0 ? _a : []).length > 0,
+        checkInTime: setup.checkInTime != null,
+        platform: setup.platform != null,
+        region: setup.region != null,
+        hasMatchLobby: setup.hasMatchLobby != null,
+        hasThirdPlace: setup.hasThirdPlace != null,
+        rules: !!setup.rules,
+        imgMain: setup.imgMain != null,
     };
+    return exports.TEMPLATE_COPY_KEYS.filter((key) => has[key]);
 }
+/** The total a setup's prize amounts add up to. */
+const setupPrizePot = (prizes) => (prizes !== null && prizes !== void 0 ? prizes : []).reduce((sum, prize) => sum + (Number(prize.value) || 0), 0);
+exports.setupPrizePot = setupPrizePot;
 const TRAILING_COUNTER = /\s*#(\d+)$/;
+/** The tournament title rules' limit; a bumped name has to stay inside it. */
+exports.MAX_TOURNAMENT_NAME = 50;
 /**
- * The name a tournament started from a setup gets: a trailing `#N` is bumped
- * (`Friday Night Ops #3` → `Friday Night Ops #4`); anything else is copied
- * verbatim.
+ * The name a tournament started from a setup gets. A trailing `#N` is bumped
+ * (`Friday Night Ops #3` → `Friday Night Ops #4`); a name without one is
+ * treated as the first of its series and becomes `#2`. Either way the host
+ * sees a name they can keep or type over, and never one that silently
+ * duplicates the tournament it came from.
  */
 function nextTournamentName(name) {
     const match = TRAILING_COUNTER.exec(name);
-    if (!match)
+    const base = (match ? name.slice(0, match.index) : name).trim();
+    if (!base)
         return name;
-    const next = Number(match[1]) + 1;
-    return `${name.slice(0, match.index).trimEnd()} #${next}`;
+    const suffix = ` #${match ? Number(match[1]) + 1 : 2}`;
+    const room = exports.MAX_TOURNAMENT_NAME - suffix.length;
+    return `${base.length > room ? base.slice(0, room).trim() : base}${suffix}`;
 }
 /** A template name from a tournament title: the trailing `#N`, if any, dropped. */
 function templateNameFrom(title) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xpt-shared-types",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "Shared types and data for XPT projects",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/generated/inputs.ts

@@ -506,6 +506,11 @@ export interface TournamentTemplateInput {
   hasThirdPlace?: boolean;
   hasMatchLobby?: boolean;
   rules?: string;
+  platform?: RelationInput;
+  gameAccount?: RelationInput;
+  region?: RelationInput;
+  imgMain?: MediaInput;
+  prizes?: unknown;
   isDefault?: boolean;
   useCount?: number;
   lastUsedAt?: string;

package/src/generated/models.ts

@@ -507,6 +507,11 @@ export interface TournamentTemplate extends StrapiDocument {
   hasThirdPlace?: boolean | null;
   hasMatchLobby?: boolean | null;
   rules?: string | null;
+  platform?: Platform | null;
+  gameAccount?: GameAccount | null;
+  region?: Region | null;
+  imgMain?: StrapiMedia | null;
+  prizes?: unknown | null;
   isDefault?: boolean | null;
   useCount?: number | null;
   lastUsedAt?: string | null;

package/src/manual/tournamentTemplate.ts

@@ -10,13 +10,19 @@
  * last `LAST_RUN_WINDOW_DAYS` — so a host can repeat a night without ever
  * having saved anything.
  *
+ * What a setup carries is close to the whole publish checklist: the catalogue
+ * choice (platform and account network), the region, the banner and the prize
+ * amounts ride along with the shape and the rules. Only the date is left out,
+ * because it belongs to one event rather than to the setup.
+ *
  * Routes (all scoped to the caller):
  *  - `GET /tournament-templates/setups` → `{ data: TournamentSetupsResponse }`
  *  - `POST /tournament-templates` with `SaveTemplateBody` → `{ data: TournamentTemplateSummary }`
  *  - `PUT /tournament-templates/:id/default` → `{ data: TournamentTemplateSummary }`
  *  - `DELETE /tournament-templates/:id`
- *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules` and
- *    `template` (the documentId, for usage meta) alongside the usual fields.
+ *  - `POST /tournaments` accepts `entryFee`, `checkInTime`, `rules`, `region`,
+ *    `platform`, `gameAccount`, `imgMain`, `prizes` and `template` (the
+ *    documentId, for usage meta) alongside the usual fields.
  */
 
 import type { StrapiMedia } from '../contracts';
@@ -28,18 +34,44 @@ export const LAST_RUN_WINDOW_DAYS = 30;
 /** Templates a host may keep; the save route refuses the next one. */
 export const MAX_TEMPLATES_PER_HOST = 20;
 
-/** The settings a host may leave out of a template — the "Also copied" rows. */
+/**
+ * The settings a host may leave out of a setup — the "Also copied" rows.
+ * `platform` covers the account network too: the two are chosen together and
+ * publish readiness counts them as one detail.
+ */
 export const TEMPLATE_COPY_KEYS = [
   'entryFee',
+  'prizes',
   'checkInTime',
+  'platform',
+  'region',
   'hasMatchLobby',
   'hasThirdPlace',
   'rules',
+  'imgMain',
 ] as const;
 
 export type TemplateCopyKey = (typeof TEMPLATE_COPY_KEYS)[number];
 export type TemplateIncludeFlags = Record<TemplateCopyKey, boolean>;
 
+/** A catalogue row as a setup names it. */
+export interface SetupRef {
+  documentId: string;
+  name: string | null;
+}
+
+/** One placement's payout. The set of ranks is derived, never carried. */
+export interface SetupPrize {
+  rank: string;
+  value: number | null;
+}
+
+/** The banner, as the media row a new tournament reuses. */
+export interface SetupBanner {
+  id: number;
+  url: string | null;
+}
+
 export interface TournamentSetupFields {
   participants: number;
   teamSize: TournamentTeamSize;
@@ -50,6 +82,12 @@ export interface TournamentSetupFields {
   hasThirdPlace: boolean | null;
   hasMatchLobby: boolean | null;
   rules: string | null;
+  platform: SetupRef | null;
+  /** Rides with `platform`; the create refuses it if the catalogue has moved. */
+  gameAccount: SetupRef | null;
+  region: SetupRef | null;
+  imgMain: SetupBanner | null;
+  prizes: SetupPrize[];
 }
 
 /** What a blank tournament starts from, and what a null setting falls back to. */
@@ -61,6 +99,11 @@ export const TOURNAMENT_SETUP_DEFAULTS: TournamentSetupFields = {
   hasThirdPlace: false,
   hasMatchLobby: true,
   rules: null,
+  platform: null,
+  gameAccount: null,
+  region: null,
+  imgMain: null,
+  prizes: [],
 };
 
 /** Enough of a game for the client to open the create dialog on it. */
@@ -126,21 +169,61 @@ export function resolveSetup(
     hasThirdPlace: source.hasThirdPlace ?? TOURNAMENT_SETUP_DEFAULTS.hasThirdPlace,
     hasMatchLobby: source.hasMatchLobby ?? TOURNAMENT_SETUP_DEFAULTS.hasMatchLobby,
     rules: source.rules ?? TOURNAMENT_SETUP_DEFAULTS.rules,
+    platform: source.platform ?? null,
+    gameAccount: source.gameAccount ?? null,
+    region: source.region ?? null,
+    imgMain: source.imgMain ?? null,
+    prizes: source.prizes ?? [],
+  };
+}
+
+/**
+ * The copy keys this setup actually has something for. A setting the host
+ * unticked when saving, or never set on the tournament, carries nothing — so
+ * the "Also copied" list offers it no row rather than a tickable blank.
+ */
+export function copyableSetupKeys(
+  fields: Partial<TournamentSetupFields> | null | undefined
+): TemplateCopyKey[] {
+  const setup = fields ?? {};
+  const has: Record<TemplateCopyKey, boolean> = {
+    entryFee: setup.entryFee != null,
+    prizes: (setup.prizes ?? []).length > 0,
+    checkInTime: setup.checkInTime != null,
+    platform: setup.platform != null,
+    region: setup.region != null,
+    hasMatchLobby: setup.hasMatchLobby != null,
+    hasThirdPlace: setup.hasThirdPlace != null,
+    rules: !!setup.rules,
+    imgMain: setup.imgMain != null,
   };
+  return TEMPLATE_COPY_KEYS.filter((key) => has[key]);
 }
 
+/** The total a setup's prize amounts add up to. */
+export const setupPrizePot = (prizes: SetupPrize[] | null | undefined): number =>
+  (prizes ?? []).reduce((sum, prize) => sum + (Number(prize.value) || 0), 0);
+
 const TRAILING_COUNTER = /\s*#(\d+)$/;
 
+/** The tournament title rules' limit; a bumped name has to stay inside it. */
+export const MAX_TOURNAMENT_NAME = 50;
+
 /**
- * The name a tournament started from a setup gets: a trailing `#N` is bumped
- * (`Friday Night Ops #3` → `Friday Night Ops #4`); anything else is copied
- * verbatim.
+ * The name a tournament started from a setup gets. A trailing `#N` is bumped
+ * (`Friday Night Ops #3` → `Friday Night Ops #4`); a name without one is
+ * treated as the first of its series and becomes `#2`. Either way the host
+ * sees a name they can keep or type over, and never one that silently
+ * duplicates the tournament it came from.
  */
 export function nextTournamentName(name: string): string {
   const match = TRAILING_COUNTER.exec(name);
-  if (!match) return name;
-  const next = Number(match[1]) + 1;
-  return `${name.slice(0, match.index).trimEnd()} #${next}`;
+  const base = (match ? name.slice(0, match.index) : name).trim();
+  if (!base) return name;
+
+  const suffix = ` #${match ? Number(match[1]) + 1 : 2}`;
+  const room = MAX_TOURNAMENT_NAME - suffix.length;
+  return `${base.length > room ? base.slice(0, room).trim() : base}${suffix}`;
 }
 
 /** A template name from a tournament title: the trailing `#N`, if any, dropped. */