agent_backend/app/course-navigation.ts

export type CourseRoute = { module: string; lesson?: string };
export function courseHref(module: string, lesson?: string) {
  const query = new URLSearchParams();
  if (module !== 'api' || !lesson) query.set('module', module);
  if (lesson) query.set('lesson', lesson);
  return `?${query.toString()}`;
}
export function parseCourseQuery(search: string): CourseRoute {
  const query = new URLSearchParams(search);
  return {
    module: query.get('module') || 'api',
    lesson: query.get('lesson') || undefined,
  };
}