@supersoniks/concorde 4.6.0 → 4.7.0

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

@@ -0,0 +1,234 @@
+import { handleApiConfigMockRequest } from "./api-config-mock";
+import {
+  DOCS_GEO_COMMUNES,
+  DOCS_REQRES_USERS,
+  buildJokeApiResponse,
+  filterDocsUsers,
+  type GeoCommuneRow,
+  type ReqresUserResponse,
+  type ReqresUsersListResponse,
+} from "./fixtures";
+
+export const DOCS_MOCK_API_PREFIX = "/docs-mock-api";
+
+function json(
+  body: unknown,
+  init: ResponseInit & { delayMs?: number } = {},
+): Promise<Response> {
+  const { delayMs = 0, ...responseInit } = init;
+  const headers = new Headers(responseInit.headers);
+  headers.set("Content-Type", "application/json; charset=utf-8");
+  headers.set("Access-Control-Allow-Origin", "*");
+  headers.set("X-Docs-Mock-Api", "concorde");
+
+  const build = () =>
+    new Response(JSON.stringify(body), { ...responseInit, headers });
+
+  if (delayMs <= 0) return Promise.resolve(build());
+  return new Promise((resolve) =>
+    setTimeout(() => resolve(build()), delayMs),
+  );
+}
+
+/**
+ * Liste utilisateurs type ReqRes.
+ * - `offset` + `per_page` / `limit` : pagination indexée (sonic-queue avec `$offset` / `$limit`)
+ * - `page` + `per_page` : numéro de page 1-based (sonic-fetch, ex. `?page=2`)
+ * - `q` : recherche sur prénom, nom, email (sonic-queue + `dataFilterProvider`, champ `name="q"`)
+ */
+export function paginateUsers(url: URL): ReqresUsersListResponse {
+  const perPage = Math.max(
+    1,
+    parseInt(
+      url.searchParams.get("per_page") ||
+        url.searchParams.get("limit") ||
+        "6",
+      10,
+    ),
+  );
+  const pool = filterDocsUsers(DOCS_REQRES_USERS, url.searchParams.get("q"));
+  const total = pool.length;
+
+  let start: number;
+  let page: number;
+
+  if (url.searchParams.has("offset")) {
+    start = Math.max(0, parseInt(url.searchParams.get("offset") || "0", 10));
+    page = Math.floor(start / perPage) + 1;
+  } else {
+    page = Math.max(1, parseInt(url.searchParams.get("page") || "1", 10));
+    start = (page - 1) * perPage;
+  }
+
+  const data = pool.slice(start, start + perPage);
+
+  return {
+    page,
+    per_page: perPage,
+    total,
+    total_pages: Math.max(1, Math.ceil(total / perPage)),
+    data,
+  };
+}
+
+async function parseRegisterFields(
+  request: Request,
+): Promise<{ email?: string; password?: string }> {
+  const contentType = (request.headers.get("content-type") || "").toLowerCase();
+
+  if (contentType.includes("multipart/form-data")) {
+    const fd = await request.formData();
+    return {
+      email: String(fd.get("email") ?? ""),
+      password: String(fd.get("password") ?? ""),
+    };
+  }
+
+  if (contentType.includes("application/x-www-form-urlencoded")) {
+    const text = await request.text();
+    const params = new URLSearchParams(text);
+    return {
+      email: params.get("email") ?? "",
+      password: params.get("password") ?? "",
+    };
+  }
+
+  const text = await request.text();
+  if (!text.trim()) return {};
+
+  try {
+    const parsed = JSON.parse(text) as { email?: unknown; password?: unknown };
+    return {
+      email: parsed.email != null ? String(parsed.email) : "",
+      password: parsed.password != null ? String(parsed.password) : "",
+    };
+  } catch {
+    const params = new URLSearchParams(text);
+    if (params.has("email") || params.has("password")) {
+      return {
+        email: params.get("email") ?? "",
+        password: params.get("password") ?? "",
+      };
+    }
+    return {};
+  }
+}
+
+function registerOkBody(
+  fields: { email: string; password: string },
+  nested = false,
+) {
+  const payload = {
+    id: 4,
+    token: "docs-mock-register-token",
+    email: fields.email,
+  };
+  return nested ? { data: payload } : payload;
+}
+
+function geoCommunes(url: URL): GeoCommuneRow[] {
+  const limit = Math.max(
+    1,
+    parseInt(url.searchParams.get("limit") || "5", 10),
+  );
+  const offset = Math.max(0, parseInt(url.searchParams.get("offset") || "0", 10));
+  return DOCS_GEO_COMMUNES.slice(offset, offset + limit);
+}
+
+/**
+ * Intercepte les requêtes vers /docs-mock-api/* (Service Worker ou middleware Vite).
+ */
+export async function handleDocsMockApiRequest(
+  request: Request,
+): Promise<Response | null> {
+  const url = new URL(request.url);
+  if (!url.pathname.startsWith(DOCS_MOCK_API_PREFIX)) return null;
+
+  const subPath = url.pathname.slice(DOCS_MOCK_API_PREFIX.length) || "/";
+  const method = request.method.toUpperCase();
+
+  if (subPath === "/health") {
+    return json({ ok: true, service: "concorde-docs-mock-api" });
+  }
+
+  const apiConfigResponse = handleApiConfigMockRequest(request, subPath, method);
+  if (apiConfigResponse) return apiConfigResponse;
+
+  if (
+    (subPath === "/api/register" || subPath === "/api/register/nested") &&
+    method === "POST"
+  ) {
+    const body = await parseRegisterFields(request);
+    if (!body.email?.trim() || !body.password?.trim()) {
+      return json(
+        {
+          messages: [
+            {
+              content: "email and password are required",
+              status: "error",
+            },
+          ],
+        },
+        { status: 400 },
+      );
+    }
+    return json(
+      registerOkBody(
+        { email: body.email!.trim(), password: body.password!.trim() },
+        subPath === "/api/register/nested",
+      ),
+    );
+  }
+
+  if (subPath === "/api/register/echo" && method === "GET") {
+    const email = url.searchParams.get("email") ?? "";
+    const password = url.searchParams.get("password") ?? "";
+    if (!email.trim() || !password.trim()) {
+      return json(
+        {
+          messages: [
+            {
+              content: "email and password query params are required",
+              status: "error",
+            },
+          ],
+        },
+        { status: 400 },
+      );
+    }
+    return json({
+      method: "GET",
+      query: { email, password },
+      email,
+      note: "sonic-submit method=\"get\" appends form fields to the endpoint URL",
+    });
+  }
+
+  if (method !== "GET") {
+    return json({ error: "Method not allowed" }, { status: 405 });
+  }
+
+  const userMatch = subPath.match(/^\/api\/users\/(\d+)$/);
+  if (userMatch) {
+    const id = parseInt(userMatch[1], 10);
+    const user =
+      DOCS_REQRES_USERS.find((u) => u.id === id) ?? DOCS_REQRES_USERS[0];
+    const body: ReqresUserResponse = { data: { ...user, id } };
+    return json(body);
+  }
+
+  if (subPath === "/api/users") {
+    return json(paginateUsers(url));
+  }
+
+  if (subPath === "/geo/communes" || subPath.startsWith("/geo/communes")) {
+    return json(geoCommunes(url));
+  }
+
+  const jokeMatch = subPath.match(/^\/jokes\/joke\/([^/]+)$/);
+  if (jokeMatch) {
+    return json(buildJokeApiResponse(url));
+  }
+
+  return json({ error: "Not found", path: subPath }, { status: 404 });
+}

package/src/docs/mock-api/service-worker.ts

@@ -0,0 +1,23 @@
+/// <reference lib="webworker" />
+import { handleDocsMockApiRequest} from "./router";
+
+declare const self: ServiceWorkerGlobalScope;
+
+self.addEventListener("install", (event) => {
+  event.waitUntil(self.skipWaiting());
+});
+
+self.addEventListener("activate", (event) => {
+  event.waitUntil(self.clients.claim());
+});
+
+self.addEventListener("fetch", (event) => {
+  const {request} = event;
+  event.respondWith(
+    (async () => {
+      const mocked = await handleDocsMockApiRequest(request);
+      if (mocked) return mocked;
+      return fetch(request);
+    })(),
+  );
+});

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

@@ -0,0 +1,11 @@
+/** Base same-origin pour les démos doc (Service Worker + middleware Vite). */
+export const DOCS_MOCK_API_BASE = "/docs-mock-api";
+
+/** Remplace https://reqres.in — chemins `api/users`, `api/users/2`, etc. */
+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`;

package/src/docs/navigation/navigation.ts

@@ -11,22 +11,25 @@ export class DocsNavigation extends LitElement {
       href: "#docs/_getting-started/concorde-outside.md/concorde-outside",
     },
     {
-      label: "My first subscriber",
-      href: "#docs/_getting-started/my-first-subscriber.md/my-first-subscriber",
+      label: "AI agents (skills)",
+      href: "#docs/_getting-started/ai-agents.md/ai-agents",
+    },
+    {
+      label: "My first component",
+      href: "#docs/_getting-started/my-first-component.md/my-first-component",
     },
     {
       label: "Adding styles",
       href: "#docs/_getting-started/theming.md/theming",
     },
-    { label: "Sharing data", href: "#docs/_getting-started/pubsub.md/pubsub" },
     "Core concept",
     {
       label: "Lit + Tailwind + Vite",
       href: "#docs/_core-concept/overview.md/overview",
     },
     {
-      label: "The subscriber mixin",
-      href: "#docs/_core-concept/subscriber.md/subscriber",
+      label: "Data flow",
+      href: "#docs/_core-concept/dataFlow.md/dataFlow",
     },
     "Functionnal components",
     { label: "Date", href: "#core/components/functional/date/date.md/date" },
@@ -172,8 +175,37 @@ export class DocsNavigation extends LitElement {
       href: "#docs/_misc/endpoint.md/endpoint",
     },
     {
-      label: "Templates Demo",
-      href: "#docs/_misc/templates-demo.md/templates-demo",
+      label: "API configuration",
+      href: "#docs/_misc/api-configuration.md/api-configuration",
+    },
+    {
+      label: "sub()",
+      href: "#docs/_directives/sub.md/sub",
+    },
+    {
+      label: "HTML integration",
+      href: "#docs/_misc/html-integration.md/html-integration",
+    },
+    {
+      label: "Local API demos",
+      href: "#docs/_misc/docs-mock-api.md/docs-mock-api",
+    },
+    "Legacy",
+    {
+      label: "Manual installation (Vite)",
+      href: "#docs/_getting-started/concorde-manual-install.md/concorde-manual-install",
+    },
+    {
+      label: "Subscriber mixin",
+      href: "#docs/_core-concept/subscriber.md/subscriber",
+    },
+    {
+      label: "Sharing data (Publisher)",
+      href: "#docs/_getting-started/pubsub.md/pubsub",
+    },
+    {
+      label: "My first subscriber",
+      href: "#docs/_getting-started/my-first-subscriber.md/my-first-subscriber",
     },
   ];