feat(housekeeping): dispatch canonical domain routes

src/features/housekeeping/foundation/routing/match-route.test.ts

@@ -0,0 +1,125 @@
+import { describe, expect, it } from "vitest";
+import { PERMS } from "@/lib/permission-slugs";
+import {
+	anyCapability,
+	type CanonicalHousekeepingHref,
+	type HousekeepingDomainManifest,
+} from "../contracts";
+import { createHousekeepingRegistry } from "../registry";
+import { matchHousekeepingRoute } from "./match-route";
+
+const requirement = anyCapability(PERMS.USERS_VIEW);
+
+function peopleManifest(
+	routes: HousekeepingDomainManifest["routes"],
+): HousekeepingDomainManifest {
+	return {
+		id: "people",
+		labelKey: "pages.housekeeping.domains.people.title",
+		descriptionKey: "pages.housekeeping.domains.people.description",
+		iconId: "users",
+		canonicalHref: "/ase/people",
+		capability: requirement,
+		routes,
+		searchProviders: [],
+		inboxSources: [],
+		widgets: [],
+	};
+}
+
+function route(
+	id: string,
+	href: CanonicalHousekeepingHref,
+): HousekeepingDomainManifest["routes"][number] {
+	return {
+		id,
+		labelKey: `pages.housekeeping.routes.${id}`,
+		href,
+		capability: requirement,
+	};
+}
+
+const registry = createHousekeepingRegistry([
+	peopleManifest([
+		route("people.user-detail", "/ase/people/users/:id"),
+		route("people.user-create", "/ase/people/users/new"),
+		route("people.users", "/ase/people/users"),
+		route("people.ticket-note", "/ase/people/tickets/:ticketId/notes/:noteId"),
+		route("people.literal-tool", "/ase/people/tools/a+b[1]"),
+	]),
+]);
+
+describe("matchHousekeepingRoute", () => {
+	it("matches a static route without parameters", () => {
+		expect(matchHousekeepingRoute(registry, "/ase/people/users")).toEqual({
+			routeId: "people.users",
+			domain: "people",
+			params: {},
+			canonicalHref: "/ase/people/users",
+		});
+	});
+
+	it("prefers a static route over a dynamic route with the same depth", () => {
+		expect(matchHousekeepingRoute(registry, "/ase/people/users/new")).toEqual({
+			routeId: "people.user-create",
+			domain: "people",
+			params: {},
+			canonicalHref: "/ase/people/users/new",
+		});
+	});
+
+	it("matches a dynamic segment and decodes its parameter", () => {
+		expect(
+			matchHousekeepingRoute(registry, "/ase/people/users/Ada%20Lovelace"),
+		).toEqual({
+			routeId: "people.user-detail",
+			domain: "people",
+			params: { id: "Ada Lovelace" },
+			canonicalHref: "/ase/people/users/Ada%20Lovelace",
+		});
+	});
+
+	it("matches nested dynamic segments independently", () => {
+		expect(
+			matchHousekeepingRoute(
+				registry,
+				"/ase/people/tickets/42/notes/follow-up",
+			),
+		).toEqual({
+			routeId: "people.ticket-note",
+			domain: "people",
+			params: { ticketId: "42", noteId: "follow-up" },
+			canonicalHref: "/ase/people/tickets/42/notes/follow-up",
+		});
+	});
+
+	it("treats regular-expression metacharacters as literal segment text", () => {
+		expect(
+			matchHousekeepingRoute(registry, "/ase/people/tools/a+b[1]"),
+		)?.toMatchObject({ routeId: "people.literal-tool" });
+		expect(
+			matchHousekeepingRoute(registry, "/ase/people/tools/ab1"),
+		).toBeNull();
+	});
+
+	it.each([
+		"/ase/people/unknown",
+		"/ase/economy/users",
+		"/ase/system/users/Ada",
+	])("returns null for unknown or cross-domain path %s", (path) => {
+		expect(matchHousekeepingRoute(registry, path)).toBeNull();
+	});
+
+	it.each([
+		"ase/people/users",
+		"/ase//people/users",
+		"/ase/people/users/",
+		"/ase/people/users?tab=active",
+		"/ase/people/users/%",
+		"/ase/people/users/%2Fsystem",
+		"/ase/people/users/..",
+		"/ase\\people\\users",
+	])("fails closed for malformed canonical path %s", (path) => {
+		expect(matchHousekeepingRoute(registry, path)).toBeNull();
+	});
+});