test: add coaster name matching test suite

Extract matching logic into lib/coaster-match.ts (isCoasterMatch + normalizeForMatch)
so it can be imported by both the scraper and tests without duplication.

Add tests/coaster-matching.test.ts covering all known match/false-positive cases:
- Trademark symbols, leading THE, possessives, punctuation
- Subtitle variants in both directions (Apocalypse, New Revolution - Classic)
- Space-split brand words (BAT GIRL vs Batgirl)
- 4D subtitle extension (THE JOKER™ 4D Free Fly Coaster vs Joker)
- False positives: Joker y Harley Quinn, conjunction connectors

Run with: npm test

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

lib/coaster-match.ts

@@ -0,0 +1,64 @@
+/**
+ * Coaster name matching — shared between the Queue-Times scraper and tests.
+ *
+ * Queue-Times and RCDB use different name conventions:
+ *   - Trademark symbols (™ ® ©)
+ *   - Leading "THE " prefixes
+ *   - Possessives ("Catwoman's" vs "Catwoman")
+ *   - Subtitles added or dropped ("Apocalypse" vs "Apocalypse the Ride")
+ *   - Space-split brand words ("BAT GIRL" vs "Batgirl")
+ *   - Conjunction-joined compound rides ("Joker y Harley Quinn" ≠ "Joker")
+ */
+
+// Words that join two ride names rather than extend one subtitle.
+// When a prefix match is found and the next word is one of these,
+// the longer name is a *different* ride, not a subtitle.
+const CONJUNCTIONS = new Set(["y", "and", "&", "with", "de", "del", "e", "et"]);
+
+/**
+ * Normalize a ride name for matching.
+ * Both sides (Queue-Times and RCDB) must be normalized with this function
+ * before any comparison so the transforms are symmetric.
+ */
+export function normalizeForMatch(name: string): string {
+  return name
+    .replace(/[\u2122\u00ae\u00a9™®©]/g, "")   // strip ™ ® ©
+    .replace(/^the\s+/i, "")                    // strip leading "THE "
+    .replace(/['\u2019]s\b/gi, "")              // strip possessives ('s / 's)
+    .replace(/[^\w\s]/g, " ")                   // all remaining punctuation → space
+    .replace(/\s+/g, " ")
+    .toLowerCase()
+    .trim();
+}
+
+/**
+ * Returns true when the Queue-Times ride name matches an entry in the RCDB
+ * coaster set (which must be built with normalizeForMatch).
+ *
+ * Matching strategy (in order):
+ * 1. Exact normalized match.
+ * 2. Compact (space-stripped) match — catches "BAT GIRL" vs "Batgirl".
+ * 3. Prefix match — the shorter normalized name is a prefix of the longer,
+ *    minimum 5 chars, unless the next word after the prefix is a conjunction
+ *    (which signals a compound ride name, not a subtitle).
+ */
+export function isCoasterMatch(qtName: string, coasterSet: Set<string>): boolean {
+  const norm = normalizeForMatch(qtName);
+  if (coasterSet.has(norm)) return true;
+
+  const compact = norm.replace(/\s/g, "");
+  for (const c of coasterSet) {
+    // Compact comparison
+    if (compact.length >= 5 && c.replace(/\s/g, "") === compact) return true;
+
+    // Prefix comparison
+    const shorter = norm.length <= c.length ? norm : c;
+    const longer  = norm.length <= c.length ? c : norm;
+    if (shorter.length >= 5 && longer.startsWith(shorter)) {
+      const nextWord = longer.slice(shorter.length).trim().split(" ")[0];
+      if (!CONJUNCTIONS.has(nextWord)) return true;
+    }
+  }
+
+  return false;
+}

lib/park-meta.ts

@@ -65,15 +65,8 @@ export function areCoastersStale(entry: ParkMeta): boolean {
  *   4. Collapse runs of whitespace
  *   5. Lowercase and trim
  */
-export function normalizeRideName(name: string): string {
-  return name
-    .replace(/[\u2122\u00ae\u00a9™®©]/g, "")
-    .replace(/^the\s+/i, "")
-    .replace(/[^\w\s]/g, " ")
-    .replace(/\s+/g, " ")
-    .toLowerCase()
-    .trim();
-}
+export { normalizeForMatch as normalizeRideName } from "./coaster-match.ts";
+import { normalizeForMatch } from "./coaster-match.ts";
 
 /**
  * Returns a Set of normalized coaster names for fast membership checks.
@@ -82,5 +75,5 @@ export function normalizeRideName(name: string): string {
 export function getCoasterSet(parkId: string, meta: ParkMetaMap): Set<string> | null {
   const entry = meta[parkId];
   if (!entry || entry.coasters.length === 0) return null;
-  return new Set(entry.coasters.map(normalizeRideName));
+  return new Set(entry.coasters.map(normalizeForMatch));
 }

lib/scrapers/queuetimes.ts

@@ -9,45 +9,7 @@
 
 const BASE = "https://queue-times.com/parks";
 
-/**
- * Normalize a ride name for fuzzy matching between Queue-Times and RCDB.
- *
- * - Strips trademark/copyright symbols (™ ® © and Unicode variants)
- * - Strips leading "THE " prefix
- * - Replaces ALL non-word, non-space characters with a space
- *   (handles !, -, :, ', ' U+2019, ", and any other punctuation)
- * - Collapses whitespace, lowercases, trims
- */
-function normalize(name: string): string {
-  return name
-    .replace(/[\u2122\u00ae\u00a9™®©]/g, "")
-    .replace(/^the\s+/i, "")
-    .replace(/[^\w\s]/g, " ")
-    .replace(/\s+/g, " ")
-    .toLowerCase()
-    .trim();
-}
-
-/**
- * Check if a Queue-Times ride name matches any coaster in the RCDB set.
- *
- * Exact normalized match covers most cases. Prefix matching handles cases
- * where one source drops or adds a subtitle:
- *   "Apocalypse" (QT) vs "Apocalypse the Ride" (RCDB)
- *   "The New Revolution - Classic" (QT) vs "New Revolution" (RCDB)
- *
- * Minimum 5 chars on the shorter side prevents accidental short matches.
- */
-function isCoaster(name: string, coasterSet: Set<string>): boolean {
-  const norm = normalize(name);
-  if (coasterSet.has(norm)) return true;
-  for (const c of coasterSet) {
-    const shorter = norm.length <= c.length ? norm : c;
-    const longer  = norm.length <= c.length ? c : norm;
-    if (shorter.length >= 5 && longer.startsWith(shorter)) return true;
-  }
-  return false;
-}
+import { isCoasterMatch, normalizeForMatch } from "../coaster-match.ts";
 
 const HEADERS = {
   "User-Agent":
@@ -131,7 +93,7 @@ export async function fetchLiveRides(
           isOpen: r.is_open,
           waitMinutes: r.wait_time ?? 0,
           lastUpdated: r.last_updated,
-          isCoaster: coasterNames ? isCoaster(r.name, coasterNames) : false,
+          isCoaster: coasterNames ? isCoasterMatch(r.name, coasterNames) : false,
         });
       }
     }