adilallo
126 lines
3.9 KiB
TypeScript
126 lines
3.9 KiB
TypeScript
import { NextResponse, type NextRequest } from "next/server";
|
|
import { isDatabaseConfigured } from "../../../../lib/server/env";
|
|
import {
|
|
listCatalogCoreValues,
|
|
listCatalogMethods,
|
|
type CatalogCoreValueDto,
|
|
type CatalogMethodDto,
|
|
} from "../../../../lib/server/governanceCatalog";
|
|
import { listMethodRecommendations } from "../../../../lib/server/methodRecommendations";
|
|
import { apiRoute } from "../../../../lib/server/apiRoute";
|
|
import { dbUnavailable, errorJson } from "../../../../lib/server/responses";
|
|
import { CATALOG_SECTION_IDS } from "../../../../lib/create/customRuleFacets";
|
|
import {
|
|
type CatalogSectionId,
|
|
type SectionId,
|
|
flattenRequestedFacets,
|
|
parseRequestedFacetsFromSearchParams,
|
|
} from "../../../../lib/server/validation/methodFacetsSchemas";
|
|
|
|
const CATALOG_SECTION_SET = new Set<string>(CATALOG_SECTION_IDS);
|
|
const CATALOG_CACHE_CONTROL = "public, max-age=3600";
|
|
|
|
/** Route query alias → canonical `coreValues`. */
|
|
function normalizeSectionParam(raw: string): string {
|
|
return raw === "values" ? "coreValues" : raw;
|
|
}
|
|
|
|
type MethodMatch = { score: number; matchedFacets: string[] };
|
|
|
|
function rankCatalogMethods(
|
|
catalog: CatalogMethodDto[],
|
|
matchesBySlug: Record<string, MethodMatch> | null,
|
|
includeMatches: boolean,
|
|
): Array<CatalogMethodDto & { matches?: MethodMatch }> {
|
|
if (!matchesBySlug || !includeMatches) {
|
|
return catalog;
|
|
}
|
|
|
|
const indexBySlug = new Map(catalog.map((m, i) => [m.slug, i]));
|
|
const sorted = [...catalog].sort((a, b) => {
|
|
const sa = matchesBySlug[a.slug]?.score ?? 0;
|
|
const sb = matchesBySlug[b.slug]?.score ?? 0;
|
|
if (sa !== sb) return sb - sa;
|
|
return (indexBySlug.get(a.slug) ?? 0) - (indexBySlug.get(b.slug) ?? 0);
|
|
});
|
|
|
|
return sorted.map((m) => ({
|
|
...m,
|
|
matches: matchesBySlug[m.slug] ?? { score: 0, matchedFacets: [] },
|
|
}));
|
|
}
|
|
|
|
/**
|
|
* GET /api/create-flow/methods?section=<section>[&facet.*=...]
|
|
*
|
|
* Returns the full built-in catalog for one facet: four method decks
|
|
* (with optional facet ranking) or all preset core values. Copy is
|
|
* included in v1 (English only).
|
|
*
|
|
* See `docs/guides/template-recommendation-matrix.md` §9.2 / §9.5 (CR-115).
|
|
*/
|
|
export const GET = apiRoute(
|
|
"createFlow.methods.get",
|
|
async (request: NextRequest) => {
|
|
if (!isDatabaseConfigured()) {
|
|
return dbUnavailable();
|
|
}
|
|
|
|
const sectionParam = request.nextUrl.searchParams.get("section");
|
|
if (!sectionParam) {
|
|
return errorJson(
|
|
"validation_error",
|
|
`Unknown section. Expected one of: ${CATALOG_SECTION_IDS.join(", ")} (alias: values → coreValues)`,
|
|
400,
|
|
);
|
|
}
|
|
|
|
const normalized = normalizeSectionParam(sectionParam);
|
|
if (!CATALOG_SECTION_SET.has(normalized)) {
|
|
return errorJson(
|
|
"validation_error",
|
|
`Unknown section. Expected one of: ${CATALOG_SECTION_IDS.join(", ")} (alias: values → coreValues)`,
|
|
400,
|
|
);
|
|
}
|
|
const section = normalized as CatalogSectionId;
|
|
|
|
if (section === "coreValues") {
|
|
const methods: CatalogCoreValueDto[] = listCatalogCoreValues();
|
|
return NextResponse.json(
|
|
{ section: "coreValues" as const, methods },
|
|
{ headers: { "Cache-Control": CATALOG_CACHE_CONTROL } },
|
|
);
|
|
}
|
|
|
|
const facets = parseRequestedFacetsFromSearchParams(
|
|
request.nextUrl.searchParams,
|
|
);
|
|
const catalog = listCatalogMethods(section as SectionId);
|
|
const facetSection = section as SectionId;
|
|
|
|
const ranking = await listMethodRecommendations({
|
|
section: facetSection,
|
|
facets,
|
|
});
|
|
|
|
const includeMatches = flattenRequestedFacets(facets).length > 0;
|
|
|
|
let matchesBySlug: Record<string, MethodMatch> | null = null;
|
|
if (includeMatches && ranking) {
|
|
matchesBySlug = ranking.matchesBySlug;
|
|
}
|
|
|
|
const methods = rankCatalogMethods(
|
|
catalog,
|
|
matchesBySlug,
|
|
includeMatches,
|
|
);
|
|
|
|
return NextResponse.json(
|
|
{ section, methods },
|
|
{ headers: { "Cache-Control": CATALOG_CACHE_CONTROL } },
|
|
);
|
|
},
|
|
);
|