kubechart 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kubechart contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,157 @@
+# kubechart
+
+CLI tool to visualize Kubernetes cluster as an ASCII tree directly in your terminal. Perfect for quick debugging when SSH'd into servers.
+
+## Features
+
+- **ASCII Tree Visualization**: Clean, readable tree structure showing namespaces, workloads, pods, services, and ingresses
+- **Color-Coded Status**: Visual indicators for pod health (Running, Pending, Failed, etc.)
+- **Resource Type Symbols**: Distinct symbols for Deployments, StatefulSets, DaemonSets, Jobs, CronJobs, Services, and Ingresses
+- **Flexible Filtering**: Filter by namespace, label selector, or show only resources with errors
+- **Multi-Context Support**: Switch between different kubeconfig contexts
+- **Error Handling**: Clear error messages for common K8s connection issues
+
+## Installation
+
+```bash
+npm install -g kubechart
+```
+
+Or use with npx:
+
+```bash
+npx kubechart
+```
+
+## Usage
+
+### Basic Usage
+
+```bash
+# Show current namespace (kubectl-compatible behavior)
+kubechart
+
+# Show all namespaces
+kubechart -A
+
+# Filter by specific namespace
+kubechart -n production
+```
+
+### Filtering Options
+
+```bash
+# Use specific kubeconfig context
+kubechart --context my-eks-cluster
+
+# Label selector (same syntax as kubectl)
+kubechart -l app=api
+kubechart --selector app=api,env=prod
+
+# Show only workloads with errors
+kubechart --show-errors
+```
+
+### Output Options
+
+```bash
+# Disable colored output
+kubechart --no-color
+```
+
+### Examples
+
+```
+◆ CLUSTER  prod-cluster  |  k8s v1.29.2  |  3 nodes
+
+├── NAMESPACE  production  [Active]
+│   ├── ▲ Deployment  api-server  [3/3]
+│   │   ├── POD  ● api-server-7d9f-xk2p  node-01  192.168.1.10  0 restarts
+│   │   ├── POD  ● api-server-7d9f-mn4q  node-02  192.168.1.11  0 restarts
+│   │   └── POD  ✖ api-server-7d9f-rs7w  node-03  CrashLoopBackOff  5 restarts
+│   ├── ◆ StatefulSet  postgres  [1/1]
+│   │   └── POD  ● postgres-0  node-03  PVC: pg-data-0
+│   ├── ● SVC  api-svc  ClusterIP  10.96.0.50  80/TCP
+│   └── ◆ ING  api.example.com  🔒  → /, /api
+
+└── NAMESPACE  staging  [Active]
+    └── ▲ Deployment  worker  [0/2]  ⚠ degraded
+        ├── POD  ◌ worker-abc-hk4p  Pending
+        └── POD  ✖ worker-abc-xx9q  OOMKilled  3 restarts
+
+────────────────────────────────────────
+namespaces: 2  |  workloads: 3  |  pods: 5  |  services: 1  |  ingresses: 1
+Pod Status: ● Running+Ready  ◑ Running+NotReady  ◌ Pending  ✖ Failed  ○ Succeeded
+```
+
+## Pod Status Legend
+
+| Symbol | Color  | Meaning                               |
+| ------ | ------ | ------------------------------------- |
+| `●`    | green  | Running + Ready                       |
+| `◑`    | yellow | Running but not Ready                 |
+| `◌`    | yellow | Pending                               |
+| `✖`    | red    | Failed / CrashLoopBackOff / OOMKilled |
+| `○`    | gray   | Succeeded (Job completed)             |
+
+## Resource Type Legend
+
+| Symbol | Type         |
+| ------ | ------------ |
+| ▲      | Deployment   |
+| ◆      | StatefulSet  |
+| ■      | DaemonSet    |
+| ●      | Job          |
+| ○      | CronJob      |
+| ●      | ClusterIP    |
+| ◆      | NodePort     |
+| ▲      | LoadBalancer |
+| ○      | ExternalName |
+| ◆      | Ingress      |
+
+## Error Handling
+
+kubechart provides clear error messages for common issues:
+
+- **Cannot load kubeconfig**: Check that `~/.kube/config` exists
+- **Context not found**: Verify the context name in your kubeconfig
+- **Cannot connect to cluster**: Ensure your cluster is running and accessible
+- **Forbidden/Unauthorized**: Check your RBAC permissions and credentials
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run with local cluster
+npm start
+
+# Watch mode with hot reload
+npm run dev -- -n <namespace>
+
+# Run tests
+npm test
+
+# Run tests with coverage
+npm run test:coverage
+
+# Lint
+npm run lint
+
+# Format
+npm run format
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Access to a Kubernetes cluster
+- Valid kubeconfig file
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,59 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { render } from 'ink';
+import React from 'react';
+import { createClient } from './k8s/client.js';
+import { fetchClusterData } from './k8s/fetcher.js';
+import { buildTree } from './tree/builder.js';
+import { TreeView } from './render/TreeView.js';
+import { setUseColors } from './render/colors.js';
+const program = new Command();
+program
+    .name('kubechart')
+    .description('Visualize Kubernetes cluster as ASCII tree')
+    .version('0.1.0')
+    .option('-n, --namespace <ns>', 'Filter by namespace')
+    .option('-A, --all-namespaces', 'Show all namespaces')
+    .option('--context <ctx>', 'Kubeconfig context to use')
+    .option('-l, --selector <sel>', 'Label selector (e.g. app=api,env=prod)')
+    .option('--show-errors', 'Only show workloads with errors')
+    .option('--no-color', 'Disable colored output')
+    .parse(process.argv);
+const options = program.opts();
+async function main() {
+    try {
+        // Set color mode based on --no-color flag
+        setUseColors(options.color !== false);
+        // Create K8s client
+        const client = createClient(options.context);
+        // Build fetch options
+        // Default to current namespace (kubectl behavior)
+        // Use -A for all namespaces, -n for specific namespace
+        const fetchOpts = {
+            namespace: options.allNamespaces ? undefined : options.namespace || client.currentNamespace,
+            allNamespaces: options.allNamespaces,
+            selector: options.selector,
+            showErrors: options.showErrors,
+        };
+        // Fetch cluster data
+        const rawData = await fetchClusterData(client, fetchOpts);
+        // Build tree
+        const tree = buildTree(rawData, client.contextName, {
+            showErrors: options.showErrors,
+            selector: options.selector,
+        });
+        // Render using ink
+        const { waitUntilExit } = render(React.createElement(TreeView, { tree }));
+        await waitUntilExit();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+            process.exit(1);
+        }
+        console.error('Unknown error occurred');
+        process.exit(1);
+    }
+}
+main();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;KACrD,MAAM,CAAC,sBAAsB,EAAE,qBAAqB,CAAC;KACrD,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;KACtD,MAAM,CAAC,sBAAsB,EAAE,wCAAwC,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,iCAAiC,CAAC;KAC1D,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC;KAC9C,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAEvB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,0CAA0C;QAC1C,YAAY,CAAC,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QAEtC,oBAAoB;QACpB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE7C,sBAAsB;QACtB,kDAAkD;QAClD,uDAAuD;QACvD,MAAM,SAAS,GAAiB;YAC9B,SAAS,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,gBAAgB;YAC3F,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;QAEF,qBAAqB;QACrB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE1D,aAAa;QACb,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,WAAW,EAAE;YAClD,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1E,MAAM,aAAa,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { createClient } from './k8s/client.js';
+export { fetchClusterData } from './k8s/fetcher.js';
+export type { K8sClient } from './k8s/client.js';
+export type { FetchOptions, RawClusterData } from './k8s/types.js';
+export { buildTree } from './tree/builder.js';
+export type { ClusterTree, NamespaceNode, WorkloadNode, PodNode, PodPhase, ResourceKind, } from './tree/types.js';
+export { TreeView } from './render/TreeView.js';
+export { colors, getPodStatusColor } from './render/colors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,YAAY,EACV,WAAW,EACX,aAAa,EACb,YAAY,EACZ,OAAO,EACP,QAAQ,EACR,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+// Main export for kubechart
+export { createClient } from './k8s/client.js';
+export { fetchClusterData } from './k8s/fetcher.js';
+export { buildTree } from './tree/builder.js';
+export { TreeView } from './render/TreeView.js';
+export { colors, getPodStatusColor } from './render/colors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAS9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/k8s/client.d.ts

@@ -0,0 +1,12 @@
+import * as k8s from '@kubernetes/client-node';
+export interface K8sClient {
+    core: k8s.CoreV1Api;
+    apps: k8s.AppsV1Api;
+    batch: k8s.BatchV1Api;
+    networking: k8s.NetworkingV1Api;
+    version: k8s.VersionApi;
+    contextName: string;
+    currentNamespace: string;
+}
+export declare function createClient(context?: string): K8sClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/k8s/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/k8s/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC,SAAS,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC;IACtB,UAAU,EAAE,GAAG,CAAC,eAAe,CAAC;IAChC,OAAO,EAAE,GAAG,CAAC,UAAU,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAoCxD"}

package/dist/k8s/client.js

@@ -0,0 +1,36 @@
+import * as k8s from '@kubernetes/client-node';
+export function createClient(context) {
+    const kc = new k8s.KubeConfig();
+    try {
+        kc.loadFromDefault();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new Error(`Cannot load kubeconfig: ${error.message}`);
+        }
+        throw new Error('Cannot load kubeconfig: unknown error');
+    }
+    if (context) {
+        const contexts = kc.getContexts();
+        const contextExists = contexts.some((ctx) => ctx.name === context);
+        if (!contextExists) {
+            throw new Error(`Context '${context}' not found in kubeconfig`);
+        }
+        kc.setCurrentContext(context);
+    }
+    // Get current namespace from context
+    const currentContext = kc
+        .getContexts()
+        .find((ctx) => ctx.name === kc.getCurrentContext());
+    const currentNamespace = currentContext?.namespace || 'default';
+    return {
+        core: kc.makeApiClient(k8s.CoreV1Api),
+        apps: kc.makeApiClient(k8s.AppsV1Api),
+        batch: kc.makeApiClient(k8s.BatchV1Api),
+        networking: kc.makeApiClient(k8s.NetworkingV1Api),
+        version: kc.makeApiClient(k8s.VersionApi),
+        contextName: kc.getCurrentContext(),
+        currentNamespace,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/k8s/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/k8s/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAY/C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;IAEhC,IAAI,CAAC;QACH,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,QAAQ,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;QAClC,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAqB,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QACrF,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,YAAY,OAAO,2BAA2B,CAAC,CAAC;QAClE,CAAC;QACD,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAED,qCAAqC;IACrC,MAAM,cAAc,GAAG,EAAE;SACtB,WAAW,EAAE;SACb,IAAI,CAAC,CAAC,GAAqB,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC,iBAAiB,EAAE,CAAC,CAAC;IACxE,MAAM,gBAAgB,GAAG,cAAc,EAAE,SAAS,IAAI,SAAS,CAAC;IAEhE,OAAO;QACL,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;QACrC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC;QACrC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;QACvC,UAAU,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,eAAe,CAAC;QACjD,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;QACzC,WAAW,EAAE,EAAE,CAAC,iBAAiB,EAAE;QACnC,gBAAgB;KACjB,CAAC;AACJ,CAAC"}

package/dist/k8s/fetcher.d.ts

@@ -0,0 +1,4 @@
+import type { K8sClient } from './client.js';
+import type { FetchOptions, RawClusterData } from './types.js';
+export declare function fetchClusterData(client: K8sClient, opts: FetchOptions): Promise<RawClusterData>;
+//# sourceMappingURL=fetcher.d.ts.map

package/dist/k8s/fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.d.ts","sourceRoot":"","sources":["../../src/k8s/fetcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAkGzB"}

package/dist/k8s/fetcher.js

@@ -0,0 +1,161 @@
+export async function fetchClusterData(client, opts) {
+    try {
+        // Fetch server version and node count
+        const versionInfo = await client.version.getCode();
+        const serverVersion = versionInfo.body.gitVersion || 'unknown';
+        const nodeList = await client.core.listNode();
+        const nodeCount = nodeList.body.items.length;
+        // Fetch namespaces
+        const namespaces = await fetchNamespaces(client.core, opts.namespace);
+        // Fetch all resources for each namespace
+        const deployments = [];
+        const statefulSets = [];
+        const daemonSets = [];
+        const jobs = [];
+        const cronJobs = [];
+        const pods = [];
+        const services = [];
+        const ingresses = [];
+        for (const ns of namespaces) {
+            const nsName = ns.metadata?.name;
+            if (!nsName)
+                continue;
+            const [nsDeployments, nsStatefulSets, nsDaemonSets, nsJobs, nsCronJobs, nsPods, nsServices, nsIngresses,] = await Promise.all([
+                fetchDeployments(client.apps, nsName),
+                fetchStatefulSets(client.apps, nsName),
+                fetchDaemonSets(client.apps, nsName),
+                fetchJobs(client.batch, nsName),
+                fetchCronJobs(client.batch, nsName),
+                fetchPods(client.core, nsName, opts.selector),
+                fetchServices(client.core, nsName),
+                fetchIngresses(client.networking, nsName),
+            ]);
+            deployments.push(...nsDeployments);
+            statefulSets.push(...nsStatefulSets);
+            daemonSets.push(...nsDaemonSets);
+            jobs.push(...nsJobs);
+            cronJobs.push(...nsCronJobs);
+            pods.push(...nsPods);
+            services.push(...nsServices);
+            ingresses.push(...nsIngresses);
+        }
+        return {
+            namespaces,
+            deployments,
+            statefulSets,
+            daemonSets,
+            jobs,
+            cronJobs,
+            pods,
+            services,
+            ingresses,
+            serverVersion,
+            nodeCount,
+        };
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            // Handle specific K8s API errors
+            const errorMessage = error.message.toLowerCase();
+            if (errorMessage.includes('econnrefused') ||
+                errorMessage.includes('connect') ||
+                errorMessage.includes('timeout')) {
+                throw new Error('Cannot connect to cluster. Is the cluster running?');
+            }
+            if (errorMessage.includes('forbidden') || errorMessage.includes('403')) {
+                throw new Error('Forbidden — missing RBAC permissions to access cluster resources');
+            }
+            if (errorMessage.includes('unauthorized') || errorMessage.includes('401')) {
+                throw new Error('Unauthorized — invalid credentials or token expired');
+            }
+            if (errorMessage.includes('not found') || errorMessage.includes('404')) {
+                throw new Error('Resource not found in cluster');
+            }
+            throw new Error(`Failed to fetch cluster data: ${error.message}`);
+        }
+        throw new Error('Failed to fetch cluster data: unknown error');
+    }
+}
+async function fetchNamespaces(core, namespace) {
+    if (namespace) {
+        const res = await core.readNamespace(namespace);
+        return [res.body];
+    }
+    const res = await core.listNamespace();
+    return res.body.items;
+}
+async function fetchDeployments(apps, ns) {
+    try {
+        const res = await apps.listNamespacedDeployment(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        // Namespace might not have deployments
+        return [];
+    }
+}
+async function fetchPods(core, ns, selector) {
+    try {
+        const res = await core.listNamespacedPod(ns, undefined, undefined, undefined, undefined, selector);
+        return res.body.items;
+    }
+    catch (error) {
+        // Namespace might not have pods
+        return [];
+    }
+}
+async function fetchStatefulSets(apps, ns) {
+    try {
+        const res = await apps.listNamespacedStatefulSet(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        return [];
+    }
+}
+async function fetchDaemonSets(apps, ns) {
+    try {
+        const res = await apps.listNamespacedDaemonSet(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        return [];
+    }
+}
+async function fetchJobs(batch, ns) {
+    try {
+        const res = await batch.listNamespacedJob(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        return [];
+    }
+}
+async function fetchCronJobs(batch, ns) {
+    try {
+        const res = await batch.listNamespacedCronJob(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        return [];
+    }
+}
+async function fetchServices(core, ns) {
+    try {
+        const res = await core.listNamespacedService(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        return [];
+    }
+}
+async function fetchIngresses(net, ns) {
+    try {
+        const res = await net.listNamespacedIngress(ns);
+        return res.body.items;
+    }
+    catch (error) {
+        return [];
+    }
+}
+//# sourceMappingURL=fetcher.js.map

package/dist/k8s/fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetcher.js","sourceRoot":"","sources":["../../src/k8s/fetcher.ts"],"names":[],"mappings":"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"}

package/dist/k8s/types.d.ts

@@ -0,0 +1,21 @@
+export * from '@kubernetes/client-node';
+export interface FetchOptions {
+    namespace?: string;
+    allNamespaces?: boolean;
+    selector?: string;
+    showErrors?: boolean;
+}
+export interface RawClusterData {
+    namespaces: import('@kubernetes/client-node').V1Namespace[];
+    deployments: import('@kubernetes/client-node').V1Deployment[];
+    statefulSets: import('@kubernetes/client-node').V1StatefulSet[];
+    daemonSets: import('@kubernetes/client-node').V1DaemonSet[];
+    jobs: import('@kubernetes/client-node').V1Job[];
+    cronJobs: import('@kubernetes/client-node').V1CronJob[];
+    pods: import('@kubernetes/client-node').V1Pod[];
+    services: import('@kubernetes/client-node').V1Service[];
+    ingresses: import('@kubernetes/client-node').V1Ingress[];
+    serverVersion?: string;
+    nodeCount?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/k8s/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/k8s/types.ts"],"names":[],"mappings":"AACA,cAAc,yBAAyB,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,OAAO,yBAAyB,EAAE,WAAW,EAAE,CAAC;IAC5D,WAAW,EAAE,OAAO,yBAAyB,EAAE,YAAY,EAAE,CAAC;IAC9D,YAAY,EAAE,OAAO,yBAAyB,EAAE,aAAa,EAAE,CAAC;IAChE,UAAU,EAAE,OAAO,yBAAyB,EAAE,WAAW,EAAE,CAAC;IAC5D,IAAI,EAAE,OAAO,yBAAyB,EAAE,KAAK,EAAE,CAAC;IAChD,QAAQ,EAAE,OAAO,yBAAyB,EAAE,SAAS,EAAE,CAAC;IACxD,IAAI,EAAE,OAAO,yBAAyB,EAAE,KAAK,EAAE,CAAC;IAChD,QAAQ,EAAE,OAAO,yBAAyB,EAAE,SAAS,EAAE,CAAC;IACxD,SAAS,EAAE,OAAO,yBAAyB,EAAE,SAAS,EAAE,CAAC;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/k8s/types.js

@@ -0,0 +1,3 @@
+// Raw K8s resource types - re-exported from @kubernetes/client-node for convenience
+export * from '@kubernetes/client-node';
+//# sourceMappingURL=types.js.map

package/dist/k8s/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/k8s/types.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,cAAc,yBAAyB,CAAC"}

package/dist/render/TreeView.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { ClusterTree } from '../tree/types.js';
+interface TreeViewProps {
+    tree: ClusterTree;
+}
+export declare function TreeView({ tree }: TreeViewProps): React.ReactElement;
+export {};
+//# sourceMappingURL=TreeView.d.ts.map

package/dist/render/TreeView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TreeView.d.ts","sourceRoot":"","sources":["../../src/render/TreeView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,WAAW,EAAiB,MAAM,kBAAkB,CAAC;AAGnE,UAAU,aAAa;IACrB,IAAI,EAAE,WAAW,CAAC;CACnB;AAED,wBAAgB,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAyDpE"}