@autobusal/routes-order 1.37.9 → 1.38.0

package/RoutesOrder.tsx

@@ -1,4 +1,4 @@
-import { useState, useEffect, useMemo } from 'react';
+import { useState, useEffect, useMemo, useRef } from 'react';
 import { useParams, useSearchParams, useNavigate, useLocation } from 'react-router-dom';
 import { TFunction } from 'i18next';
 import { AiOutlineSearch, AiOutlineCaretDown, AiOutlineCaretUp } from 'react-icons/ai';
@@ -308,6 +308,36 @@ const RoutesOrder = ({ t }: Props): JSX.Element => {
     setRedirected(true);
   };
 
+  /*
+   * Claude - 2026-09-24: a link that names the coach.
+   *
+   * A referral partner shows our departures on their own site and sends the
+   * buyer here through the API's purchase_url, which is this page's 9-segment
+   * search URL plus `route=<id>` (and `return_route=<id>` on a round trip).
+   * The buyer already chose on the partner's page; making them choose again
+   * on our results would lose a share of them. So the moment the results
+   * that link describes arrive, the named coach is selected exactly as a
+   * click on its Select button would, and the wizard moves on to checkout.
+   *
+   * Once per mount and per slot: the ref remembers what was honoured, so
+   * Back to the results does not re-select the coach the buyer just left,
+   * while a reload of the checkout URL (which still carries the params)
+   * lands on checkout again, as a shared link should. A named coach that is
+   * not in the results - sold out, gone - leaves the buyer on the results
+   * with everything that is available.
+   */
+  const preselected = useRef<Set<string>>(new Set());
+
+  const preselect = (slot: 'route' | 'return_route'): (string | undefined) => {
+    const id = searchParams.get(slot);
+
+    return id && !preselected.current.has(slot) ? id : undefined;
+  };
+
+  const honour = (slot: 'route' | 'return_route'): void => {
+    preselected.current.add(slot);
+  };
+
   const onStep2 = (data: FoundData): void => {
     setStep2(data);
 
@@ -418,9 +448,10 @@ const RoutesOrder = ({ t }: Props): JSX.Element => {
       { showStep2 && (
         <Step2
           step1={ step1 }
+          preselect={ preselect('route') }
           t={ t }
           onSearch={ onSearchDate }
-          onSave={ onStep2 }
+          onSave={ data => { honour('route'); onStep2(data); } }
           onBack={ onBack }
         />
       ) }
@@ -429,9 +460,10 @@ const RoutesOrder = ({ t }: Props): JSX.Element => {
         <Step3
           step1={ step1 }
           step2={ step2 }
+          preselect={ preselect('return_route') }
           t={ t }
           onSearch={ onSearchDate }
-          onSave={ onStep3 }
+          onSave={ data => { honour('return_route'); onStep3(data); } }
           onBack={ onBack }
         />
       ) }

package/Step2.tsx

@@ -1,3 +1,4 @@
+import { useEffect } from 'react';
 import { TFunction } from 'i18next';
 import { RiBus2Line } from 'react-icons/ri';
 import { AiOutlineCaretLeft } from 'react-icons/ai';
@@ -12,15 +13,30 @@ import { useGetSuggestions } from '@autobusal/routes-search/services';
 
 interface Props {
   step1: RoutesSearchForm
+  // the id of a coach a link named, to select as soon as it is in the results
+  preselect?: string
   t: TFunction<'common'>
   onSearch: (data: ('departure' | '_return'), day: string) => void
   onSave: (data: FoundData) => void
   onBack: (step: number) => void
 }
 
-const Step2 = ({ step1, t, onSearch, onSave, onBack }: Props): JSX.Element => {
+const Step2 = ({ step1, preselect, t, onSearch, onSave, onBack }: Props): JSX.Element => {
   const { data, isFetching } = useGetDepartures(step1);
 
+  // Claude - 2026-09-24: a purchase_url named this coach - see RoutesOrder
+  useEffect(() => {
+    if (preselect === undefined || data === undefined) {
+      return;
+    }
+
+    const named = data.find(item => String(item.id) === preselect && item.type !== 'external');
+
+    if (named) {
+      onSave(named);
+    }
+  }, [ preselect, data ]);
+
   /**
    * Edited: Ferjolt Ozuni - Date: 2026-08-01
    *

package/Step3.tsx

@@ -1,3 +1,4 @@
+import { useEffect } from 'react';
 import { TFunction } from 'i18next';
 import { RiBus2Line } from 'react-icons/ri';
 import { AiOutlineCaretLeft } from 'react-icons/ai';
@@ -12,15 +13,30 @@ import { useGetReturns } from './services';
 interface Props {
   step1: RoutesSearchForm
   step2: FoundData
+  // the id of a coach a link named, to select as soon as it is in the results
+  preselect?: string
   t: TFunction<'common'>
   onSearch: (data: ('departure' | '_return'), day: string) => void
   onSave: (data: FoundData) => void
   onBack: (step: number) => void
 }
 
-const Step3 = ({ step1, step2, t, onSearch, onSave, onBack }: Props): JSX.Element => {
+const Step3 = ({ step1, step2, preselect, t, onSearch, onSave, onBack }: Props): JSX.Element => {
   const { data, isFetching } = useGetReturns(step1, step2);
 
+  // Claude - 2026-09-24: a purchase_url named this coach - see RoutesOrder
+  useEffect(() => {
+    if (preselect === undefined || data === undefined) {
+      return;
+    }
+
+    const named = data.find(item => String(item.id) === preselect && item.type !== 'external');
+
+    if (named) {
+      onSave(named);
+    }
+  }, [ preselect, data ]);
+
   return (
     <>
       <Title>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autobusal/routes-order",
-  "version": "1.37.9",
+  "version": "1.38.0",
   "author": "Ferjolt Ozuni",
   "type": "module",
   "main": "index.ts",