@weekendgoals/weekendgoals-common 1.1908.22254273988 → 1.1909.22283215374

package/dist/matching/normalize.d.ts

@@ -0,0 +1,24 @@
+import { Category } from "@weekendgoals/weekendgoals-types/dist/types";
+export declare function normalize(name: string): string;
+/**
+ * Normalize a country name, resolving known aliases to DB canonical names.
+ */
+export declare function normalizeCountry(country: string): string;
+/**
+ * Resolve a team name + country to the DB canonical form.
+ * Returns null if no alias exists.
+ */
+export declare function resolveTeamAlias(normName: string, normCountry: string): {
+    name: string;
+    country: string;
+} | null;
+export declare function inferCategory(leagueName: string): Category;
+/**
+ * Resolve a league name + country to the DB canonical form.
+ * Returns null if no alias exists.
+ */
+export declare function resolveLeagueAlias(normName: string, normCountry: string): {
+    name: string;
+    country: string;
+} | null;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/matching/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/matching/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS9C;AAkCD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AA6DD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK1C;AAYD,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,CAI1D;AA8DD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK1C"}

package/dist/matching/normalize.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalize = normalize;
+exports.normalizeCountry = normalizeCountry;
+exports.resolveTeamAlias = resolveTeamAlias;
+exports.inferCategory = inferCategory;
+exports.resolveLeagueAlias = resolveLeagueAlias;
+function normalize(name) {
+    return name
+        .normalize("NFD") // decompose accents: "ä" → "a" + combining diaeresis
+        .replace(/[\u0300-\u036f]/g, "") // strip combining diacritical marks
+        .toLowerCase()
+        .replace(/[-_]/g, " ")
+        .replace(/[^a-z0-9 ]/g, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/**
+ * Maps alternative country names to the canonical name used in our DB.
+ * Keys are normalized (lowercase, stripped of special chars).
+ * Both Opta and FIFA use slightly different names than API-Football.
+ */
+const COUNTRY_ALIASES = {
+    // Opta uses "Türkiye" → NFD normalize → "turkiye"
+    "turkiye": "turkey",
+    // Opta/FIFA vs our DB
+    "czechia": "czech republic",
+    "china pr": "china",
+    "korea republic": "south korea",
+    "korea dpr": "north korea",
+    "republic of ireland": "ireland",
+    // "Côte d'Ivoire" → NFD → "cote divoire"
+    "cote divoire": "ivory coast",
+    "bosnia and herzegovina": "bosnia",
+    "cabo verde": "cape verde islands",
+    "brunei darussalam": "brunei",
+    // "São Tomé e Príncipe" / "São Tomé and Príncipe" → NFD → "sao tome..."
+    "sao tome e principe": "sao tome e principe",
+    "sao tome and principe": "sao tome e principe",
+    // "Réunion" → NFD → "reunion"
+    "reunion": "reunion",
+    // "Curaçao" → NFD → "curacao"
+    "curacao": "curacao",
+    // FIFA-specific aliases
+    "ir iran": "iran",
+    "korea": "south korea",
+};
+/**
+ * Normalize a country name, resolving known aliases to DB canonical names.
+ */
+function normalizeCountry(country) {
+    const norm = normalize(country);
+    return COUNTRY_ALIASES[norm] || norm;
+}
+/**
+ * Maps Opta/FIFA team names to our DB names when they differ significantly.
+ * Key: "normalizedOptaName::normalizedCountry"
+ * Value: "normalizedDbName::normalizedDbCountry"
+ */
+const TEAM_ALIASES = {
+    // Short names / nicknames
+    "wolverhampton wanderers::england": "wolves::england",
+    "agf::denmark": "aarhus::denmark",
+    "ob::denmark": "odense::denmark",
+    "az::netherlands": "az alkmaar::netherlands",
+    "la galaxy::usa": "los angeles galaxy::usa",
+    "sj earthquakes::usa": "san jose earthquakes::usa",
+    "lsk::norway": "lillestrom::norway",
+    // Different naming conventions
+    "queens park rangers::england": "qpr::england",
+    "stgallen::switzerland": "fc st gallen::switzerland",
+    "dac 1904::slovakia": "dunajska streda::slovakia",
+    "rsb berkane::morocco": "renaissance berkane::morocco",
+    "wydad casablanca::morocco": "wydad ac::morocco",
+    "al qadsiah::saudi arabia": "al qadisiyah fc::saudi arabia",
+    "gaziantep fk::turkey": "gazisehir gaziantep::turkey",
+    "universidad catolica::chile": "u catolica::chile",
+    "aguilas doradas::colombia": "rionegro aguilas::colombia",
+    "neftci::azerbaijan": "neftchi baku::azerbaijan",
+    "ulsan hd::south korea": "ulsan hyundai fc::south korea",
+    "hapoel jerusalem::israel": "hapoel katamon::israel",
+    // Country mismatch — Derry City plays in Ireland's league but is in Northern Ireland
+    "derry city::northern ireland": "derry city::ireland",
+    // Opta uses different names for Lyon teams
+    "olympique lyonnais::france": "lyon::france",
+    "ol lyonnes::france": "lyon w::france",
+    // Opta full names vs DB short names
+    "internazionale::italy": "inter::italy",
+    "brest::france": "stade brestois 29::france",
+    "kbenhavn::denmark": "fc copenhagen::denmark",
+    "west bromwich albion::england": "west brom::england",
+    // Opta name differs from DB name (men)
+    "slaven koprivnica::croatia": "nk slaven belupo::croatia",
+    "wsg tirol::austria": "wsg wattens::austria",
+    "torpedo belaz::belarus": "torpedo zhodino::belarus",
+    "blau wei linz::austria": "fc bw linz::austria",
+    "wehen wiesbaden::germany": "sv wehen::germany",
+    "etoile du sahel::tunisia": "es sahel::tunisia",
+    "monastir::tunisia": "us monastirienne::tunisia",
+    "porto ii::portugal": "fc porto b::portugal",
+    "city torque::uruguay": "atletico torque::uruguay",
+    "atletico huila::colombia": "huila::colombia",
+    "nacional::uruguay": "club nacional::uruguay",
+    "renaissance zemamra::morocco": "cr khemis zemamra::morocco",
+    "erzurumspor fk::turkey": "erzurum bb::turkey",
+};
+/**
+ * Resolve a team name + country to the DB canonical form.
+ * Returns null if no alias exists.
+ */
+function resolveTeamAlias(normName, normCountry) {
+    const alias = TEAM_ALIASES[`${normName}::${normCountry}`];
+    if (!alias)
+        return null;
+    const sep = alias.indexOf("::");
+    return { name: alias.substring(0, sep), country: alias.substring(sep + 2) };
+}
+/**
+ * Infer team/league category from a league name.
+ * Uses the same patterns as update-league-ranks.ts.
+ */
+const WOMEN_PATTERN = /\bwomen'?s?\b|\bfemenina?\b|\bfemenil\b|\bfrauen|\bf[ée]minin|\bWSL\b|\bLiga F\b|\bkvinde|\bSWPL\b|\bSWF\b|\bWPSL\b|\bNWSL\b|\bWK[- ]?League\b|\bWE League\b|\bElitettan\b|\bUSL W\b|\bToppserien\b|\bKansallinen Liiga\b|\bDamallsvenskan\b|\bNorthern Super League\b/i;
+const YOUTH_PATTERN = /\bprimavera\b|\bU\d{2}\b|\bunder[- ]?\d{2}\b|\byouth\b|\bjunior(?:en)?\b|\bPremier League 2\b|\bPremier League Cup\b|\bProfessional Development League\b/i;
+function inferCategory(leagueName) {
+    if (WOMEN_PATTERN.test(leagueName))
+        return "women";
+    if (YOUTH_PATTERN.test(leagueName))
+        return "youth";
+    return "men";
+}
+/**
+ * Maps Opta league names to our DB names when they differ (sponsor names, abbreviations).
+ * Key: "normalizedOptaName::normalizedCountry"
+ * Value: "normalizedDbName::normalizedDbCountry"
+ */
+const LEAGUE_ALIASES = {
+    // Sponsor / commercial names vs generic names
+    "first division a::belgium": "jupiler pro league::belgium",
+    "primera division::spain": "la liga::spain",
+    "mls::usa": "major league soccer::usa",
+    "mls::canada": "major league soccer::usa",
+    "saudi league::saudi arabia": "pro league::saudi arabia",
+    "nike liga::slovakia": "super liga::slovakia",
+    "psl::south africa": "premier soccer league::south africa",
+    "lpf::panama": "liga panamena de futbol::panama",
+    "besta deild::iceland": "urvalsdeild::iceland",
+    "liga 1::peru": "primera division::peru",
+    "super league::indonesia": "liga 1::indonesia",
+    // Opta league-meta.json uses country-prefixed or localized names
+    // — aliases also prevent partial-match conflicts where multiple Opta leagues
+    //   would substring-match the same DB league (e.g. "Bundesliga" vs "Bundesliga Zwei")
+    "german bundesliga zwei::germany": "2 bundesliga::germany",
+    "english national league::england": "national league::england",
+    "spanish segunda division::spain": "segunda division::spain",
+    "austrian frauenliga::austria": "frauenliga::austria",
+    // Men's
+    "croatia prva hnl::croatia": "hnl::croatia",
+    "czech first league::czech republic": "czech liga::czech republic",
+    "cypriot division 1::cyprus": "1 division::cyprus",
+    "saudi arabian league::saudi arabia": "pro league::saudi arabia",
+    "chile primera::chile": "primera division::chile",
+    "slovenia prvaliga::slovenia": "1 snl::slovenia",
+    "azerbaijan premier league::azerbaijan": "premyer liqa::azerbaijan",
+    "slovakia 1 liga::slovakia": "super liga::slovakia",
+    "south africa psl::south africa": "premier soccer league::south africa",
+    "german 3rd liga::germany": "3 liga::germany",
+    "albanian kategoria superiore::albania": "superliga::albania",
+    "irish premier league::ireland": "premier division::ireland",
+    "nigerian premier league::nigeria": "npfl::nigeria",
+    "norwegian 1 divisjon::norway": "1 division::norway",
+    "icelandic besta deild::iceland": "urvalsdeild::iceland",
+    "georgian premier league::georgia": "erovnuli liga::georgia",
+    "maltese league::malta": "premier league::malta",
+    // Women's
+    "english womens super league::england": "fa wsl::england",
+    "national womens soccer league::usa": "nwsl women::usa",
+    "german womens bundesliga::germany": "frauen bundesliga::germany",
+    "french feminine premiere ligue::france": "feminine division 1::france",
+    "english wsl 2::england": "womens championship::england",
+    "brasileiro feminino a1::brazil": "brasileiro women::brazil",
+    "spanish primera federacion femenina::spain": "primera division femenina::spain",
+    "2 bundesliga women::germany": "2 frauen bundesliga::germany",
+    "icelandic besta deild women::iceland": "urvalsdeild women::iceland",
+    "russian superliga women::russia": "supreme division women::russia",
+    "nadeshiko league 1::japan": "we league::japan",
+};
+/**
+ * Resolve a league name + country to the DB canonical form.
+ * Returns null if no alias exists.
+ */
+function resolveLeagueAlias(normName, normCountry) {
+    const alias = LEAGUE_ALIASES[`${normName}::${normCountry}`];
+    if (!alias)
+        return null;
+    const sep = alias.indexOf("::");
+    return { name: alias.substring(0, sep), country: alias.substring(sep + 2) };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/matching/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/matching/normalize.ts"],"names":[],"mappings":"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"}

package/dist/matching/team-matcher.d.ts

@@ -0,0 +1,21 @@
+export interface MatchCandidate {
+    name: string;
+    alternateNames?: string[];
+}
+export interface MatchResult<T extends MatchCandidate> {
+    item: T;
+    score: number;
+    matchedVia: "exact" | "fuzzy";
+}
+/**
+ * Match an external entity to a list of DB candidates by name similarity.
+ *
+ * Compares every combination of `externalNames` × candidate `name + alternateNames`.
+ * Returns the best match above the threshold, or null.
+ *
+ * @param externalNames - External name(s) to match (e.g. main name + alternates)
+ * @param candidates    - DB records with `name` and optional `alternateNames`
+ * @param threshold     - Minimum similarity score (default 0.5)
+ */
+export declare function matchByName<T extends MatchCandidate>(externalNames: string[], candidates: T[], threshold?: number): MatchResult<T> | null;
+//# sourceMappingURL=team-matcher.d.ts.map

package/dist/matching/team-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-matcher.d.ts","sourceRoot":"","sources":["../../src/matching/team-matcher.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,cAAc;IACnD,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,GAAG,OAAO,CAAC;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,cAAc,EAClD,aAAa,EAAE,MAAM,EAAE,EACvB,UAAU,EAAE,CAAC,EAAE,EACf,SAAS,SAAM,GACd,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CA+BvB"}

package/dist/matching/team-matcher.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchByName = matchByName;
+const string_similarity_js_1 = require("string-similarity-js");
+const normalize_1 = require("./normalize");
+/**
+ * Match an external entity to a list of DB candidates by name similarity.
+ *
+ * Compares every combination of `externalNames` × candidate `name + alternateNames`.
+ * Returns the best match above the threshold, or null.
+ *
+ * @param externalNames - External name(s) to match (e.g. main name + alternates)
+ * @param candidates    - DB records with `name` and optional `alternateNames`
+ * @param threshold     - Minimum similarity score (default 0.5)
+ */
+function matchByName(externalNames, candidates, threshold = 0.5) {
+    const normExternal = externalNames.map(normalize_1.normalize).filter(Boolean);
+    if (normExternal.length === 0)
+        return null;
+    let bestMatch = null;
+    let bestScore = 0;
+    for (const candidate of candidates) {
+        const normCandidateName = (0, normalize_1.normalize)(candidate.name || "");
+        const normCandidateAlts = (candidate.alternateNames || []).map(normalize_1.normalize);
+        const allCandidateNames = [normCandidateName, ...normCandidateAlts].filter(Boolean);
+        for (const en of normExternal) {
+            for (const cn of allCandidateNames) {
+                if (en === cn) {
+                    return { item: candidate, score: 1.0, matchedVia: "exact" };
+                }
+                const score = (0, string_similarity_js_1.stringSimilarity)(en, cn);
+                if (score > bestScore) {
+                    bestScore = score;
+                    bestMatch = candidate;
+                }
+            }
+        }
+    }
+    if (bestMatch && bestScore >= threshold) {
+        return { item: bestMatch, score: bestScore, matchedVia: "fuzzy" };
+    }
+    return null;
+}
+//# sourceMappingURL=team-matcher.js.map

package/dist/matching/team-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-matcher.js","sourceRoot":"","sources":["../../src/matching/team-matcher.ts"],"names":[],"mappings":";;AAwBA,kCAmCC;AA3DD,+DAAwD;AACxD,2CAAwC;AAaxC;;;;;;;;;GASG;AACH,SAAgB,WAAW,CACzB,aAAuB,EACvB,UAAe,EACf,SAAS,GAAG,GAAG;IAEf,MAAM,YAAY,GAAG,aAAa,CAAC,GAAG,CAAC,qBAAS,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3C,IAAI,SAAS,GAAa,IAAI,CAAC;IAC/B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,iBAAiB,GAAG,IAAA,qBAAS,EAAC,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,iBAAiB,GAAG,CAAC,SAAS,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,qBAAS,CAAC,CAAC;QAC1E,MAAM,iBAAiB,GAAG,CAAC,iBAAiB,EAAE,GAAG,iBAAiB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEpF,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;YAC9B,KAAK,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;gBACnC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACd,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;gBAC9D,CAAC;gBAED,MAAM,KAAK,GAAG,IAAA,uCAAgB,EAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBACvC,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;oBACtB,SAAS,GAAG,KAAK,CAAC;oBAClB,SAAS,GAAG,SAAS,CAAC;gBACxB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,SAAS,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weekendgoals/weekendgoals-common",
-  "version": "1.1908.22254273988",
+  "version": "1.1909.22283215374",
   "description": "Weekend Goals Common",
   "private": false,
   "files": [
@@ -17,7 +17,8 @@
   "dependencies": {
     "@weekendgoals/weekendgoals-types": "^1.0.0",
     "axios": "^1.9.0",
-    "mongoose": "^8.20.1"
+    "mongoose": "^8.20.1",
+    "string-similarity-js": "^2.1.4"
   },
   "devDependencies": {
     "@types/node": "^24.10.1",