openk8s 1.0.1 → 1.0.2

package/src/lib/k8s/resource-detail-builder.ts

@@ -1,66 +1,44 @@
-import type {
-  ResourceDetail,
-  ResourceDetailLine,
-  ResourceDetailSection,
-  ResourceKind,
-  ResourcePortForward,
-} from "./types";
-
-import {
-  asArray,
-  asBoolean,
-  asNumber,
-  asPort,
-  asRecord,
-  asString,
-  buildEnvLine,
-  extractContainerNames,
-  extractContainerPorts,
-  flattenSections,
-  formatContainerState,
-  formatEnvFromSource,
-  formatProbe,
-  formatValueFrom,
-  formatVolumeSource,
-  isPodKind,
-  normalizeKind,
-  suggestedLocalPort,
-  summarizeIngressHosts,
-  summarizeLabels,
-  supportsDirectPortForward,
-  type KubernetesMetadata,
-  type KubernetesResource,
-} from "./resource-parser";
+import type { ResourceDetail, ResourceKind } from "./types";
+import { isPodKind } from "./resource-parser";
+import type { KubernetesResource, KubernetesMetadata } from "./resource-parser";
 
 export { type KubernetesMetadata, type KubernetesResource } from "./resource-parser";
 
+import { buildOverviewSection, buildPortForward } from "./detail-builders/overview-builder";
+import { buildPodSections } from "./detail-builders/pod-builder";
+import { buildHpaSections, buildCronJobSections } from "./detail-builders/hpa-cronjob-builder";
+import { buildNodeSections } from "./detail-builders/node-builder";
+import { buildEventSections } from "./detail-builders/event-builder";
+import { buildRoleSections, buildRoleBindingSections, buildServiceAccountSections } from "./detail-builders/rbac-builder";
+import { flattenSections, extractContainerNames } from "./resource-parser";
+
 export function buildResourceDetail(options: BuildResourceDetailOptions): ResourceDetail {
   const kindName = options.resource.kind ?? options.resourceKind?.name ?? "unknown";
   const normalizedKind = kindName.trim().toLowerCase();
-  const overview = buildOverviewSection({ resource: options.resource, resourceKind: options.resourceKind });
+  const overview = buildOverviewSection(options.resourceKind, options.resource);
 
-  let additionalSections: ResourceDetailSection[] = [];
+  let additionalSections: ReturnType<typeof buildPodSections> = [];
 
   if (isPodKind(kindName)) {
-    additionalSections = buildPodSections({ resource: options.resource });
+    additionalSections = buildPodSections(options.resource);
   } else if (normalizedKind === "horizontalpodautoscaler") {
-    additionalSections = buildHpaSections({ resource: options.resource });
+    additionalSections = buildHpaSections(options.resource);
   } else if (normalizedKind === "cronjob") {
-    additionalSections = buildCronJobSections({ resource: options.resource });
+    additionalSections = buildCronJobSections(options.resource);
   } else if (normalizedKind === "node") {
-    additionalSections = buildNodeSections({ resource: options.resource });
+    additionalSections = buildNodeSections(options.resource);
   } else if (normalizedKind === "event" || normalizedKind === "events") {
-    additionalSections = buildEventSections({ resource: options.resource });
+    additionalSections = buildEventSections(options.resource);
   } else if (normalizedKind === "role" || normalizedKind === "clusterrole") {
-    additionalSections = buildRoleSections({ resource: options.resource });
+    additionalSections = buildRoleSections(options.resource);
   } else if (normalizedKind === "rolebinding" || normalizedKind === "clusterrolebinding") {
-    additionalSections = buildRoleBindingSections({ resource: options.resource });
+    additionalSections = buildRoleBindingSections(options.resource);
   } else if (normalizedKind === "serviceaccount") {
-    additionalSections = buildServiceAccountSections({ resource: options.resource });
+    additionalSections = buildServiceAccountSections(options.resource);
   }
 
   const summarySections = [overview.section, ...additionalSections];
-  const portForward = buildPortForward({ resource: options.resource, resourceKind: options.resourceKind });
+  const portForward = buildPortForward(options.resourceKind, options.resource);
   const containers = isPodKind(kindName) ? extractContainerNames(options.resource.spec) : undefined;
 
   return {
@@ -85,461 +63,3 @@ export interface BuildResourceDetailOptions {
   yaml: string;
   describe?: string | undefined;
 }
-
-interface BuildOverviewSectionOptions {
-  resourceKind?: ResourceKind | undefined;
-  resource: KubernetesResource;
-}
-
-interface BuildPodSectionsOptions {
-  resource: KubernetesResource;
-}
-
-interface BuildPortForwardOptions {
-  resourceKind?: ResourceKind | undefined;
-  resource: KubernetesResource;
-}
-
-function buildPortForward(options: BuildPortForwardOptions): ResourcePortForward[] {
-  const kindName = options.resource.kind ?? options.resourceKind?.name ?? "unknown";
-
-  if (!supportsDirectPortForward(kindName)) {
-    return [];
-  }
-
-  const spec = options.resource.spec ?? {};
-  let remotePorts: number[];
-
-  if (["service", "services"].includes(normalizeKind(kindName))) {
-    remotePorts = asArray(spec.ports)
-      .map((port) => asPort(asRecord(port)?.port))
-      .filter((port): port is number => port !== undefined);
-  } else if (isPodKind(kindName)) {
-    remotePorts = extractContainerPorts(spec);
-  } else {
-    remotePorts = extractContainerPorts(asRecord(spec.template)?.spec);
-  }
-
-  return remotePorts.map((remotePort) => ({
-    localPort: suggestedLocalPort(remotePort),
-    remotePort,
-  }));
-}
-
-function buildOverviewSection(options: BuildOverviewSectionOptions): { section: ResourceDetailSection; replicas?: number | undefined } {
-  const metadata = options.resource.metadata ?? {};
-  const status = options.resource.status ?? {};
-  const spec = options.resource.spec ?? {};
-
-  const lines = [
-    `kind: ${options.resource.kind ?? options.resourceKind?.name ?? "unknown"}`,
-    `apiVersion: ${options.resource.apiVersion ?? "unknown"}`,
-    `name: ${metadata.name ?? "unknown"}`,
-    `namespace: ${metadata.namespace ?? (options.resourceKind?.namespaced ? "default" : "cluster")}`,
-    `created: ${metadata.creationTimestamp ?? "unknown"}`,
-    `labels: ${summarizeLabels(metadata.labels)}`,
-  ];
-
-  const replicas = asNumber(spec.replicas);
-  if (replicas !== undefined) {
-    lines.push(`replicas: ${replicas}`);
-  }
-
-  const readyReplicas = asNumber(status.readyReplicas);
-  if (readyReplicas !== undefined) {
-    lines.push(`readyReplicas: ${readyReplicas}`);
-  }
-
-  const phase = asString(status.phase);
-  if (phase) {
-    lines.push(`phase: ${phase}`);
-  }
-
-  const qosClass = asString(status.qosClass);
-  if (qosClass) {
-    lines.push(`qos: ${qosClass}`);
-  }
-
-  const clusterIP = asString(spec.clusterIP);
-  if (clusterIP) {
-    lines.push(`clusterIP: ${clusterIP}`);
-  }
-
-  const nodeName = asString(spec.nodeName);
-  if (nodeName) {
-    lines.push(`node: ${nodeName}`);
-  }
-
-  const podIP = asString(status.podIP);
-  if (podIP) {
-    lines.push(`podIP: ${podIP}`);
-  }
-
-  const hostIP = asString(status.hostIP);
-  if (hostIP) {
-    lines.push(`hostIP: ${hostIP}`);
-  }
-
-  const serviceAccount = asString(spec.serviceAccountName);
-  if (serviceAccount) {
-    lines.push(`serviceAccount: ${serviceAccount}`);
-  }
-
-  const completions = asNumber(status.succeeded);
-  if (completions !== undefined) {
-    lines.push(`succeeded: ${completions}`);
-  }
-
-  const ingressHosts = summarizeIngressHosts(spec);
-  if (ingressHosts) {
-    lines.push(`hosts: ${ingressHosts}`);
-  }
-
-  return {
-    section: { title: "Overview", lines },
-    replicas,
-  };
-}
-
-function buildPodSections(options: BuildPodSectionsOptions): ResourceDetailSection[] {
-  const spec = options.resource.spec ?? {};
-  const status = options.resource.status ?? {};
-
-  const containerStatuses = new Map(
-    asArray(status.containerStatuses)
-      .map((entry) => asRecord(entry))
-      .filter((entry): entry is Record<string, unknown> => Boolean(entry && asString(entry.name)))
-      .map((entry) => [asString(entry.name) ?? "", entry]),
-  );
-
-  const containers = asArray(spec.containers)
-    .map((entry) => asRecord(entry))
-    .filter((entry): entry is Record<string, unknown> => entry !== undefined);
-
-  const containerLines = containers.map((container) => {
-    const name = asString(container.name) ?? "container";
-    const statusEntry = containerStatuses.get(name);
-    const ready = asBoolean(statusEntry?.ready);
-    const restartCount = asNumber(statusEntry?.restartCount);
-
-    return `${name}  image ${asString(container.image) ?? "-"}  ready ${ready === undefined ? "-" : ready ? "yes" : "no"}  restarts ${restartCount ?? 0}  state ${formatContainerState(statusEntry?.state)}`;
-  });
-
-  const environmentLines = containers.flatMap((container) => {
-    const containerName = asString(container.name) ?? "container";
-    const envLines = asArray(container.env)
-      .map((entry) => asRecord(entry))
-      .filter((entry): entry is Record<string, unknown> => entry !== undefined)
-      .map((entry, index) => {
-        const name = asString(entry.name) ?? "ENV";
-        const value = asString(entry.value);
-        const valueFrom = asRecord(entry.valueFrom);
-        const secretKeyRef = asRecord(valueFrom?.secretKeyRef);
-
-        if (secretKeyRef) {
-          const secretName = asString(secretKeyRef.name) ?? "unknown";
-          const secretKey = asString(secretKeyRef.key) ?? "key";
-          const secretRefText = `secret:${secretName}/${secretKey}`;
-          return buildEnvLine(
-            `${containerName}:env:${name}:${index}`,
-            `${name}=*****`,
-            `${name}=${secretRefText}`,
-            { name: secretName, key: secretKey },
-          );
-        }
-
-        return buildEnvLine(`${containerName}:env:${name}:${index}`, `${name}=${value ?? formatValueFrom(entry.valueFrom)}`);
-      });
-
-    const envFromLines = asArray(container.envFrom)
-      .map((entry) => asRecord(entry))
-      .filter((entry): entry is Record<string, unknown> => entry !== undefined)
-      .map((entry, index) => {
-        const secretRef = asRecord(entry.secretRef);
-
-        if (secretRef) {
-          const secretName = asString(secretRef.name) ?? "unknown";
-          // envFrom imports ALL keys from the referenced Secret as individual env vars
-          return buildEnvLine(
-            `${containerName}:envfrom:secret:${index}`,
-            `envFrom: secret/${secretName} → *****`,
-            `envFrom: secret/${secretName} (all keys imported)`,
-            { name: secretName },
-          );
-        }
-
-        return buildEnvLine(`${containerName}:envfrom:${index}`, `envFrom: ${formatEnvFromSource(entry)}`);
-      });
-
-    return [...envLines, ...envFromLines];
-  });
-
-  const portLines = containers.flatMap((container) => {
-    const containerName = asString(container.name) ?? "container";
-
-    return asArray(container.ports)
-      .map((entry) => asRecord(entry))
-      .filter((entry): entry is Record<string, unknown> => entry !== undefined)
-      .map((entry) => {
-        const port = entry.containerPort ?? "?";
-        const protocol = asString(entry.protocol) ?? "TCP";
-        const hostPort = entry.hostPort ? ` host ${entry.hostPort}` : "";
-        return `${containerName}: ${String(port)}/${protocol}${hostPort}`;
-      });
-  });
-
-  const mountLines = containers.flatMap((container) => {
-    const containerName = asString(container.name) ?? "container";
-
-    return asArray(container.volumeMounts)
-      .map((entry) => asRecord(entry))
-      .filter((entry): entry is Record<string, unknown> => entry !== undefined)
-      .map((entry) => {
-        const mountPath = asString(entry.mountPath) ?? "?";
-        const mountName = asString(entry.name) ?? "volume";
-        return `${containerName}: ${mountPath} <- ${mountName}${asBoolean(entry.readOnly) ? " (ro)" : ""}`;
-      });
-  });
-
-  const probeLines = containers.map((container) => {
-    const containerName = asString(container.name) ?? "container";
-    return `${containerName}: readiness ${formatProbe(container.readinessProbe)} | liveness ${formatProbe(container.livenessProbe)} | startup ${formatProbe(container.startupProbe)}`;
-  });
-
-  const conditionLines = asArray(status.conditions)
-    .map((entry) => asRecord(entry))
-    .filter((entry): entry is Record<string, unknown> => entry !== undefined)
-    .map((entry) => {
-      const type = asString(entry.type) ?? "Condition";
-      const conditionStatus = asString(entry.status) ?? "Unknown";
-      const transition = asString(entry.lastTransitionTime) ?? "unknown";
-      return `${type}: ${conditionStatus}  transitioned ${transition}`;
-    });
-
-  const volumeLines = asArray(spec.volumes)
-    .map((entry) => asRecord(entry))
-    .filter((entry): entry is Record<string, unknown> => entry !== undefined)
-    .map((entry) => `${asString(entry.name) ?? "volume"}: ${formatVolumeSource(entry)}`);
-
-  return [
-    { title: "Containers", lines: containerLines.length > 0 ? containerLines : ["No containers"] },
-    {
-      title: "Environment",
-      lines: environmentLines.length > 0 ? environmentLines : ["No environment variables or imports"],
-    },
-    { title: "Ports", lines: portLines.length > 0 ? portLines : ["No declared ports"] },
-    { title: "Volume Mounts", lines: mountLines.length > 0 ? mountLines : ["No volume mounts"] },
-    { title: "Probes", lines: probeLines.length > 0 ? probeLines : ["No probes configured"] },
-    { title: "Conditions", lines: conditionLines.length > 0 ? conditionLines : ["No conditions reported"] },
-    { title: "Volumes", lines: volumeLines.length > 0 ? volumeLines : ["No volumes"] },
-  ];
-}
-
-// ── Event sections ────────────────────────────────────────────────────────────
-
-interface BuildEventSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildEventSections(options: BuildEventSectionsOptions): ResourceDetailSection[] {
-  const raw = options.resource as unknown as Record<string, unknown>;
-  const involvedObject = (raw.involvedObject ?? {}) as Record<string, unknown>;
-  const source = (raw.source ?? {}) as Record<string, unknown>;
-
-  const lines = [
-    `type: ${String(raw.type ?? "-")}`,
-    `reason: ${String(raw.reason ?? "-")}`,
-    `message: ${String(raw.message ?? "-")}`,
-    `count: ${String(raw.count ?? "-")}`,
-    `firstTimestamp: ${String(raw.firstTimestamp ?? "-")}`,
-    `lastTimestamp: ${String(raw.lastTimestamp ?? "-")}`,
-    `source: ${String(source.component ?? raw.reportingComponent ?? "-")}`,
-    `involvedObject: ${String(involvedObject.kind ?? "-")}/${String(involvedObject.name ?? "-")}  ns: ${String(involvedObject.namespace ?? "-")}`,
-  ];
-
-  return [{ title: "Event", lines }];
-}
-
-// ── HPA sections ─────────────────────────────────────────────────────────────
-
-interface BuildHpaSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildHpaSections(options: BuildHpaSectionsOptions): ResourceDetailSection[] {
-  const spec = options.resource.spec ?? {};
-  const status = options.resource.status ?? {};
-
-  const scaleTargetRef = (spec.scaleTargetRef ?? {}) as Record<string, unknown>;
-  const lines = [
-    `scaleTargetRef: ${String(scaleTargetRef.kind ?? "-")}/${String(scaleTargetRef.name ?? "-")}`,
-    `minReplicas: ${String(spec.minReplicas ?? "-")}`,
-    `maxReplicas: ${String(spec.maxReplicas ?? "-")}`,
-    `currentReplicas: ${String(status.currentReplicas ?? "-")}`,
-    `desiredReplicas: ${String(status.desiredReplicas ?? "-")}`,
-  ];
-
-  const conditions = asArray(status.conditions)
-    .map((c) => asRecord(c))
-    .filter((c): c is Record<string, unknown> => c !== undefined)
-    .map((c) => `${asString(c.type) ?? "Condition"}: ${asString(c.status) ?? "-"} — ${asString(c.message) ?? ""}`);
-
-  const metrics = asArray(status.currentMetrics)
-    .map((m) => asRecord(m))
-    .filter((m): m is Record<string, unknown> => m !== undefined)
-    .map((m) => {
-      const type = asString(m.type) ?? "metric";
-      const resource = asRecord(m.resource);
-      if (resource) {
-        const current = asRecord(resource.current);
-        return `${type}/${String(resource.name ?? "-")}: ${String(current?.averageUtilization ?? current?.averageValue ?? "-")}`;
-      }
-      return type;
-    });
-
-  return [
-    { title: "HPA", lines },
-    ...(conditions.length > 0 ? [{ title: "Conditions", lines: conditions }] : []),
-    ...(metrics.length > 0 ? [{ title: "Current Metrics", lines: metrics }] : []),
-  ];
-}
-
-// ── CronJob sections ──────────────────────────────────────────────────────────
-
-interface BuildCronJobSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildCronJobSections(options: BuildCronJobSectionsOptions): ResourceDetailSection[] {
-  const spec = options.resource.spec ?? {};
-  const status = options.resource.status ?? {};
-
-  const activeJobs = asArray(status.active).map((j) => {
-    const ref = asRecord(j);
-    return ref ? `${String(ref.kind ?? "Job")}/${String(ref.name ?? "-")}` : "-";
-  });
-
-  const lines = [
-    `schedule: ${asString(spec.schedule) ?? "-"}`,
-    `suspend: ${String(asBoolean(spec.suspend) ?? false)}`,
-    `lastScheduleTime: ${asString(status.lastScheduleTime as unknown) ?? "-"}`,
-    `concurrencyPolicy: ${asString(spec.concurrencyPolicy) ?? "-"}`,
-    `successfulJobsHistoryLimit: ${String(asNumber(spec.successfulJobsHistoryLimit) ?? "-")}`,
-    `failedJobsHistoryLimit: ${String(asNumber(spec.failedJobsHistoryLimit) ?? "-")}`,
-    ...(activeJobs.length > 0 ? [`active: ${activeJobs.join(", ")}`] : []),
-  ];
-
-  return [{ title: "CronJob", lines }];
-}
-
-// ── Node sections ─────────────────────────────────────────────────────────────
-
-interface BuildNodeSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildNodeSections(options: BuildNodeSectionsOptions): ResourceDetailSection[] {
-  const status = options.resource.status ?? {};
-  const raw = options.resource as unknown as Record<string, unknown>;
-
-  const nodeInfo = (status.nodeInfo ?? {}) as Record<string, unknown>;
-  const capacity = (status.capacity ?? {}) as Record<string, unknown>;
-  const allocatable = (status.allocatable ?? {}) as Record<string, unknown>;
-
-  const infoLines = [
-    `kubeletVersion: ${String(nodeInfo.kubeletVersion ?? "-")}`,
-    `containerRuntime: ${String(nodeInfo.containerRuntimeVersion ?? "-")}`,
-    `osImage: ${String(nodeInfo.osImage ?? "-")}`,
-    `architecture: ${String(nodeInfo.architecture ?? "-")}`,
-  ];
-
-  const capacityLines = Object.entries(capacity).map(([k, v]) => {
-    const alloc = allocatable[k];
-    return alloc !== undefined ? `${k}: ${String(v)} (allocatable: ${String(alloc)})` : `${k}: ${String(v)}`;
-  });
-
-  const conditions = asArray(status.conditions)
-    .map((c) => asRecord(c))
-    .filter((c): c is Record<string, unknown> => c !== undefined)
-    .map((c) => `${asString(c.type) ?? "Condition"}: ${asString(c.status) ?? "-"}  ${asString(c.reason) ?? ""}`);
-
-  const taints = asArray((raw.spec as Record<string, unknown> | undefined)?.taints)
-    .map((t) => asRecord(t))
-    .filter((t): t is Record<string, unknown> => t !== undefined)
-    .map((t) => `${asString(t.key) ?? "key"}:${asString(t.effect) ?? "NoSchedule"}${t.value ? `=${String(t.value)}` : ""}`);
-
-  return [
-    { title: "Node Info", lines: infoLines },
-    ...(capacityLines.length > 0 ? [{ title: "Capacity / Allocatable", lines: capacityLines }] : []),
-    ...(conditions.length > 0 ? [{ title: "Conditions", lines: conditions }] : []),
-    ...(taints.length > 0 ? [{ title: "Taints", lines: taints }] : []),
-  ];
-}
-
-// ── RBAC sections ─────────────────────────────────────────────────────────────
-
-interface BuildRoleSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildRoleSections(options: BuildRoleSectionsOptions): ResourceDetailSection[] {
-  const raw = options.resource as unknown as Record<string, unknown>;
-  const rules = asArray(raw.rules)
-    .map((r) => asRecord(r))
-    .filter((r): r is Record<string, unknown> => r !== undefined)
-    .map((r) => {
-      const verbs = asArray(r.verbs).map((v) => String(v)).join(",");
-      const resources = asArray(r.resources).map((res) => String(res)).join(",");
-      const apiGroups = asArray(r.apiGroups).map((g) => String(g) || '""').join(",");
-      return `[${apiGroups}] ${resources}: ${verbs}`;
-    });
-
-  return [{ title: "Rules", lines: rules.length > 0 ? rules : ["No rules"] }];
-}
-
-interface BuildRoleBindingSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildRoleBindingSections(options: BuildRoleBindingSectionsOptions): ResourceDetailSection[] {
-  const raw = options.resource as unknown as Record<string, unknown>;
-  const roleRef = asRecord(raw.roleRef);
-  const refLines = roleRef
-    ? [`${asString(roleRef.kind) ?? "-"} / ${asString(roleRef.name) ?? "-"}`]
-    : ["No roleRef"];
-
-  const subjects = asArray(raw.subjects)
-    .map((s) => asRecord(s))
-    .filter((s): s is Record<string, unknown> => s !== undefined)
-    .map((s) => {
-      const ns = asString(s.namespace);
-      return `${asString(s.kind) ?? "-"}  ${ns ? `${ns}/` : ""}${asString(s.name) ?? "-"}`;
-    });
-
-  return [
-    { title: "RoleRef", lines: refLines },
-    { title: "Subjects", lines: subjects.length > 0 ? subjects : ["No subjects"] },
-  ];
-}
-
-interface BuildServiceAccountSectionsOptions {
-  resource: KubernetesResource;
-}
-
-function buildServiceAccountSections(options: BuildServiceAccountSectionsOptions): ResourceDetailSection[] {
-  const raw = options.resource as unknown as Record<string, unknown>;
-  const secrets = asArray(raw.secrets)
-    .map((s) => asRecord(s))
-    .filter((s): s is Record<string, unknown> => s !== undefined)
-    .map((s) => asString(s.name) ?? "-");
-
-  const imagePullSecrets = asArray(raw.imagePullSecrets)
-    .map((s) => asRecord(s))
-    .filter((s): s is Record<string, unknown> => s !== undefined)
-    .map((s) => asString(s.name) ?? "-");
-
-  return [
-    { title: "Secrets", lines: secrets.length > 0 ? secrets : ["None"] },
-    ...(imagePullSecrets.length > 0 ? [{ title: "Image Pull Secrets", lines: imagePullSecrets }] : []),
-  ];
-}