@weekendgoals/weekendgoals-common 1.2282.32182805437 → 1.2283.32404009206

package/dist/models/venues/index.d.ts

@@ -30,7 +30,7 @@ export declare const VenueSchema: mongoose.Schema<any, mongoose.Model<any, any,
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, mongoose.FlatRecord<{
     alternateNames: string[];
     searchNames: string[];
@@ -59,7 +59,7 @@ export declare const VenueSchema: mongoose.Schema<any, mongoose.Model<any, any,
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps>, {}, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
     timestamps: true;
     typeKey: "$type";
@@ -91,7 +91,7 @@ export declare const VenueSchema: mongoose.Schema<any, mongoose.Model<any, any,
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps> & {
     _id: mongoose.Types.ObjectId;
 } & {
@@ -125,7 +125,7 @@ export declare const VenueModel: mongoose.Model<{
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps, {}, {}, {}, mongoose.Document<unknown, {}, {
     alternateNames: string[];
     searchNames: string[];
@@ -154,7 +154,7 @@ export declare const VenueModel: mongoose.Model<{
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps, {}, {
     timestamps: true;
     typeKey: "$type";
@@ -186,7 +186,7 @@ export declare const VenueModel: mongoose.Model<{
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps & {
     _id: mongoose.Types.ObjectId;
 } & {
@@ -222,7 +222,7 @@ export declare const VenueModel: mongoose.Model<{
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps, mongoose.Document<unknown, {}, mongoose.FlatRecord<{
     alternateNames: string[];
     searchNames: string[];
@@ -251,7 +251,7 @@ export declare const VenueModel: mongoose.Model<{
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps>, {}, mongoose.MergeType<mongoose.DefaultSchemaOptions, {
     timestamps: true;
     typeKey: "$type";
@@ -283,7 +283,7 @@ export declare const VenueModel: mongoose.Model<{
     hasCustomImage?: boolean;
     googlePlaceId?: string;
     capacity?: number;
-    cityMatchedVia?: "name" | "name+geo" | "geo";
+    cityMatchedVia?: "name" | "name+geo" | "geo" | "manual";
 } & mongoose.DefaultTimestampProps> & {
     _id: mongoose.Types.ObjectId;
 } & {

package/dist/models/venues/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/venues/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAErC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsHvB,CAAC;AAUF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAiD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/venues/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAErC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuHvB,CAAC;AAUF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAiD,CAAC"}

package/dist/models/venues/index.js

@@ -32,39 +32,31 @@ exports.VenueSchema = new mongoose.Schema({
     imageAttribution: String,
     hasCustomImage: Boolean,
     address: String,
-    // The supplier's own strings, kept raw on purpose: they are the input the
-    // city match runs on, so canonicalising them here would destroy the match
-    // input and make every venue look like it had changed city.
+    // Display names, denormalized from `cityId` / `countryId` (decision
+    // 2026-08-20). They carry `City.name` and `Country.name` verbatim so the
+    // venue payload can be rendered — and published to schema.org as
+    // `addressLocality` / `addressCountry` — without a join, including in list
+    // and map contexts where a per-venue lookup would be N queries.
     //
-    // Being independent of `location` is the other reason they earn their
-    // place. `countryId` is DERIVED from the coordinates, so it cannot judge a
-    // proposed coordinate fix - it can only re-assert the position being
-    // corrected, and a venue parked on a Philippines centroid will reject a
-    // correct Maltese answer. `country` can judge it, and is what the
-    // 2026-08-17 repair anchored on. The team-locations work documents the same
-    // circularity defeating four other discriminators.
+    // They USED to be the supplier's raw strings, and two things died with
+    // that. Recorded here because neither is recoverable by looking at the
+    // data afterwards:
     //
-    // Not FIT for display - `country` in particular is unreliable (320
-    // distinct values for ~200 countries, and API-Football's venue country is
-    // not a stable property of the venue). 255 rows whose string named a
-    // different country than their own coordinates were repaired on
-    // 2026-08-17, and 5 are still wrong.
+    //  - `country` was the only field independent of `location`. That is what
+    //    let it arbitrate the 2026-08-17 coordinate repair and catch the five
+    //    venues whose string named a different country than their coordinates
+    //    (Estadio Nacional in Santiago said "Australia"). "Country disagrees
+    //    with coordinates" now returns 0 by construction, not by cleanliness.
+    //  - `city` was the name half of the city match: 12,394 of 13,767 links
+    //    are `name+geo` because of it.
     //
-    // They are nonetheless displayed today, which is a defect and not a
-    // licence: weekendgoals-ui-next reads them in 17 files, and
-    // `functional/structured-data.ts` publishes them to Google as
-    // schema.org `addressLocality` and `addressCountry` in nine places - so
-    // Estadio Nacional in Santiago currently emits `addressCountry:
-    // "Australia"`. Those readers belong on `cityId`/`countryId`, whose names
-    // the venue payload does not carry yet. Until then, do not add readers.
+    // **So `scripts/link-venues-to-cities.ts` must not be run against
+    // production until the new venue matcher lands.** It would match the name
+    // it just wrote, promoting every `geo` link to `name+geo` — a silent
+    // upgrade of 1,370 guesses into apparent certainties.
     //
-    // An earlier version of this comment also justified the field by "the
-    // weekly venue audit diffs against them". There is no such audit - nothing
-    // in the repo implements one and weekendgoals-scraper/CLAUDE.md says so
-    // outright. The nearest thing is a one-time diff against
-    // `GET /venues?id=`, and that endpoint is not trustworthy: it answers 566
-    // with Wembley Stadium while `/venues?search=City Ground` answers 566 with
-    // The City Ground, and its capacities lost to Wikidata 0-506.
+    // Write them ONLY in the same `$set` as the id they mirror. A copy that is
+    // refreshed separately is how `Match.location` went stale on 11,304 rows.
     city: String,
     country: String,
     // Where the venue actually is. Resolved from the venue's own coordinates
@@ -73,8 +65,17 @@ exports.VenueSchema = new mongoose.Schema({
     // never filled with a guess.
     cityId: { $type: mongoose.Schema.Types.ObjectId, ref: "City" },
     countryId: { $type: mongoose.Schema.Types.ObjectId, ref: "Country" },
-    /** How cityId was established; see matching/city-matcher.ts. */
-    cityMatchedVia: { $type: String, enum: ["name+geo", "name", "geo"] },
+    // How cityId was established; see matching/city-matcher.ts for the three
+    // derived tiers. `manual` is the fourth and is not one of them: it marks a
+    // link a human made that the matcher cannot reproduce, and
+    // scripts/link-venues-to-cities.ts leaves those rows alone rather than
+    // clearing them as stale. It exists because a venue can sit outside the
+    // matcher's deliberate 30km radius and still be in the city — King Abdullah
+    // Sports City is 30.5km from Jeddah's centroid and is in Jeddah.
+    cityMatchedVia: {
+        $type: String,
+        enum: ["name+geo", "name", "geo", "manual"],
+    },
     // Other API-Football ids that turned out to be this same stadium. A ground
     // acquires them because the supplier issues a second id (Parken is 5806 and
     // 11600) or a temporary tournament alias (Euro 2024 renamed every German

package/dist/models/venues/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/venues/index.ts"],"names":[],"mappings":";;;AAAA,qCAAqC;AAExB,QAAA,WAAW,GAAG,IAAI,QAAQ,CAAC,MAAM,CAC5C;IACE,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;IAC3C,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE;QACR,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,KAAK,EAAE,MAAM;gBACb,IAAI,EAAE,CAAC,OAAO,CAAC;gBACf,QAAQ,EAAE,CAAC,IAAI,EAAE,wBAAwB,CAAC;aAC3C;YACD,WAAW,EAAE;gBACX,KAAK,EAAE,CAAC,MAAM,CAAC;gBACf,QAAQ,EAAE,CAAC,IAAI,EAAE,+BAA+B,CAAC;aAClD;SACF;QACD,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,KAAK;KACX;IAED,QAAQ,EAAE,MAAM;IAChB,0EAA0E;IAC1E,0EAA0E;IAC1E,uEAAuE;IACvE,2EAA2E;IAC3E,0EAA0E;IAC1E,0DAA0D;IAC1D,aAAa,EAAE,MAAM;IACrB,gBAAgB,EAAE,MAAM;IACxB,cAAc,EAAE,OAAO;IACvB,OAAO,EAAE,MAAM;IAEf,0EAA0E;IAC1E,0EAA0E;IAC1E,4DAA4D;IAC5D,EAAE;IACF,sEAAsE;IACtE,2EAA2E;IAC3E,qEAAqE;IACrE,wEAAwE;IACxE,kEAAkE;IAClE,4EAA4E;IAC5E,mDAAmD;IACnD,EAAE;IACF,mEAAmE;IACnE,0EAA0E;IAC1E,qEAAqE;IACrE,gEAAgE;IAChE,qCAAqC;IACrC,EAAE;IACF,oEAAoE;IACpE,4DAA4D;IAC5D,8DAA8D;IAC9D,wEAAwE;IACxE,gEAAgE;IAChE,0EAA0E;IAC1E,wEAAwE;IACxE,EAAE;IACF,sEAAsE;IACtE,2EAA2E;IAC3E,wEAAwE;IACxE,yDAAyD;IACzD,0EAA0E;IAC1E,2EAA2E;IAC3E,8DAA8D;IAC9D,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,MAAM;IAEf,yEAAyE;IACzE,qEAAqE;IACrE,uEAAuE;IACvE,6BAA6B;IAC7B,MAAM,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE;IAC9D,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,EAAE;IACpE,gEAAgE;IAChE,cAAc,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;IAEpE,2EAA2E;IAC3E,4EAA4E;IAC5E,yEAAyE;IACzE,uEAAuE;IACvE,uEAAuE;IACvE,oBAAoB,EAAE,CAAC,MAAM,CAAC;IAE9B,sEAAsE;IACtE,0EAA0E;IAC1E,wEAAwE;IACxE,wDAAwD;IACxD,cAAc,EAAE,CAAC,MAAM,CAAC;IAExB,0EAA0E;IAC1E,4EAA4E;IAC5E,qDAAqD;IACrD,WAAW,EAAE,CAAC,MAAM,CAAC;IAErB,MAAM,EAAE,MAAM;IACd,aAAa,EAAE,MAAM;IACrB,QAAQ,EAAE,MAAM;IAEhB,QAAQ,EAAE;QACR,uEAAuE;QACvE,oEAAoE;QACpE,mEAAmE;QACnE,UAAU,EAAE,MAAM;QAClB,oEAAoE;QACpE,qEAAqE;QACrE,uBAAuB;QACvB,kBAAkB,EAAE;YAClB,KAAK,EAAE,MAAM;YACb,IAAI,EAAE,CAAC,kBAAkB,EAAE,UAAU,EAAE,QAAQ,CAAC;SACjD;QACD,iEAAiE;QACjE,qEAAqE;QACrE,YAAY,EAAE,MAAM;KACrB;CACF,EACD,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CACvC,CAAC;AAEF,mBAAW,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC/E,mBAAW,CAAC,KAAK,CACf,EAAE,oBAAoB,EAAE,CAAC,EAAE,EAC3B,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,CAC/C,CAAC;AACF,mBAAW,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrD,mBAAW,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;AAE9C,QAAA,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,mBAAW,EAAE,QAAQ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/venues/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weekendgoals/weekendgoals-common",
-  "version": "1.2282.32182805437",
+  "version": "1.2283.32404009206",
   "description": "Weekend Goals Common",
   "private": false,
   "files": [