fix(pl24): correct PSA VIN decode via FI/VIN-indexed flow + cycle-correct model year

PSA (Peugeot/Citroën/DS) VIN decode was systemically broken: the catalog
vin-group page returns all families unfiltered, so decode fell back to the first
family/salesType (a manual base variant) — yielding "{Brand} {VIN}" model names,
empty transmission, wrong model year, and manual-only parts trees (automatic
gearbox parts missing). Reported for a 1999 Peugeot 106 automatic shown as a 2029
manual with no automatic parts.

- New self-contained PL24PsaService: consumes PL24's FI flow (vin.action →
  hintstoken → FI page → json-vin-main-groups → json-vin-illustrations →
  vin-image-board). Reads model/year/transmission from the FI identification
  table; builds the VIN-indexed parts tree (correct per actual VIN). Does not
  touch Ford/Volvo/Nissan/Opel/Hyundai-Kia/Fiat.
- Orchestrator + categories.service route PSA VIN decode/drill to the new service.
- Cycle-correct extractModelYear in @sase/shared (X→1999, not 2029): resolve the
  30-yr VIN year code to the most-recent plausible year (≤ now+1); dedupe 6 copies.

Validated live against 13 already-decoded PSA VINs: 12/13 full trees with real
model/year/transmission; automatics correctly detected (106 BVA, 206 AL4, 3008 BVA8).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

apps/api/src/integrations/emex/emex.mapper.ts

@@ -10,6 +10,7 @@
  * persisting.
  */
 
+import { extractModelYear } from "@sase/shared";
 import {
   CATALOG_MAP,
   type DecodedCategory,
@@ -148,40 +149,8 @@ export function mapEmexResponse(response: EmexScraperResponse): DecodedVehicle {
  * Extracts year from VIN (10th character)
  */
 function extractYearFromVin(vin: string): number {
-  const yearChar = vin.charAt(9).toUpperCase();
-  const yearMap: Record<string, number> = {
-    "1": 2001,
-    "2": 2002,
-    "3": 2003,
-    "4": 2004,
-    "5": 2005,
-    "6": 2006,
-    "7": 2007,
-    "8": 2008,
-    "9": 2009,
-    A: 2010,
-    B: 2011,
-    C: 2012,
-    D: 2013,
-    E: 2014,
-    F: 2015,
-    G: 2016,
-    H: 2017,
-    J: 2018,
-    K: 2019,
-    L: 2020,
-    M: 2021,
-    N: 2022,
-    P: 2023,
-    R: 2024,
-    S: 2025,
-    T: 2026,
-    V: 2027,
-    W: 2028,
-    X: 2029,
-    Y: 2030,
-  };
-  return yearMap[yearChar] || new Date().getFullYear();
+  // Servis yıl vermediğinde son çare; bilinmeyen kod için içinde bulunulan yıl.
+  return extractModelYear(vin) ?? new Date().getFullYear();
 }
 
 /**

apps/api/src/integrations/emex/emex.service.ts

@@ -1012,49 +1012,4 @@ export class EmexService {
     }
     return { width: 0, height: 0 };
   }
-
-  /**
-   * Extracts year from VIN (10th character)
-   */
-  getYearFromVin(vin: string): number | null {
-    if (!vin || vin.length < 10) {
-      return null;
-    }
-
-    const yearChar = vin.charAt(9).toUpperCase();
-    const yearMap: Record<string, number> = {
-      "1": 2001,
-      "2": 2002,
-      "3": 2003,
-      "4": 2004,
-      "5": 2005,
-      "6": 2006,
-      "7": 2007,
-      "8": 2008,
-      "9": 2009,
-      A: 2010,
-      B: 2011,
-      C: 2012,
-      D: 2013,
-      E: 2014,
-      F: 2015,
-      G: 2016,
-      H: 2017,
-      J: 2018,
-      K: 2019,
-      L: 2020,
-      M: 2021,
-      N: 2022,
-      P: 2023,
-      R: 2024,
-      S: 2025,
-      T: 2026,
-      V: 2027,
-      W: 2028,
-      X: 2029,
-      Y: 2030,
-    };
-
-    return yearMap[yearChar] || null;
-  }
 }