@nifrajs/cli 4.0.0 → 5.0.0

package/src/verification-plan.ts

@@ -178,12 +178,32 @@ const GATES = Object.freeze([
     [["run", "check:verification-parity"]],
     "Run `bun run check:verification-parity` and reconcile the release plan with CI.",
   ),
+  gate(
+    "server-components-contracts",
+    [["run", "check:server-components:contracts"]],
+    "Run `bun run check:server-components:contracts` and fix the component admission, transport or lifecycle regression.",
+  ),
+  gate(
+    "server-components",
+    [
+      ["run", "check:server-components"],
+      ["run", "check:server-components:consumers"],
+    ],
+    "Run the server-components matrix and packaged-consumer commands; every adapter and required row must pass.",
+  ),
+  gate(
+    "server-components-performance",
+    [["run", "check:server-components:performance"]],
+    "Run the five-run component performance comparison and investigate the measured regression.",
+    { workflowRequired: false },
+  ),
 ])
 
 const DEFAULT_PLAN = Object.freeze([
   "lint",
   "typecheck",
   "tests",
+  "server-components-contracts",
   "docs",
   "api-corpus",
   "cards-corpus",
@@ -204,6 +224,7 @@ const RELEASE_PLAN = Object.freeze([
   "cli-isolation",
   "coverage",
   "corpus",
+  "sitemap",
   "docs",
   "public-boundary",
   "public-manifest",
@@ -222,6 +243,9 @@ const RELEASE_PLAN = Object.freeze([
   "pipeline-parity",
   "leak-matrix",
   "verification-parity",
+  "server-components",
+  "server-components-performance",
+  "server-components-contracts",
   "changesets",
 ] as const)
 

package/src/version-drift.ts

@@ -0,0 +1,67 @@
+import {
+  compareSemverSpec,
+  groupPinVersions,
+  installedGroupPackages,
+  type LinkedGroupInstall,
+} from "./upgrade.ts"
+
+/** One version of the fixed release group, and where the workspace carries it. */
+export interface GroupVersion {
+  readonly version: string
+  readonly sources: readonly string[]
+}
+
+/**
+ * More than one version of the fixed release group (`@nifrajs/*`, `nifra`, `create-nifra`) in one
+ * workspace. Read only: package.json pins, installed packages (followed to their real location, so a
+ * linked repo reports its own version) and the running CLI. Nothing is spawned.
+ */
+export interface VersionDrift {
+  /** Oldest first. */
+  readonly versions: readonly GroupVersion[]
+  readonly highest: string
+  /** `nifra upgrade` edits the workspace only; these are listed, never edited. */
+  readonly linkedOutside: readonly LinkedGroupInstall[]
+}
+
+export function collectVersionDrift(cwd: string, cliVersion?: string): VersionDrift | undefined {
+  const sources = new Map<string, string[]>()
+  const add = (version: string, source: string): void => {
+    const list = sources.get(version) ?? []
+    list.push(source)
+    sources.set(version, list)
+  }
+  for (const [version, files] of groupPinVersions(cwd)) {
+    for (const file of files) add(version, `pinned in ${file}`)
+  }
+  const linkedOutside: LinkedGroupInstall[] = []
+  for (const { package: name, path, version, inside } of installedGroupPackages(cwd)) {
+    add(version, `installed ${name}${inside ? "" : ` (linked from ${path})`}`)
+    if (!inside) linkedOutside.push({ package: name, path, version })
+  }
+  if (cliVersion !== undefined) add(cliVersion, "the running nifra CLI")
+  if (sources.size < 2) return undefined
+  const versions = [...sources]
+    .sort(([a], [b]) => compareSemverSpec(a, b))
+    .map(([version, list]) => ({ version, sources: list }))
+  return {
+    versions,
+    highest: versions[versions.length - 1]!.version,
+    linkedOutside,
+  }
+}
+
+/** The advisory both `nifra doctor` and `nifra check` print. */
+export function versionDriftMessage(drift: VersionDrift): string {
+  const listed = drift.versions
+    .map(
+      ({ version, sources }) =>
+        `${version} (${sources.slice(0, 3).join("; ")}${sources.length > 3 ? `; and ${sources.length - 3} more` : ""})`,
+    )
+    .join(", ")
+  const linked =
+    drift.linkedOutside.length === 0
+      ? ""
+      : ` It does not edit ${drift.linkedOutside.map((entry) => `${entry.package} ${entry.version} at ${entry.path}`).join(", ")}, linked from outside the workspace root; upgrade that repository on its own.`
+  return `mixed nifra versions in this workspace: ${listed}. Run \`nifra upgrade ${drift.highest}\` (it runs each release's migration steps, then re-pins).${linked}`
+}

package/src/web-app-options.ts

@@ -11,7 +11,7 @@ import { FRAMEWORK_WEB_OPTIONS, type FrameworkWebOption, type NifraFramework } f
 
 type FrameworkWebAppOptions = Pick<
   CreateWebAppOptions,
-  "use" | "api" | "apiPrefix" | "apiStrip" | "mounts" | "csp" | "nonce"
+  "use" | "api" | "apiPrefix" | "apiStrip" | "mounts" | "csp" | "nonce" | "serverComponents"
 >
 
 /** `use`, the backend as `api`, and every forwarded framework field the config sets. */
@@ -39,7 +39,7 @@ export function frameworkMountPaths(fw: NifraFramework, hasBackend: boolean): st
   for (const mount of fw.mounts ?? []) {
     if (typeof mount?.path === "string") paths.push(mount.path)
   }
-  const apiPrefix = fw.apiPrefix ?? "/api"
+  const apiPrefix = fw.apiPrefix ?? ""
   if (hasBackend && apiPrefix !== "") paths.push(apiPrefix)
   return paths
 }

package/src/work-graph.ts

@@ -251,16 +251,15 @@ export async function buildWorkGraph(input: WorkGraphBuildInput): Promise<WorkGr
   const files = input.files ?? []
   const nodes = new Map<string, WorkGraphNode>()
   const edges: WorkGraphEdge[] = []
+  const edgeKeys = new Set<string>()
   const addNode = (node: WorkGraphNode): void => {
     if (!nodes.has(node.id)) nodes.set(node.id, node)
   }
   const addEdge = (edge: WorkGraphEdge): void => {
-    if (
-      !edges.some(
-        (item) => item.from === edge.from && item.to === edge.to && item.relation === edge.relation,
-      )
-    )
-      edges.push(edge)
+    const key = `${edge.from}\n${edge.to}\n${edge.relation}`
+    if (edgeKeys.has(key)) return
+    edgeKeys.add(key)
+    edges.push(edge)
   }
   for (const file of files) {
     const kind =
@@ -381,14 +380,20 @@ export function queryImpact(graph: WorkGraph, changedFiles: readonly string[]):
   // Any backend or shared module can reach every handler through backend/app.ts.
   if (unmodeled.length > 0 || normalized.some((file) => BACKEND_SOURCE_DIR.test(file)))
     for (const node of graph.nodes) if (node.kind === "route") seeds.add(node.id)
+  const targets = new Map<string, string[]>()
+  for (const edge of graph.edges) {
+    const from = targets.get(edge.from)
+    if (from === undefined) targets.set(edge.from, [edge.to])
+    else from.push(edge.to)
+  }
   const impacted = new Set(seeds)
   const queue = [...seeds]
-  while (queue.length > 0) {
-    const current = queue.shift()!
-    for (const edge of graph.edges) {
-      if (edge.from !== current || impacted.has(edge.to)) continue
-      impacted.add(edge.to)
-      queue.push(edge.to)
+  // Iterating an array visits what is pushed onto it meanwhile, so this is the breadth-first walk.
+  for (const current of queue) {
+    for (const to of targets.get(current) ?? []) {
+      if (impacted.has(to)) continue
+      impacted.add(to)
+      queue.push(to)
     }
   }
   const impactedRoutes = graph.nodes