@carlonicora/nextjs-jsonapi 5.3.0 → 5.5.0

package/src/features/administration/components/__tests__/AdminIndexContainer.spec.tsx

@@ -3,7 +3,7 @@ import { BookOpenIcon } from "lucide-react";
 import { beforeEach, describe, expect, it } from "vitest";
 import { configureJsonApi } from "../../../../client/config";
 import { configureI18n } from "../../../../i18n";
-import { AdminIndexGrid } from "../AdminIndexContainer";
+import { ADMIN_PLATFORM_SECTIONS, AdminIndexGrid } from "../AdminIndexContainer";
 import type { AdminGroup } from "../../data/admin-section.types";
 
 // next-intl is globally mocked in vitest.setup.ts with `t = (key) => key`, so
@@ -93,4 +93,64 @@ describe("AdminIndexGrid", () => {
     // RoundPageContainerTitle, so the grid must not repeat it.
     expect(screen.queryByText("administration.title")).not.toBeInTheDocument();
   });
+
+  describe("groups", () => {
+    const customGroups: AdminGroup[] = [
+      {
+        key: "customers",
+        labelKey: "administration.group.customers",
+        sections: [ADMIN_PLATFORM_SECTIONS.users, ADMIN_PLATFORM_SECTIONS.companies],
+      },
+      extraGroup,
+      {
+        key: "system",
+        labelKey: "administration.group.system",
+        sections: [ADMIN_PLATFORM_SECTIONS["ai-connections"], ADMIN_PLATFORM_SECTIONS.rbac],
+      },
+    ];
+
+    it("replaces the platform group and additionalGroups with exactly the given groups, in order", () => {
+      render(<AdminIndexGrid groups={customGroups} additionalGroups={[extraGroup]} />);
+
+      const headings = screen.getAllByRole("heading", { level: 3 }).map((h) => h.textContent);
+      expect(headings).toEqual([
+        "administration.group.customers",
+        "administration.group.documentation",
+        "administration.group.system",
+      ]);
+      expect(screen.queryByText("administration.group.platform")).not.toBeInTheDocument();
+      expect(screen.queryByTestId("admin-index-token-usage")).not.toBeInTheDocument();
+      expect(screen.getAllByTestId("admin-index-howtos")).toHaveLength(1);
+    });
+
+    it("renders sections in the order each group lists them", () => {
+      render(<AdminIndexGrid groups={customGroups} />);
+
+      const ids = screen.getAllByRole("link").map((link) => link.getAttribute("data-testid"));
+      expect(ids).toEqual([
+        "admin-index-users",
+        "admin-index-companies",
+        "admin-index-howtos",
+        "admin-index-ai-connections",
+        "admin-index-rbac",
+      ]);
+      expect(screen.getByTestId("admin-index-companies")).toHaveAttribute("href", "/administration/companies");
+    });
+
+    it("applies hiddenSections inside the given groups and skips a group left empty", () => {
+      render(
+        <AdminIndexGrid
+          groups={[
+            ...customGroups,
+            { key: "only-rbac", labelKey: "administration.group.only_rbac", sections: [ADMIN_PLATFORM_SECTIONS.rbac] },
+          ]}
+          hiddenSections={["rbac"]}
+        />,
+      );
+
+      expect(screen.queryByTestId("admin-index-rbac")).not.toBeInTheDocument();
+      expect(screen.getByTestId("admin-index-ai-connections")).toBeInTheDocument();
+      expect(screen.queryByText("administration.group.only_rbac")).not.toBeInTheDocument();
+    });
+  });
 });

package/src/features/administration/components/index.ts

@@ -1 +1,2 @@
-export { AdminIndexContainer, AdminIndexGrid } from "./AdminIndexContainer";
+export { ADMIN_PLATFORM_SECTIONS, AdminIndexContainer, AdminIndexGrid } from "./AdminIndexContainer";
+export type { PlatformSectionKey } from "./AdminIndexContainer";

package/src/features/administration/contexts/AdministrationContext.tsx

@@ -11,6 +11,14 @@ const AdministrationContext = createContext<AdministrationContextType | undefine
 
 type AdministrationProviderProps = {
   children: ReactNode;
+  /**
+   * The page's own name, already translated (the same label the sidebar and the
+   * administration index use for it). When given, the breadcrumb reads
+   * "Home > {section}" with no link (it is the current page) and the title bar
+   * shows it. A plain string so a Server Component page can pass an already translated label.
+   * Omitted, the breadcrumb is empty and the title is "Administration".
+   */
+  section?: string;
 };
 
 /**
@@ -26,13 +34,13 @@ type AdministrationProviderProps = {
  * Mirrors CommonProvider (contexts/CommonContext.tsx), which does the same job
  * for the ordinary application shell.
  */
-export const AdministrationProvider = ({ children }: AdministrationProviderProps) => {
+export const AdministrationProvider = ({ children, section }: AdministrationProviderProps) => {
   const t = useTranslations();
 
-  const breadcrumbs: BreadcrumbItemData[] = [];
+  const breadcrumbs: BreadcrumbItemData[] = section ? [{ name: section }] : [];
 
   return (
-    <SharedProvider value={{ breadcrumbs, title: { type: t(`administration.title`) } }}>
+    <SharedProvider value={{ breadcrumbs, title: { type: section ?? t(`administration.title`) } }}>
       <AdministrationContext.Provider value={{}}>{children}</AdministrationContext.Provider>
     </SharedProvider>
   );

package/src/features/administration/contexts/__tests__/AdministrationContext.spec.tsx

@@ -0,0 +1,40 @@
+import { render, screen } from "@testing-library/react";
+import { describe, expect, it } from "vitest";
+import { useSharedContext } from "../../../../contexts/SharedContext";
+import { AdministrationProvider } from "../AdministrationContext";
+
+// next-intl is globally mocked in vitest.setup.ts with `t = (key) => key`, so a
+// translated label renders as its own key.
+const SharedProbe = () => {
+  const { breadcrumbs, title } = useSharedContext();
+  return (
+    <>
+      <span data-testid="breadcrumbs">{JSON.stringify(breadcrumbs)}</span>
+      <span data-testid="title">{String(title.type)}</span>
+    </>
+  );
+};
+
+describe("AdministrationProvider", () => {
+  it("publishes an empty breadcrumb and the administration title when no section is given", () => {
+    render(
+      <AdministrationProvider>
+        <SharedProbe />
+      </AdministrationProvider>,
+    );
+
+    expect(screen.getByTestId("breadcrumbs")).toHaveTextContent("[]");
+    expect(screen.getByTestId("title")).toHaveTextContent("administration.title");
+  });
+
+  it("publishes the section as an unlinked breadcrumb and as the title", () => {
+    render(
+      <AdministrationProvider section="Calendars">
+        <SharedProbe />
+      </AdministrationProvider>,
+    );
+
+    expect(screen.getByTestId("breadcrumbs")).toHaveTextContent(JSON.stringify([{ name: "Calendars" }]));
+    expect(screen.getByTestId("title")).toHaveTextContent("Calendars");
+  });
+});

package/src/features/ai-connection/ai-connection.module.ts

@@ -1,3 +1,4 @@
+import { PlugZapIcon } from "lucide-react";
 import { ModuleFactory } from "../../permissions";
 import { AiConnection } from "./data";
 
@@ -11,4 +12,5 @@ export const AiConnectionModule = (factory: ModuleFactory) =>
     pageUrl: "/administration/ai-connections",
     model: AiConnection,
     moduleId: "7d3f2b8a-91c4-4e6d-a5f0-2c9b8e4d1a37",
+    icon: PlugZapIcon,
   });

package/src/features/ai-connection/contexts/AiConnectionsContext.tsx

@@ -3,18 +3,9 @@
 import { useTranslations } from "next-intl";
 import { createContext, ReactNode, useCallback, useContext, useEffect, useMemo, useState } from "react";
 import { SharedProvider } from "../../../contexts";
-import { usePageUrlGenerator } from "../../../hooks";
 import { BreadcrumbItemData } from "../../../interfaces";
 import { AiConnectionEnvDefaults, AiConnectionInterface, AiConnectionService, AiProviderRegistry } from "../data";
 
-/**
- * Route the breadcrumb links back to. Constant rather than a prop for the same
- * reason TOKEN_USAGE_ADMIN_PAGE_URL is
- * (features/tokenusage/contexts/TokenUsageAdminContext.tsx): the breadcrumb is
- * built here, not by the consuming app, and the path convention IS the contract.
- */
-export const AI_CONNECTIONS_ADMIN_PAGE_URL = "/administration/ai-connections";
-
 export interface AiConnectionsContextType {
   /** Every connection, both scopes — the cards filter per scope themselves. */
   connections: AiConnectionInterface[];
@@ -57,7 +48,6 @@ export type AiConnectionsProviderProps = {
  */
 export const AiConnectionsProvider = ({ children }: AiConnectionsProviderProps) => {
   const t = useTranslations();
-  const generateUrl = usePageUrlGenerator();
 
   const [connections, setConnections] = useState<AiConnectionInterface[]>([]);
   const [providerRegistry, setProviderRegistry] = useState<AiProviderRegistry>({});
@@ -94,12 +84,9 @@ export const AiConnectionsProvider = ({ children }: AiConnectionsProviderProps)
     [connections, providerRegistry, envDefaults, scopeCompanyId, refresh, isLoading],
   );
 
-  const breadcrumbs: BreadcrumbItemData[] = [
-    {
-      name: t("ai_connections.admin.title"),
-      href: generateUrl({ page: AI_CONNECTIONS_ADMIN_PAGE_URL }),
-    },
-  ];
+  // Unlinked: this provider only serves the AI-connections page, so the root is
+  // always the current page.
+  const breadcrumbs: BreadcrumbItemData[] = [{ name: t("ai_connections.admin.title") }];
 
   return (
     <SharedProvider value={{ breadcrumbs, title: { type: t("ai_connections.admin.title") } }}>

package/src/features/ai-connection/contexts/__tests__/AiConnectionsContext.spec.tsx

@@ -0,0 +1,33 @@
+import { render, screen, waitFor } from "@testing-library/react";
+import { describe, expect, it, vi } from "vitest";
+import { useSharedContext } from "../../../../contexts/SharedContext";
+import { AiConnectionService } from "../../data";
+import { AiConnectionsProvider } from "../AiConnectionsContext";
+
+vi.mock("../../data", () => ({
+  AiConnectionService: {
+    listConnections: vi.fn(async () => ({ connections: [], providerRegistry: {}, envDefaults: {} })),
+  },
+}));
+
+// next-intl is globally mocked in vitest.setup.ts with `t = (key) => key`, so a
+// translated label renders as its own key.
+function BreadcrumbProbe() {
+  const { breadcrumbs } = useSharedContext();
+  return <span data-testid="breadcrumbs">{JSON.stringify(breadcrumbs)}</span>;
+}
+
+describe("AiConnectionsContext", () => {
+  it("publishes the page as an unlinked breadcrumb, since it is the current page", async () => {
+    render(
+      <AiConnectionsProvider>
+        <BreadcrumbProbe />
+      </AiConnectionsProvider>,
+    );
+
+    await waitFor(() => expect(AiConnectionService.listConnections).toHaveBeenCalled());
+    expect(screen.getByTestId("breadcrumbs")).toHaveTextContent(
+      JSON.stringify([{ name: "ai_connections.admin.title" }]),
+    );
+  });
+});

package/src/features/analytics/__tests__/server-entry.spec.tsx

@@ -35,7 +35,8 @@ describe("analytics server entry", () => {
 
     expect(mocks.hasRole).toHaveBeenCalledWith("role-admin");
     expect(element.type).toBe(AnalyticsAdminPageContainer);
-    expect(element.props).toEqual({ pageUrl: "/admin/stats", sessionPageUrl: "/admin/stats/sessions" });
+    // `pageUrl` is deprecated and no longer forwarded: the dashboard breadcrumb is unlinked.
+    expect(element.props).toEqual({ sessionPageUrl: "/admin/stats/sessions" });
   });
 
   it("AnalyticsAdminPage redirects to `/` by default without the role", async () => {

package/src/features/analytics/analytics.modules.ts

@@ -1,3 +1,4 @@
+import { ChartNoAxesCombinedIcon } from "lucide-react";
 import { ModuleFactory, ModuleWithPermissions } from "../../permissions";
 import { AnalyticsBreakdown } from "./data/analytics-breakdown";
 import { AnalyticsEvent } from "./data/analytics-event";
@@ -22,9 +23,25 @@ import { AnalyticsTimeline } from "./data/analytics-timeline";
 export const analyticsModules = (factory: ModuleFactory) =>
   ({
     AnalyticsEvent: factory({ name: "analytics/events", model: AnalyticsEvent }),
-    AnalyticsSummary: factory({ name: "analytics/administration/summary", model: AnalyticsSummary }),
-    AnalyticsTimeline: factory({ name: "analytics/administration/timeline", model: AnalyticsTimeline }),
-    AnalyticsBreakdown: factory({ name: "analytics/administration/breakdown", model: AnalyticsBreakdown }),
-    AnalyticsSession: factory({ name: "analytics/administration/sessions", model: AnalyticsSession }),
-    AnalyticsPageView: factory({ name: "pageviews", model: AnalyticsPageView }),
+    AnalyticsSummary: factory({
+      name: "analytics/administration/summary",
+      model: AnalyticsSummary,
+      icon: ChartNoAxesCombinedIcon,
+    }),
+    AnalyticsTimeline: factory({
+      name: "analytics/administration/timeline",
+      model: AnalyticsTimeline,
+      icon: ChartNoAxesCombinedIcon,
+    }),
+    AnalyticsBreakdown: factory({
+      name: "analytics/administration/breakdown",
+      model: AnalyticsBreakdown,
+      icon: ChartNoAxesCombinedIcon,
+    }),
+    AnalyticsSession: factory({
+      name: "analytics/administration/sessions",
+      model: AnalyticsSession,
+      icon: ChartNoAxesCombinedIcon,
+    }),
+    AnalyticsPageView: factory({ name: "pageviews", model: AnalyticsPageView, icon: ChartNoAxesCombinedIcon }),
   }) satisfies Record<string, ModuleWithPermissions>;

package/src/features/analytics/components/AnalyticsAdminContainer.tsx

@@ -2,6 +2,7 @@
 
 import { useTranslations } from "next-intl";
 import { RoundPageContainer } from "../../../components";
+import { Modules } from "../../../core";
 import { Card, CardContent, CardHeader, CardTitle } from "../../../shadcnui";
 import { useAnalyticsAdmin } from "../contexts/AnalyticsAdminContext";
 import { AnalyticsAdminTiles } from "./AnalyticsAdminTiles";
@@ -33,7 +34,7 @@ export function AnalyticsAdminContainer() {
 
   if (error) {
     return (
-      <RoundPageContainer fullWidth forceHeader>
+      <RoundPageContainer module={Modules.AnalyticsSummary} fullWidth forceHeader>
         <div className="p-4">
           <Card>
             <CardContent>
@@ -47,10 +48,10 @@ export function AnalyticsAdminContainer() {
 
   // Loading renders nothing in the body: the title bar (with the filter bar) is
   // already mounted, so a spinner would only make the controls jump on arrival.
-  if (isLoading) return <RoundPageContainer fullWidth forceHeader />;
+  if (isLoading) return <RoundPageContainer module={Modules.AnalyticsSummary} fullWidth forceHeader />;
 
   return (
-    <RoundPageContainer fullWidth forceHeader>
+    <RoundPageContainer module={Modules.AnalyticsSummary} fullWidth forceHeader>
       <div className="flex w-full flex-col gap-4 p-4">
         <div className="flex flex-col gap-2">
           <AnalyticsAdminTiles summary={summary} />

package/src/features/analytics/components/AnalyticsAdminPageContainer.tsx

@@ -4,7 +4,10 @@ import { AnalyticsAdminProvider } from "../contexts/AnalyticsAdminContext";
 import { AnalyticsAdminContainer } from "./AnalyticsAdminContainer";
 
 type Props = {
-  /** Route the breadcrumb links back to. Defaults to the provider's default. */
+  /**
+   * @deprecated No longer read: the dashboard is the current page, so its
+   * breadcrumb is not linked. Kept so existing callers still compile.
+   */
   pageUrl?: string;
   /** Base route of the journey page each session row links to. */
   sessionPageUrl?: string;
@@ -16,9 +19,9 @@ type Props = {
  * the `RoundPageContainer`; the provider sits above it because it publishes the
  * filter bar into the title bar.
  */
-export function AnalyticsAdminPageContainer({ pageUrl, sessionPageUrl }: Props) {
+export function AnalyticsAdminPageContainer({ sessionPageUrl }: Props) {
   return (
-    <AnalyticsAdminProvider pageUrl={pageUrl} sessionPageUrl={sessionPageUrl}>
+    <AnalyticsAdminProvider sessionPageUrl={sessionPageUrl}>
       <AnalyticsAdminContainer />
     </AnalyticsAdminProvider>
   );

package/src/features/analytics/components/AnalyticsJourneyContainer.tsx

@@ -4,6 +4,7 @@ import { useLocale, useTranslations } from "next-intl";
 import { useEffect, useMemo, useState } from "react";
 import { DetailField, RoundPageContainer } from "../../../components";
 import { SharedProvider } from "../../../contexts";
+import { Modules } from "../../../core";
 import { usePageUrlGenerator } from "../../../hooks";
 import { BreadcrumbItemData } from "../../../interfaces";
 import {
@@ -125,7 +126,7 @@ export function AnalyticsJourneyContainer({ sessionId, pageUrl = ANALYTICS_ADMIN
   const renderBody = () => {
     if (error) {
       return (
-        <RoundPageContainer fullWidth forceHeader>
+        <RoundPageContainer module={Modules.AnalyticsSession} fullWidth forceHeader>
           <div className="p-4">
             <Card>
               <CardContent>
@@ -138,14 +139,14 @@ export function AnalyticsJourneyContainer({ sessionId, pageUrl = ANALYTICS_ADMIN
     }
 
     // Loading renders nothing in the body, as on the dashboard.
-    if (isLoading || !session) return <RoundPageContainer fullWidth forceHeader />;
+    if (isLoading || !session) return <RoundPageContainer module={Modules.AnalyticsSession} fullWidth forceHeader />;
 
     const source = [session.utmSource ?? session.referrerHost, session.utmMedium, session.utmCampaign]
       .filter(Boolean)
       .join(" / ");
 
     return (
-      <RoundPageContainer fullWidth forceHeader>
+      <RoundPageContainer module={Modules.AnalyticsSession} fullWidth forceHeader>
         <div className="flex w-full flex-col gap-4 p-4">
           <Card data-testid="analytics-journey-attribution">
             <CardContent className="flex flex-col gap-3">

package/src/features/analytics/components/__tests__/AnalyticsJourneyContainer.spec.tsx

@@ -22,6 +22,17 @@ vi.mock("../../../../components", async (importOriginal) => {
   };
 });
 
+// The container hands `Modules.AnalyticsSession` to the (mocked) page chrome for
+// its header icon; no app bootstrap registers modules here, so the registry
+// lookup would throw.
+vi.mock("../../../../core", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("../../../../core")>();
+  return {
+    ...actual,
+    Modules: new Proxy({}, { get: () => undefined }),
+  };
+});
+
 beforeAll(() => {
   configureI18n({
     useRouter: () => ({

package/src/features/analytics/components/__tests__/AnalyticsPageContainers.spec.tsx

@@ -27,6 +27,17 @@ vi.mock("../../../../components", async (importOriginal) => {
   };
 });
 
+// The containers pass Modules.AnalyticsSummary / AnalyticsSession for the
+// header icon; no app bootstrap registers modules here, so the registry lookup
+// would throw.
+vi.mock("../../../../core", async (importOriginal) => {
+  const actual = await importOriginal<typeof import("../../../../core")>();
+  return {
+    ...actual,
+    Modules: new Proxy({}, { get: () => undefined }),
+  };
+});
+
 beforeAll(() => {
   configureI18n({
     useRouter: () => ({
@@ -81,7 +92,7 @@ describe("AnalyticsAdminPageContainer", () => {
   });
 
   it("loads the dashboard and links each session under the given sessionPageUrl", async () => {
-    render(<AnalyticsAdminPageContainer pageUrl="/admin/stats" sessionPageUrl="/admin/stats/sessions" />);
+    render(<AnalyticsAdminPageContainer sessionPageUrl="/admin/stats/sessions" />);
 
     expect(await screen.findByTestId("analytics-session-link-s1")).toHaveAttribute("href", "/admin/stats/sessions/s1");
     expect(AnalyticsAdminService.getSummary).toHaveBeenCalledTimes(1);

package/src/features/analytics/components/server/AnalyticsAdminPage.tsx

@@ -10,7 +10,10 @@ import { ServerSession } from "../../../../server";
 type Props = {
   /** Role id the viewer must hold. The package has no role constants, so the host app passes its own. */
   adminRoleId: string;
-  /** Route the breadcrumb links back to. */
+  /**
+   * @deprecated No longer read: the dashboard is the current page, so its
+   * breadcrumb is not linked. Kept so existing callers still compile.
+   */
   pageUrl?: string;
   /** Base route of the journey page each session row links to. */
   sessionPageUrl?: string;
@@ -23,10 +26,10 @@ type Props = {
  *
  * Reads the session: render inside a `<Suspense>` boundary (Cache Components).
  */
-export async function AnalyticsAdminPage({ adminRoleId, pageUrl, sessionPageUrl, deniedRedirect = "/" }: Props) {
+export async function AnalyticsAdminPage({ adminRoleId, sessionPageUrl, deniedRedirect = "/" }: Props) {
   if (!(await ServerSession.hasRole(adminRoleId))) {
     redirect(deniedRedirect);
   }
 
-  return <AnalyticsAdminPageContainer pageUrl={pageUrl} sessionPageUrl={sessionPageUrl} />;
+  return <AnalyticsAdminPageContainer sessionPageUrl={sessionPageUrl} />;
 }

package/src/features/analytics/contexts/AnalyticsAdminContext.tsx

@@ -4,7 +4,6 @@ import { useTranslations } from "next-intl";
 import { createContext, ReactNode, useCallback, useContext, useEffect, useMemo, useState } from "react";
 import { Modules, NextRef } from "../../../core";
 import { SharedProvider } from "../../../contexts";
-import { usePageUrlGenerator } from "../../../hooks";
 import { BreadcrumbItemData } from "../../../interfaces";
 import { AnalyticsAdminFilterBar } from "../components/AnalyticsAdminFilterBar";
 import type { AnalyticsBreakdownInterface } from "../data/analytics-breakdown.interface";
@@ -19,13 +18,6 @@ import {
 } from "../data/analytics.types";
 import { AnalyticsAdminService } from "../data/AnalyticsAdminService";
 
-/**
- * Default route the breadcrumb links back to. A host app that mounts the page
- * elsewhere overrides it with the `pageUrl` prop — the constant stays here
- * because the breadcrumb is built by this provider, not by the app.
- */
-const ANALYTICS_ADMIN_PAGE_URL = "/administration/analytics";
-
 /** Default base route of the journey page each session row links to. */
 const ANALYTICS_SESSION_PAGE_URL = "/administration/analytics/sessions";
 
@@ -86,7 +78,11 @@ type AnalyticsAdminProviderProps = {
   initialFrom?: string;
   /** ISO 8601 instant. Defaults to now. */
   initialTo?: string;
-  /** Route the breadcrumb links back to. */
+  /**
+   * @deprecated No longer read. This provider only serves the dashboard, which
+   * is the current page, so its breadcrumb is not linked. Kept so existing
+   * callers still compile.
+   */
   pageUrl?: string;
   /** Base route of the journey page each session row links to. */
   sessionPageUrl?: string;
@@ -105,11 +101,9 @@ export const AnalyticsAdminProvider = ({
   children,
   initialFrom,
   initialTo,
-  pageUrl = ANALYTICS_ADMIN_PAGE_URL,
   sessionPageUrl = ANALYTICS_SESSION_PAGE_URL,
 }: AnalyticsAdminProviderProps) => {
   const t = useTranslations();
-  const generateUrl = usePageUrlGenerator();
 
   const [filters, setFilterState] = useState<AnalyticsAdminFilterState>(() => {
     const range = defaultRange();
@@ -205,12 +199,9 @@ export const AnalyticsAdminProvider = ({
     }
   }, [sessionsNextPage]);
 
-  const breadcrumb = (): BreadcrumbItemData[] => [
-    {
-      name: t("analytics.admin.title"),
-      href: generateUrl({ page: pageUrl }),
-    },
-  ];
+  // Unlinked: this provider only serves the dashboard, so the root is always
+  // the current page. The journey page publishes its own linked breadcrumb.
+  const breadcrumb = (): BreadcrumbItemData[] => [{ name: t("analytics.admin.title") }];
 
   const title = () => ({
     type: t("analytics.admin.title"),

package/src/features/analytics/contexts/__tests__/AnalyticsAdminContext.spec.tsx

@@ -1,5 +1,6 @@
 import { act, fireEvent, render, screen, waitFor } from "@testing-library/react";
 import { beforeEach, describe, expect, it, vi } from "vitest";
+import { useSharedContext } from "../../../../contexts/SharedContext";
 import { AnalyticsAdminService } from "../../data/AnalyticsAdminService";
 import { AnalyticsAdminProvider, useAnalyticsAdmin } from "../AnalyticsAdminContext";
 
@@ -40,6 +41,11 @@ function Probe() {
   );
 }
 
+function BreadcrumbProbe() {
+  const { breadcrumbs } = useSharedContext();
+  return <span data-testid="breadcrumbs">{JSON.stringify(breadcrumbs)}</span>;
+}
+
 describe("AnalyticsAdminContext", () => {
   // The mocked service is module-level, so its call counts survive across tests.
   beforeEach(() => {
@@ -137,4 +143,15 @@ describe("AnalyticsAdminContext", () => {
     );
     expect(screen.getByTestId("has-more")).toHaveTextContent("false");
   });
+
+  it("publishes the dashboard as an unlinked breadcrumb, since it is the current page", async () => {
+    render(
+      <AnalyticsAdminProvider>
+        <BreadcrumbProbe />
+      </AnalyticsAdminProvider>,
+    );
+
+    await waitFor(() => expect(AnalyticsAdminService.getSessions).toHaveBeenCalled());
+    expect(screen.getByTestId("breadcrumbs")).toHaveTextContent(JSON.stringify([{ name: "analytics.admin.title" }]));
+  });
 });

package/src/features/billing/stripe-price/stripe-price.module.ts

@@ -1,3 +1,4 @@
+import { CreditCardIcon } from "lucide-react";
 import { ModuleFactory } from "../../../permissions";
 import { StripePrice } from "./data/stripe-price";
 
@@ -11,4 +12,5 @@ export const StripePriceModule = (factory: ModuleFactory) =>
     pageUrl: "/administration/prices",
     model: StripePrice,
     moduleId: "a7d3e5f1-8c9b-4a2e-b6d7-3f1c8e9a4b5d",
+    icon: CreditCardIcon,
   });

package/src/features/billing/stripe-product/stripe-product.module.ts

@@ -1,3 +1,4 @@
+import { CreditCardIcon } from "lucide-react";
 import { ModuleFactory } from "../../../permissions";
 import { StripeProduct } from "./data";
 
@@ -11,4 +12,5 @@ export const StripeProductModule = (factory: ModuleFactory) =>
     pageUrl: "/administration/products",
     model: StripeProduct,
     moduleId: "f8c4a1e9-3b2d-4f7a-9e5c-1d8a6b3c9f2e",
+    icon: CreditCardIcon,
   });

package/src/features/blog/BlogModules.ts

@@ -0,0 +1,49 @@
+import { NewspaperIcon } from "lucide-react";
+import { ModuleFactory } from "../../permissions";
+import { BlogCategory } from "./data/BlogCategory";
+import { BlogCategoryTranslation } from "./data/BlogCategoryTranslation";
+import { BlogPost } from "./data/BlogPost";
+import { BlogPostTranslation } from "./data/BlogPostTranslation";
+import { BlogSettings } from "./data/BlogSettings";
+import { BLOG_MODULE_ID } from "./types/blog.constants";
+
+export const BlogPostModule = (factory: ModuleFactory) =>
+  factory({
+    moduleId: BLOG_MODULE_ID,
+    pageUrl: "/administration/blog",
+    name: "blog-posts",
+    model: BlogPost,
+    icon: NewspaperIcon,
+  });
+
+export const BlogPostTranslationModule = (factory: ModuleFactory) =>
+  factory({
+    moduleId: BLOG_MODULE_ID,
+    name: "blog-post-translations",
+    model: BlogPostTranslation,
+    icon: NewspaperIcon,
+  });
+
+export const BlogCategoryModule = (factory: ModuleFactory) =>
+  factory({
+    moduleId: BLOG_MODULE_ID,
+    name: "blog-categories",
+    model: BlogCategory,
+    icon: NewspaperIcon,
+  });
+
+export const BlogCategoryTranslationModule = (factory: ModuleFactory) =>
+  factory({
+    moduleId: BLOG_MODULE_ID,
+    name: "blog-category-translations",
+    model: BlogCategoryTranslation,
+    icon: NewspaperIcon,
+  });
+
+export const BlogSettingsModule = (factory: ModuleFactory) =>
+  factory({
+    moduleId: BLOG_MODULE_ID,
+    name: "blog-settings",
+    model: BlogSettings,
+    icon: NewspaperIcon,
+  });