volleyballsimtypes 0.0.519 → 0.0.521

package/dist/cjs/src/service/player/stats.test.js

@@ -64,10 +64,10 @@ function makeStats(base = 50, overrides = {}) {
             const total = Object.values(m).reduce((s, v) => s + (v ?? 0), 0);
             (0, globals_1.expect)(total).toBeCloseTo(1, 10);
         });
-        (0, globals_1.it)('reception has the highest weight (0.75)', () => {
+        (0, globals_1.it)('reflex has the highest weight (reflex gates the reach + lunge-save)', () => {
             const m = (0, stats_1.getMultipliers)(stats_1.StatsEnum.RECEIVE);
             const max = Math.max(...Object.values(m).map(v => v ?? 0));
-            (0, globals_1.expect)(m.reception).toBe(max);
+            (0, globals_1.expect)(m.reflex).toBe(max);
         });
     });
     (0, globals_1.describe)('SERVE', () => {
@@ -147,11 +147,11 @@ function makeStats(base = 50, overrides = {}) {
         const strong = (0, stats_1.calculateStatScore)(makeStats(80), stats_1.StatsEnum.SERVE);
         (0, globals_1.expect)(strong).toBeGreaterThan(weak);
     });
-    (0, globals_1.it)('SERVE: serve=99 dominates, contributing 0.85 of the total', () => {
-        // All other serve-relevant stats at 1: awareness=1, attack=1
-        // score ≈ 99*0.85 + 1*0.075 + 1*0.075 = 84.15 + 0.15 = 84.3 → 84
+    (0, globals_1.it)('SERVE: serve=99 dominates, contributing 0.75 of the total', () => {
+        // All other serve-relevant stats at 1: awareness=1, focus=1, attack=1
+        // score ≈ 99*0.75 + 1*0.1 + 1*0.1 + 1*0.05 = 74.25 + 0.25 = 74.5 → 74
         const stats = makeStats(1, { serve: 99 });
-        (0, globals_1.expect)((0, stats_1.calculateStatScore)(stats, stats_1.StatsEnum.SERVE)).toBe(84);
+        (0, globals_1.expect)((0, stats_1.calculateStatScore)(stats, stats_1.StatsEnum.SERVE)).toBe(74);
     });
 });
 // ─── invariants (every stat, every branch) ────────────────────────────────────

package/dist/cjs/src/service/premium/index.d.ts

@@ -0,0 +1,3 @@
+export * from './premium-tier';
+export * from './premium-grant';
+export * from './patreon-tier-map';

package/dist/cjs/src/service/premium/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./premium-tier"), exports);
+__exportStar(require("./premium-grant"), exports);
+__exportStar(require("./patreon-tier-map"), exports);

package/dist/cjs/src/service/premium/patreon-tier-map.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare const PATREON_TIER_MAP_KEY = "patreon_tier_map";
+export type PatreonTierMap = Record<string, number>;
+export declare const patreonTierMapSchema: z.ZodType<PatreonTierMap>;
+export declare function resolvePremiumTier(entitledTierIds: string[], map: PatreonTierMap): number;

package/dist/cjs/src/service/premium/patreon-tier-map.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.patreonTierMapSchema = exports.PATREON_TIER_MAP_KEY = void 0;
+exports.resolvePremiumTier = resolvePremiumTier;
+const zod_1 = require("zod");
+const premium_tier_1 = require("./premium-tier");
+// Admin-configured mapping from a Patreon TIER id (string, opaque, per-campaign) to one of our numeric premium tiers.
+// The whole map is stored as a single AppConfig JSONB row under PATREON_TIER_MAP_KEY (the DB read/write lives in the
+// API; this module is pure so it can be shared and unit-tested). The Patreon webhook resolves a member's currently
+// entitled tier ids through this map to decide the premium tier to grant. See plans/premium-users.md section 5.
+exports.PATREON_TIER_MAP_KEY = 'patreon_tier_map';
+// A valid map assigns each Patreon tier id to an existing premium tier (1..MAX_PREMIUM_TIER). An empty map is valid
+// (nothing mapped yet). Unknown/extra Patreon tier ids are simply absent and resolve to NO_PREMIUM.
+exports.patreonTierMapSchema = zod_1.z.record(zod_1.z.string(), zod_1.z.number().int().min(1).max(premium_tier_1.MAX_PREMIUM_TIER));
+// The highest premium tier the given currently-entitled Patreon tier ids map to, else NO_PREMIUM (0). Ids not present
+// in the map (unmapped or deleted tiers) contribute nothing. This is the single source of truth for "Patreon -> tier".
+function resolvePremiumTier(entitledTierIds, map) {
+    return entitledTierIds.reduce((max, id) => {
+        const tier = map[id];
+        return tier != null && tier > max ? tier : max;
+    }, premium_tier_1.NO_PREMIUM);
+}

package/dist/cjs/src/service/premium/patreon-tier-map.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/src/service/premium/patreon-tier-map.test.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const premium_tier_1 = require("./premium-tier");
+const patreon_tier_map_1 = require("./patreon-tier-map");
+// A sample admin mapping: two Patreon tier ids -> premium tiers 1 and 2.
+const MAP = { tier_cosmetic: 1, tier_national: 2 };
+// ─── resolvePremiumTier ──────────────────────────────────────────────────────────
+(0, globals_1.describe)('resolvePremiumTier()', () => {
+    (0, globals_1.it)('is NO_PREMIUM (0) when the entitled list is empty', () => {
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)([], MAP)).toBe(premium_tier_1.NO_PREMIUM);
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)([], MAP)).toBe(0);
+    });
+    (0, globals_1.it)('resolves a single mapped tier id to its premium tier', () => {
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)(['tier_cosmetic'], MAP)).toBe(1);
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)(['tier_national'], MAP)).toBe(2);
+    });
+    (0, globals_1.it)('returns the highest premium tier when several entitled ids map', () => {
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)(['tier_cosmetic', 'tier_national'], MAP)).toBe(2);
+    });
+    (0, globals_1.it)('ignores unmapped ids (unknown or deleted Patreon tiers) and falls back to a mapped one', () => {
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)(['tier_deleted', 'tier_cosmetic'], MAP)).toBe(1);
+    });
+    (0, globals_1.it)('is NO_PREMIUM when NO entitled id is in the map', () => {
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)(['tier_deleted', 'tier_unknown'], MAP)).toBe(premium_tier_1.NO_PREMIUM);
+    });
+    (0, globals_1.it)('is NO_PREMIUM against an empty map', () => {
+        (0, globals_1.expect)((0, patreon_tier_map_1.resolvePremiumTier)(['tier_cosmetic'], {})).toBe(premium_tier_1.NO_PREMIUM);
+    });
+});
+// ─── patreonTierMapSchema ──────────────────────────────────────────────────────────
+(0, globals_1.describe)('patreonTierMapSchema', () => {
+    (0, globals_1.it)('accepts an empty map', () => {
+        (0, globals_1.expect)(patreon_tier_map_1.patreonTierMapSchema.parse({})).toEqual({});
+    });
+    (0, globals_1.it)('accepts a map of valid premium tiers', () => {
+        (0, globals_1.expect)(patreon_tier_map_1.patreonTierMapSchema.parse(MAP)).toEqual(MAP);
+    });
+    (0, globals_1.it)('rejects a tier value below 1', () => {
+        (0, globals_1.expect)(() => patreon_tier_map_1.patreonTierMapSchema.parse({ t: 0 })).toThrow();
+    });
+    (0, globals_1.it)('rejects a tier value above MAX_PREMIUM_TIER', () => {
+        (0, globals_1.expect)(() => patreon_tier_map_1.patreonTierMapSchema.parse({ t: premium_tier_1.MAX_PREMIUM_TIER + 1 })).toThrow();
+    });
+    (0, globals_1.it)('rejects a non-integer tier value', () => {
+        (0, globals_1.expect)(() => patreon_tier_map_1.patreonTierMapSchema.parse({ t: 1.5 })).toThrow();
+    });
+});

package/dist/cjs/src/service/premium/premium-grant.d.ts

@@ -0,0 +1,17 @@
+export type PremiumGrantSource = 'ADMIN' | 'PATREON';
+export interface PremiumGrant {
+    grantId: string;
+    userId: string;
+    tier: number;
+    source: PremiumGrantSource;
+    grantedBy?: string | null;
+    grantedAt: Date;
+    expiresAt?: Date | null;
+    revokedAt?: Date | null;
+    patreonMemberId?: string | null;
+    note?: string | null;
+}
+type ActiveFields = Pick<PremiumGrant, 'revokedAt' | 'expiresAt'>;
+export declare function isGrantActive(g: ActiveFields, now?: Date): boolean;
+export declare function effectiveTier(grants: Array<Pick<PremiumGrant, 'tier' | 'revokedAt' | 'expiresAt'>>, now?: Date): number;
+export {};

package/dist/cjs/src/service/premium/premium-grant.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isGrantActive = isGrantActive;
+exports.effectiveTier = effectiveTier;
+const premium_tier_1 = require("./premium-tier");
+// A grant is ACTIVE when it is not revoked and not past its expiry (a null expiry = permanent).
+function isGrantActive(g, now = new Date()) {
+    if (g.revokedAt != null)
+        return false;
+    return g.expiresAt == null || g.expiresAt.getTime() > now.getTime();
+}
+// The user's EFFECTIVE tier: the highest tier among their ACTIVE grants, or NO_PREMIUM (0) when none is active.
+function effectiveTier(grants, now = new Date()) {
+    return grants.reduce((max, g) => (isGrantActive(g, now) && g.tier > max ? g.tier : max), premium_tier_1.NO_PREMIUM);
+}

package/dist/cjs/src/service/premium/premium-tier.d.ts

@@ -0,0 +1,10 @@
+export declare const NO_PREMIUM = 0;
+export interface PremiumTierDef {
+    tier: number;
+    key: string;
+    name: string;
+}
+export declare const PREMIUM_TIERS: PremiumTierDef[];
+export declare const MAX_PREMIUM_TIER: number;
+export declare function premiumTierDef(tier: number): PremiumTierDef | undefined;
+export declare function hasTier(effectiveTier: number, required: number): boolean;

package/dist/cjs/src/service/premium/premium-tier.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_PREMIUM_TIER = exports.PREMIUM_TIERS = exports.NO_PREMIUM = void 0;
+exports.premiumTierDef = premiumTierDef;
+exports.hasTier = hasTier;
+// Hierarchical premium tiers (owner 2026-08-17): tier N grants everything below it, so a feature gate is just
+// `effectiveTier >= required`. Tiers are NUMERIC and code-defined here (the DB stores only the number), so adding a
+// tier needs no migration. Names/keys are display + gating helpers. Keep PREMIUM_TIERS ascending by tier. See
+// plans/premium-users.md.
+exports.NO_PREMIUM = 0;
+// The known tiers. Extend this list to add a tier (no schema change). tier -> what it unlocks is enforced by the
+// feature gates, not stored; these names are for the admin view / display only.
+exports.PREMIUM_TIERS = [
+    { tier: 1, key: 'COSMETIC', name: 'Cosmetic Customization' },
+    { tier: 2, key: 'NATIONAL', name: 'World Cup + National Teams' }
+];
+exports.MAX_PREMIUM_TIER = exports.PREMIUM_TIERS.reduce((m, t) => Math.max(m, t.tier), exports.NO_PREMIUM);
+function premiumTierDef(tier) {
+    return exports.PREMIUM_TIERS.find((t) => t.tier === tier);
+}
+// A user with `effectiveTier` meets a feature's `required` tier when it is at least as high (hierarchical).
+function hasTier(effectiveTier, required) {
+    return effectiveTier >= required;
+}

package/dist/cjs/src/service/premium/premium.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/src/service/premium/premium.test.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const premium_tier_1 = require("./premium-tier");
+const premium_grant_1 = require("./premium-grant");
+// ─── fixed clock ───────────────────────────────────────────────────────────────
+// All time-dependent assertions pass an explicit `now` so they never depend on the wall clock.
+const NOW = new Date('2026-08-17T12:00:00.000Z');
+const PAST = new Date('2026-08-01T00:00:00.000Z');
+const FUTURE = new Date('2026-09-01T00:00:00.000Z');
+function grant(tier, opts = {}) {
+    return { tier, expiresAt: opts.expiresAt ?? null, revokedAt: opts.revokedAt ?? null };
+}
+// ─── isGrantActive ───────────────────────────────────────────────────────────────
+(0, globals_1.describe)('isGrantActive()', () => {
+    (0, globals_1.it)('is active when not revoked and has no expiry (permanent comp)', () => {
+        (0, globals_1.expect)((0, premium_grant_1.isGrantActive)(grant(1), NOW)).toBe(true);
+    });
+    (0, globals_1.it)('is active when the expiry is in the future', () => {
+        (0, globals_1.expect)((0, premium_grant_1.isGrantActive)(grant(1, { expiresAt: FUTURE }), NOW)).toBe(true);
+    });
+    (0, globals_1.it)('is inactive when the expiry is in the past', () => {
+        (0, globals_1.expect)((0, premium_grant_1.isGrantActive)(grant(1, { expiresAt: PAST }), NOW)).toBe(false);
+    });
+    (0, globals_1.it)('is inactive at the exact expiry instant (expiry is exclusive)', () => {
+        (0, globals_1.expect)((0, premium_grant_1.isGrantActive)(grant(1, { expiresAt: NOW }), NOW)).toBe(false);
+    });
+    (0, globals_1.it)('is inactive when revoked, even with a future expiry', () => {
+        (0, globals_1.expect)((0, premium_grant_1.isGrantActive)(grant(1, { expiresAt: FUTURE, revokedAt: PAST }), NOW)).toBe(false);
+    });
+});
+// ─── effectiveTier ───────────────────────────────────────────────────────────────
+(0, globals_1.describe)('effectiveTier()', () => {
+    (0, globals_1.it)('is NO_PREMIUM (0) for an empty grant list', () => {
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([], NOW)).toBe(premium_tier_1.NO_PREMIUM);
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([], NOW)).toBe(0);
+    });
+    (0, globals_1.it)('returns the tier of a single active grant', () => {
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([grant(2)], NOW)).toBe(2);
+    });
+    (0, globals_1.it)('returns the highest tier among several active grants', () => {
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([grant(1), grant(2), grant(1, { expiresAt: FUTURE })], NOW)).toBe(2);
+    });
+    (0, globals_1.it)('keeps a permanent lower-tier floor beneath an expired higher-tier grant', () => {
+        // Tier 2 expired, tier 1 permanent still active -> effective 1.
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([grant(2, { expiresAt: PAST }), grant(1)], NOW)).toBe(1);
+    });
+    (0, globals_1.it)('ignores a revoked higher-tier grant and falls back to a lower active one', () => {
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([grant(2, { revokedAt: PAST }), grant(1)], NOW)).toBe(1);
+    });
+    (0, globals_1.it)('is NO_PREMIUM when every grant is expired or revoked', () => {
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)([grant(2, { expiresAt: PAST }), grant(1, { revokedAt: PAST })], NOW)).toBe(premium_tier_1.NO_PREMIUM);
+    });
+    (0, globals_1.it)('order of grants does not change the result', () => {
+        const grants = [grant(1), grant(2, { expiresAt: FUTURE }), grant(1, { revokedAt: PAST })];
+        const reversed = [...grants].reverse();
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)(grants, NOW)).toBe((0, premium_grant_1.effectiveTier)(reversed, NOW));
+        (0, globals_1.expect)((0, premium_grant_1.effectiveTier)(reversed, NOW)).toBe(2);
+    });
+});
+// ─── hasTier ─────────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('hasTier()', () => {
+    (0, globals_1.it)('is true when the effective tier exceeds the requirement (hierarchical)', () => {
+        (0, globals_1.expect)((0, premium_tier_1.hasTier)(2, 1)).toBe(true);
+    });
+    (0, globals_1.it)('is true when the effective tier equals the requirement', () => {
+        (0, globals_1.expect)((0, premium_tier_1.hasTier)(2, 2)).toBe(true);
+    });
+    (0, globals_1.it)('is false when the effective tier is below the requirement', () => {
+        (0, globals_1.expect)((0, premium_tier_1.hasTier)(1, 2)).toBe(false);
+    });
+    (0, globals_1.it)('a non-premium user (0) meets no positive requirement', () => {
+        (0, globals_1.expect)((0, premium_tier_1.hasTier)(premium_tier_1.NO_PREMIUM, 1)).toBe(false);
+    });
+});
+// ─── tier catalog ────────────────────────────────────────────────────────────────
+(0, globals_1.describe)('PREMIUM_TIERS catalog', () => {
+    (0, globals_1.it)('MAX_PREMIUM_TIER is the highest configured tier', () => {
+        (0, globals_1.expect)(premium_tier_1.MAX_PREMIUM_TIER).toBe(2);
+    });
+    (0, globals_1.it)('is ascending by tier', () => {
+        const tiers = premium_tier_1.PREMIUM_TIERS.map((t) => t.tier);
+        (0, globals_1.expect)(tiers).toEqual([...tiers].sort((a, b) => a - b));
+    });
+    (0, globals_1.it)('premiumTierDef resolves a known tier to its definition', () => {
+        (0, globals_1.expect)((0, premium_tier_1.premiumTierDef)(1)?.key).toBe('COSMETIC');
+        (0, globals_1.expect)((0, premium_tier_1.premiumTierDef)(2)?.key).toBe('NATIONAL');
+    });
+    (0, globals_1.it)('premiumTierDef is undefined for an unknown tier', () => {
+        (0, globals_1.expect)((0, premium_tier_1.premiumTierDef)(0)).toBeUndefined();
+        (0, globals_1.expect)((0, premium_tier_1.premiumTierDef)(premium_tier_1.MAX_PREMIUM_TIER + 1)).toBeUndefined();
+    });
+});

package/dist/cjs/src/service/team/index.d.ts

@@ -1,4 +1,5 @@
 export * from './team';
+export * from './jersey';
 export * from './team-generator';
 export * from './formation';
 export * from './tactics';

package/dist/cjs/src/service/team/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./team"), exports);
+__exportStar(require("./jersey"), exports);
 __exportStar(require("./team-generator"), exports);
 __exportStar(require("./formation"), exports);
 __exportStar(require("./tactics"), exports);

package/dist/cjs/src/service/team/jersey.d.ts

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+export declare const JerseySchema: z.ZodObject<{
+    clothing: z.ZodEnum<{
+        shirtCrewNeck: "shirtCrewNeck";
+        shirtCrewNeckSleeveless: "shirtCrewNeckSleeveless";
+        shirtVNeck: "shirtVNeck";
+        shirtVNeckSleeveless: "shirtVNeckSleeveless";
+        collarAndSweater: "collarAndSweater";
+        collarAndSweaterSleeveless: "collarAndSweaterSleeveless";
+    }>;
+    pattern: z.ZodEnum<{
+        solid: "solid";
+        verticalStripes: "verticalStripes";
+        verticalBars: "verticalBars";
+        pinstripes: "pinstripes";
+        hoops: "hoops";
+        checkered: "checkered";
+        diagonalSash: "diagonalSash";
+        splitHalves: "splitHalves";
+        chevron: "chevron";
+        shoulderYoke: "shoulderYoke";
+        sidePanels: "sidePanels";
+        centerBand: "centerBand";
+        gradientFade: "gradientFade";
+        twoToneSplit: "twoToneSplit";
+    }>;
+    colors: z.ZodArray<z.ZodString>;
+    font: z.ZodEnum<{
+        block: "block";
+        sans: "sans";
+        wide: "wide";
+        mono: "mono";
+        serif: "serif";
+        permanentMarker: "permanentMarker";
+        kaushanScript: "kaushanScript";
+        russoOne: "russoOne";
+        teko: "teko";
+        saira: "saira";
+        michroma: "michroma";
+        zillaSlab: "zillaSlab";
+        changaOne: "changaOne";
+        stardosStencil: "stardosStencil";
+        wallpoet: "wallpoet";
+        orbitron: "orbitron";
+        tourney: "tourney";
+        bebasNeue: "bebasNeue";
+        anton: "anton";
+        jersey25: "jersey25";
+    }>;
+    numberColor: z.ZodString;
+    numberOutline: z.ZodString;
+    numberOutlineEnabled: z.ZodDefault<z.ZodBoolean>;
+    numberSpacing: z.ZodDefault<z.ZodNumber>;
+    numberSize: z.ZodDefault<z.ZodNumber>;
+    brand: z.ZodDefault<z.ZodEnum<{
+        none: "none";
+        sigma: "sigma";
+        "person-soccer": "person-soccer";
+        "feather-pointed": "feather-pointed";
+        "paw-claws": "paw-claws";
+        narwhal: "narwhal";
+        horseshoe: "horseshoe";
+        "spider-black-widow": "spider-black-widow";
+        "wreath-laurel": "wreath-laurel";
+        omega: "omega";
+        trillium: "trillium";
+    }>>;
+    brandColor1: z.ZodDefault<z.ZodString>;
+    brandColor2: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type JerseyConfig = z.infer<typeof JerseySchema>;
+export type JerseyClothing = JerseyConfig['clothing'];
+export type JerseyPattern = JerseyConfig['pattern'];
+export type JerseyFont = JerseyConfig['font'];

package/dist/cjs/src/service/team/jersey.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JerseySchema = void 0;
+const zod_1 = require("zod");
+// 6-digit hex (#rrggbb) or 8-digit hex with alpha (#rrggbbaa). The 8-digit form comes from the UI's opacity-enabled
+// colour pickers; SVG fills render both natively.
+const hexColor = zod_1.z.string().regex(/^#[0-9a-fA-F]{6}([0-9a-fA-F]{2})?$/, 'INVALID_HEX_COLOR');
+// The full description of a team's kit: shirt shape, pattern, up to 3 colours, and the chest-number styling.
+// Produced by the Jersey Editor (premium users) and by the id-derived default; stored on the Team and rendered by
+// the UI Picture. The SVG render helpers + option tables live in the UI (view/jersey/jersey-render); only this
+// shape + its validation are shared here so the DB column, the API DTO, and the UI agree on one definition.
+exports.JerseySchema = zod_1.z.object({
+    clothing: zod_1.z.enum(['shirtCrewNeck', 'shirtCrewNeckSleeveless', 'shirtVNeck', 'shirtVNeckSleeveless', 'collarAndSweater', 'collarAndSweaterSleeveless']),
+    pattern: zod_1.z.enum(['solid', 'verticalStripes', 'verticalBars', 'pinstripes', 'hoops', 'checkered', 'diagonalSash', 'splitHalves', 'chevron', 'shoulderYoke', 'sidePanels', 'centerBand', 'gradientFade', 'twoToneSplit']),
+    colors: zod_1.z.array(hexColor).min(1).max(3),
+    font: zod_1.z.enum(['sans', 'wide', 'mono', 'serif', 'block', 'permanentMarker', 'kaushanScript', 'russoOne', 'teko', 'saira', 'michroma', 'zillaSlab', 'changaOne', 'stardosStencil', 'wallpoet', 'orbitron', 'tourney', 'bebasNeue', 'anton', 'jersey25']),
+    numberColor: hexColor,
+    numberOutline: hexColor,
+    // Whether the number's thin contrasting outline is drawn. Off = no stroke. Optional/defaulted (true = keep the
+    // previous always-on behaviour) so configs saved before it stay valid.
+    numberOutlineEnabled: zod_1.z.boolean().default(true),
+    // Extra spacing (in the size-46 chest-number's own units) between the two digits, +/- to taste per font. A
+    // single-digit number ignores it and stays centred. Optional/defaulted so configs saved before it stay valid.
+    numberSpacing: zod_1.z.number().min(-40).max(80).default(0),
+    // Chest number height in avatar-svg units (the number sits on a ~412-tall canvas). The editor slider caps it to a
+    // readable range; defaulted (46 = the previous fixed size) so configs saved before it stay valid.
+    numberSize: zod_1.z.number().min(20).max(80).default(46),
+    // Chest brand (premium): a duotone icon on the left chest (or 'none') plus its two colours. Optional/defaulted so
+    // configs saved before it stay valid.
+    brand: zod_1.z.enum(['none', 'sigma', 'person-soccer', 'feather-pointed', 'paw-claws', 'narwhal', 'horseshoe', 'spider-black-widow', 'wreath-laurel', 'omega', 'trillium']).default('none'),
+    brandColor1: hexColor.default('#ffffff'),
+    brandColor2: hexColor.default('#1e293b')
+});

package/dist/cjs/src/service/team/schemas/team.z.d.ts

@@ -345,5 +345,74 @@ export declare const TeamInputSchema: z.ZodObject<{
             inMatchDesignate: z.ZodOptional<z.ZodCustom<Player, Player>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
+    jerseyConfig: z.ZodOptional<z.ZodObject<{
+        clothing: z.ZodEnum<{
+            shirtCrewNeck: "shirtCrewNeck";
+            shirtCrewNeckSleeveless: "shirtCrewNeckSleeveless";
+            shirtVNeck: "shirtVNeck";
+            shirtVNeckSleeveless: "shirtVNeckSleeveless";
+            collarAndSweater: "collarAndSweater";
+            collarAndSweaterSleeveless: "collarAndSweaterSleeveless";
+        }>;
+        pattern: z.ZodEnum<{
+            solid: "solid";
+            verticalStripes: "verticalStripes";
+            verticalBars: "verticalBars";
+            pinstripes: "pinstripes";
+            hoops: "hoops";
+            checkered: "checkered";
+            diagonalSash: "diagonalSash";
+            splitHalves: "splitHalves";
+            chevron: "chevron";
+            shoulderYoke: "shoulderYoke";
+            sidePanels: "sidePanels";
+            centerBand: "centerBand";
+            gradientFade: "gradientFade";
+            twoToneSplit: "twoToneSplit";
+        }>;
+        colors: z.ZodArray<z.ZodString>;
+        font: z.ZodEnum<{
+            block: "block";
+            sans: "sans";
+            wide: "wide";
+            mono: "mono";
+            serif: "serif";
+            permanentMarker: "permanentMarker";
+            kaushanScript: "kaushanScript";
+            russoOne: "russoOne";
+            teko: "teko";
+            saira: "saira";
+            michroma: "michroma";
+            zillaSlab: "zillaSlab";
+            changaOne: "changaOne";
+            stardosStencil: "stardosStencil";
+            wallpoet: "wallpoet";
+            orbitron: "orbitron";
+            tourney: "tourney";
+            bebasNeue: "bebasNeue";
+            anton: "anton";
+            jersey25: "jersey25";
+        }>;
+        numberColor: z.ZodString;
+        numberOutline: z.ZodString;
+        numberOutlineEnabled: z.ZodDefault<z.ZodBoolean>;
+        numberSpacing: z.ZodDefault<z.ZodNumber>;
+        numberSize: z.ZodDefault<z.ZodNumber>;
+        brand: z.ZodDefault<z.ZodEnum<{
+            none: "none";
+            sigma: "sigma";
+            "person-soccer": "person-soccer";
+            "feather-pointed": "feather-pointed";
+            "paw-claws": "paw-claws";
+            narwhal: "narwhal";
+            horseshoe: "horseshoe";
+            "spider-black-widow": "spider-black-widow";
+            "wreath-laurel": "wreath-laurel";
+            omega: "omega";
+            trillium: "trillium";
+        }>>;
+        brandColor1: z.ZodDefault<z.ZodString>;
+        brandColor2: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type TeamInput = z.infer<typeof TeamInputSchema>;

package/dist/cjs/src/service/team/schemas/team.z.js

@@ -5,6 +5,7 @@ const zod_1 = require("zod");
 const player_1 = require("../../player");
 const country_1 = require("../../country");
 const tactics_z_1 = require("./tactics.z");
+const jersey_1 = require("../jersey");
 const playerInstanceSchema = zod_1.z.custom((v) => v instanceof player_1.Player, {
     message: 'INVALID_PLAYER_INSTANCE'
 });
@@ -20,7 +21,8 @@ exports.TeamInputSchema = zod_1.z.object({
     roster: zod_1.z.array(playerInstanceSchema),
     country: countrySchema,
     legacyFlagCountry: countrySchema.optional(),
-    tactics: tactics_z_1.TacticsInputSchema.optional()
+    tactics: tactics_z_1.TacticsInputSchema.optional(),
+    jerseyConfig: jersey_1.JerseySchema.optional()
 }).superRefine((data, ctx) => {
     const ids = data.roster.map(p => p.id);
     if (new Set(ids).size !== ids.length) {

package/dist/cjs/src/service/team/team.d.ts

@@ -1,6 +1,7 @@
 import { Player } from '../player';
 import { Country } from '../country';
 import { Tactics } from './tactics';
+import type { JerseyConfig } from './jersey';
 export declare class Team {
     readonly id: string;
     readonly roster: Player[];
@@ -10,6 +11,7 @@ export declare class Team {
     readonly tactics?: Tactics;
     readonly country: Country;
     readonly legacyFlagCountry?: Country;
+    readonly jerseyConfig?: JerseyConfig;
     private _rating;
     static create(input: unknown): Team;
     private constructor();

package/dist/cjs/src/service/team/team.js

@@ -19,7 +19,7 @@ class Team {
             tactics: result.data.tactics != null ? tactics_1.Tactics.create(result.data.tactics) : undefined
         });
     }
-    constructor({ id, rating, name, shortName, divisionId, country, legacyFlagCountry, roster, tactics }) {
+    constructor({ id, rating, name, shortName, divisionId, country, legacyFlagCountry, roster, tactics, jerseyConfig }) {
         this.id = id;
         this._rating = rating;
         this.roster = roster;
@@ -29,6 +29,7 @@ class Team {
         this.divisionId = divisionId;
         this.country = country;
         this.legacyFlagCountry = legacyFlagCountry;
+        this.jerseyConfig = jerseyConfig;
     }
     get rating() {
         return this._rating;