Hard Gates

1import { canonicalizeRoute } from '../route-normalize.mjs';
2
3export const FLAGS_ENDPOINT = '/.well-known/vercel/flags';
4export const VERCEL_FLAGS_PACKAGES = [
5  '@vercel/flags',
6  '@vercel/flags/next',
7  '@vercel/flags/sveltekit',
8  '@vercel/flags/nuxt',
9];
10export const WORKFLOW_ENDPOINT_PREFIXES = [
11  '/.well-known/workflow',
12  '/api/.well-known/workflow',
13];
14
15export function applyHardGates(candidates, signals = {}) {
16  const allowed = [];
17  const gated = [];
18  for (const candidate of candidates) {
19    if (isFlagsEndpointCandidate(candidate)) {
20      gated.push({
21        ...candidate,
22        gatedReason: flagsEndpointReason(signals),
23      });
24      continue;
25    }
26    if (isWorkflowRuntimeEndpointCandidate(candidate)) {
27      gated.push({
28        ...candidate,
29        gatedReason: workflowEndpointReason(signals),
30      });
31      continue;
32    }
33    allowed.push(candidate);
34  }
35  return { allowed, gated };
36}
37
38export function isFlagsEndpointCandidate(candidate) {
39  if (!candidate || candidate.scope === 'account') return false;
40  const route = normalizeRoute(candidate.route);
41  return route === FLAGS_ENDPOINT;
42}
43
44export function isWorkflowRuntimeEndpointCandidate(candidate) {
45  if (!candidate || candidate.scope === 'account') return false;
46  const route = normalizeRoute(candidate.route);
47  if (!route) return false;
48  return WORKFLOW_ENDPOINT_PREFIXES.some((prefix) => (
49    route === prefix || route.startsWith(`${prefix}/`)
50  ));
51}
52
53function normalizeRoute(route) {
54  if (typeof route !== 'string') return null;
55  const normalized = canonicalizeRoute(route).replace(/\/+$/, '');
56  return normalized === '' ? '/' : normalized;
57}
58
59function flagsEndpointReason(signals) {
60  const packages = signals.stack?.vercelFlagsPackages;
61  if (Array.isArray(packages) && packages.length > 0) {
62    return `hardGated: ${FLAGS_ENDPOINT} is the Vercel Flags endpoint (${packages.join(', ')} detected), not an optimization target`;
63  }
64  return `hardGated: ${FLAGS_ENDPOINT} is the Vercel Flags endpoint, not an optimization target`;
65}
66
67function workflowEndpointReason(signals) {
68  const packages = signals.stack?.workflowPackages;
69  if (Array.isArray(packages) && packages.length > 0) {
70    return `hardGated: Vercel Workflow runtime endpoint (${packages.join(', ')} detected); long-running step/flow requests are expected orchestration, not an app-route optimization target`;
71  }
72  return 'hardGated: Vercel Workflow runtime endpoint; long-running step/flow requests are expected orchestration, not an app-route optimization target';
73}