@supersoniks/concorde 5.1.1 → 5.1.2

package/src/docs/mock-api/fixtures.ts

@@ -97,281 +97,3 @@ export const DOCS_GEO_COMMUNES: GeoCommuneRow[] = [
   { nom: "Montpellier", code: "34172" },
   { nom: "Rennes", code: "35238" },
 ];
-
-/** JokeAPI-style content flags (checkbox / radio / switch blacklist demos). */
-export type DocsJokeFlagKey =
-  | "nsfw"
-  | "religious"
-  | "political"
-  | "racist"
-  | "sexist"
-  | "explicit";
-
-/** Forme proche de JokeAPI v2 (`key="jokes"` sur sonic-queue / list). */
-export type DocsJokeItem = {
-  categories: string[];
-  createdAt: string;
-  id: number;
-  joke: string;
-  lang: "fr" | "en";
-  flags: Record<DocsJokeFlagKey, boolean>;
-  safe: boolean;
-  type: string;
-  setup?: string;
-  delivery?: string;
-};
-
-const jokeFlags = (
-  partial: Partial<Record<DocsJokeFlagKey, boolean>> = {},
-): Record<DocsJokeFlagKey, boolean> => ({
-  nsfw: false,
-  religious: false,
-  political: false,
-  racist: false,
-  sexist: false,
-  explicit: false,
-  ...partial,
-});
-
-export type DocsJokeApiResponse = {
-  error: boolean;
-  amount: number;
-  jokes: DocsJokeItem[];
-};
-
-const SAMPLE_JOKES: DocsJokeItem[] = [
-  {
-    categories: ["Programming"],
-    createdAt: "2020-01-01 00:00:00",
-    id: 1,
-    lang: "en",
-    joke: "Why do programmers prefer dark mode? Because light attracts bugs.",
-    flags: jokeFlags(),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Misc"],
-    createdAt: "2020-01-02 00:00:00",
-    id: 2,
-    lang: "en",
-    joke: "I told my computer I needed a break — it said: no problem, I'll go to sleep.",
-    flags: jokeFlags({ nsfw: true }),
-    safe: false,
-    type: "single",
-  },
-  {
-    categories: ["Pun"],
-    createdAt: "2020-01-03 00:00:00",
-    id: 3,
-    lang: "en",
-    joke: "Concorde docs run offline: even the API is a local joke.",
-    flags: jokeFlags(),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Animals"],
-    createdAt: "2020-01-04 00:00:00",
-    id: 4,
-    lang: "en",
-    joke: "The dog ate my homework and my pull request.",
-    flags: jokeFlags({ political: true }),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Animals", "Pun"],
-    createdAt: "2020-01-05 00:00:00",
-    id: 5,
-    lang: "fr",
-    joke: "Quel est le chien préféré des développeurs ? Le labrador Retriever.",
-    flags: jokeFlags(),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Animals"],
-    createdAt: "2020-01-06 00:00:00",
-    id: 6,
-    lang: "fr",
-    joke: "Un chat et un chien discutent de TypeScript : le chien dit « woof », le chat compile.",
-    flags: jokeFlags({ racist: true }),
-    safe: false,
-    type: "single",
-  },
-  {
-    categories: ["Misc"],
-    createdAt: "2020-01-07 00:00:00",
-    id: 7,
-    lang: "fr",
-    joke: "Pourquoi les blagues offline sont-elles fiables ? Parce qu'elles passent par le Service Worker.",
-    flags: jokeFlags({ religious: true }),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Programming"],
-    createdAt: "2020-01-08 00:00:00",
-    id: 8,
-    lang: "fr",
-    joke: "Mon compilateur et mon chien : tous deux ignorent mes commandes jusqu'au build.",
-    flags: jokeFlags({ sexist: true }),
-    safe: false,
-    type: "single",
-  },
-  {
-    categories: ["Misc"],
-    createdAt: "2020-01-09 00:00:00",
-    id: 9,
-    lang: "en",
-    joke: "A SQL query walks into a bar, walks up to two tables and asks: Can I join you?",
-    flags: jokeFlags({ explicit: true }),
-    safe: false,
-    type: "single",
-  },
-  {
-    categories: ["Pun"],
-    createdAt: "2020-01-10 00:00:00",
-    id: 10,
-    lang: "fr",
-    joke: "J'ai cherché « chien » dans la doc : le mock API a répondu.",
-    flags: jokeFlags(),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Misc"],
-    createdAt: "2020-01-11 00:00:00",
-    id: 11,
-    lang: "en",
-    joke: "There are only two hard things in Computer Science: cache invalidation and naming things.",
-    flags: jokeFlags({ political: true, explicit: true }),
-    safe: false,
-    type: "single",
-  },
-  {
-    categories: ["Animals"],
-    createdAt: "2020-01-12 00:00:00",
-    id: 12,
-    lang: "fr",
-    joke: "Le golden retriever a récupéré la donnée du publisher.",
-    flags: jokeFlags({ racist: true, sexist: true }),
-    safe: false,
-    type: "two-liner",
-    setup: "Pourquoi le chien aime Concorde ?",
-    delivery: "Parce qu'il sait fetch.",
-  },
-  {
-    categories: ["Misc"],
-    createdAt: "2020-01-13 00:00:00",
-    id: 13,
-    lang: "en",
-    joke: "My code and my conscience: both have too many warnings.",
-    flags: jokeFlags(),
-    safe: true,
-    type: "single",
-  },
-  {
-    categories: ["Programming"],
-    createdAt: "2020-01-14 00:00:00",
-    id: 14,
-    lang: "en",
-    joke: "Git blame is just a mirror.",
-    flags: jokeFlags({ religious: true, political: true }),
-    safe: false,
-    type: "single",
-  },
-];
-
-/** `blacklistFlags` from queue filter form (comma-separated or repeated param). */
-export function parseBlacklistFlags(url: URL): DocsJokeFlagKey[] {
-  const keys = new Set<DocsJokeFlagKey>();
-  const valid: DocsJokeFlagKey[] = [
-    "nsfw",
-    "religious",
-    "political",
-    "racist",
-    "sexist",
-    "explicit",
-  ];
-  const add = (raw: string) => {
-    raw
-      .split(",")
-      .map((s) => s.trim().toLowerCase())
-      .forEach((part) => {
-        if (valid.includes(part as DocsJokeFlagKey)) keys.add(part as DocsJokeFlagKey);
-      });
-  };
-  url.searchParams.getAll("blacklistFlags").forEach(add);
-  const single = url.searchParams.get("blacklistFlags");
-  if (single) add(single);
-  return [...keys];
-}
-
-/** Exclude jokes that match any blacklisted flag (JokeAPI-style). */
-export function applyJokeBlacklist(
-  jokes: DocsJokeItem[],
-  blacklist: DocsJokeFlagKey[],
-): DocsJokeItem[] {
-  if (!blacklist.length) return jokes;
-  return jokes.filter(
-    (j) => !blacklist.some((flag) => j.flags[flag] === true),
-  );
-}
-
-/** Filtre doc joke queue (`contains`, `lang`, `blacklistFlags` via `dataFilterProvider`). */
-export function filterDocsJokes(
-  jokes: DocsJokeItem[],
-  url: URL,
-): DocsJokeItem[] {
-  let pool = jokes;
-  const contains = url.searchParams.get("contains")?.trim().toLowerCase();
-  if (contains) {
-    pool = pool.filter((j) => {
-      const haystack = [j.joke, j.setup, j.delivery, ...j.categories]
-        .filter(Boolean)
-        .join(" ")
-        .toLowerCase();
-      return haystack.includes(contains);
-    });
-  }
-  const lang = url.searchParams.get("lang")?.trim().toLowerCase();
-  if (lang === "fr" || lang === "en") {
-    pool = pool.filter((j) => j.lang === lang);
-  }
-  pool = applyJokeBlacklist(pool, parseBlacklistFlags(url));
-  return pool;
-}
-
-/**
- * Réponse type JokeAPI v2.
- * - `amount` : taille du lot si pas de `offset`
- * - `offset` + `limit` / `per_page` : pagination (sonic-queue lazy)
- * - `contains`, `lang`, `blacklistFlags` : filtres formulaire (queue « Remove following jokes »)
- */
-export function buildJokeApiResponse(url: URL): DocsJokeApiResponse {
-  const pool = filterDocsJokes(SAMPLE_JOKES, url);
-  const amount = Math.max(
-    1,
-    parseInt(url.searchParams.get("amount") || "10", 10),
-  );
-  const hasOffset = url.searchParams.has("offset");
-  const limit = Math.max(
-    1,
-    parseInt(
-      url.searchParams.get("limit") ||
-        url.searchParams.get("per_page") ||
-        String(amount),
-      10,
-    ),
-  );
-  const offset = Math.max(0, parseInt(url.searchParams.get("offset") || "0", 10));
-  const start = hasOffset ? offset : 0;
-  const count = hasOffset ? limit : amount;
-  const jokes = pool.slice(start, start + count).map((j, i) => ({
-    ...j,
-    id: start + i + 1,
-  }));
-  return { error: false, amount: jokes.length, jokes };
-}

package/src/docs/mock-api/flights.ts

@@ -0,0 +1,89 @@
+/** Fictional flight board for list / queue filter demos (`key="flights"`). */
+export type DocsFlightStatus =
+  | "on-time"
+  | "boarding"
+  | "delayed"
+  | "landed"
+  | "cancelled";
+
+export type DocsFlight = {
+  id: number;
+  code: string;
+  direction: "departures" | "arrivals";
+  airport: string;
+  city: string;
+  time: string;
+  gate: string;
+  status: DocsFlightStatus;
+};
+
+const row = (
+  code: string,
+  direction: DocsFlight["direction"],
+  airport: string,
+  city: string,
+  time: string,
+  gate: string,
+  status: DocsFlightStatus,
+): Omit<DocsFlight, "id"> => ({
+  code,
+  direction,
+  airport,
+  city,
+  time,
+  gate,
+  status,
+});
+
+const FLIGHTS: Omit<DocsFlight, "id">[] = [
+  row("CN 001", "departures", "JFK", "New York", "08:15", "B12", "boarding"),
+  row("CN 014", "departures", "LHR", "London", "08:40", "A03", "on-time"),
+  row("CN 102", "departures", "GIG", "Rio de Janeiro", "09:05", "C21", "delayed"),
+  row("CN 220", "departures", "DKR", "Dakar", "09:30", "C07", "on-time"),
+  row("CN 305", "departures", "IAD", "Washington", "10:10", "B04", "cancelled"),
+  row("CN 412", "departures", "BAH", "Bahrain", "10:45", "D02", "delayed"),
+  row("CN 518", "departures", "SIN", "Singapore", "11:20", "D14", "on-time"),
+  row("CN 633", "departures", "YUL", "Montreal", "12:00", "A11", "on-time"),
+  row("CN 002", "arrivals", "JFK", "New York", "07:50", "B10", "landed"),
+  row("CN 015", "arrivals", "LHR", "London", "08:25", "A05", "landed"),
+  row("CN 103", "arrivals", "GIG", "Rio de Janeiro", "09:15", "C20", "delayed"),
+  row("CN 221", "arrivals", "DKR", "Dakar", "09:55", "C08", "on-time"),
+  row("CN 306", "arrivals", "IAD", "Washington", "10:35", "B06", "on-time"),
+  row("CN 413", "arrivals", "BAH", "Bahrain", "11:05", "D03", "cancelled"),
+  row("CN 519", "arrivals", "SIN", "Singapore", "11:40", "D15", "delayed"),
+  row("CN 634", "arrivals", "YUL", "Montreal", "12:30", "A12", "on-time"),
+];
+
+/**
+ * `GET /flights` — filters:
+ * - `direction`: `departures` · `arrivals`
+ * - `q`: substring on code / city / airport
+ * - `status`: comma-separated statuses to keep (`all` or empty = no filter)
+ * - `offset` + `limit`: pagination for sonic-queue
+ */
+export function buildFlightsResponse(url: URL): { flights: DocsFlight[] } {
+  const p = url.searchParams;
+  let pool = FLIGHTS.map((f, i) => ({ ...f, id: i + 1 }));
+
+  const direction = p.get("direction");
+  if (direction === "departures" || direction === "arrivals") {
+    pool = pool.filter((f) => f.direction === direction);
+  }
+  const q = p.get("q")?.trim().toLowerCase();
+  if (q) {
+    pool = pool.filter((f) =>
+      [f.code, f.city, f.airport].join(" ").toLowerCase().includes(q),
+    );
+  }
+  const statuses = (p.get("status") || "")
+    .split(",")
+    .map((s) => s.trim())
+    .filter((s) => s && s !== "all");
+  if (statuses.length) {
+    pool = pool.filter((f) => statuses.includes(f.status));
+  }
+
+  const offset = Math.max(0, parseInt(p.get("offset") || "0", 10));
+  const limit = Math.max(1, parseInt(p.get("limit") || "20", 10));
+  return { flights: pool.slice(offset, offset + limit) };
+}

package/src/docs/mock-api/router.ts

@@ -1,8 +1,8 @@
 import { handleApiConfigMockRequest } from "./api-config-mock";
+import { buildFlightsResponse } from "./flights";
 import {
   DOCS_GEO_COMMUNES,
   DOCS_REQRES_USERS,
-  buildJokeApiResponse,
   filterDocsUsers,
   type GeoCommuneRow,
   type ReqresUserResponse,
@@ -291,9 +291,8 @@ export async function handleDocsMockApiRequest(
     });
   }
 
-  const jokeMatch = subPath.match(/^\/jokes\/joke\/([^/]+)$/);
-  if (jokeMatch) {
-    return json(buildJokeApiResponse(url));
+  if (subPath === "/flights") {
+    return json(buildFlightsResponse(url));
   }
 
   return json({ error: "Not found", path: subPath }, { status: 404 });

package/src/docs/mock-api/urls.ts

@@ -7,5 +7,4 @@ export const DOCS_MOCK_REQRES_SERVICE = DOCS_MOCK_API_BASE;
 /** Remplace https://geo.api.gouv.fr/ — chemins `communes?…`. */
 export const DOCS_MOCK_GEO_SERVICE = `${DOCS_MOCK_API_BASE}/geo/`;
 
-/** Remplace https://v2.jokeapi.dev — chemins `joke/Any?…`. */
-export const DOCS_MOCK_JOKES_SERVICE = `${DOCS_MOCK_API_BASE}/jokes`;
+