kubetsx 0.1.1 → 0.1.3

package/README.md

@@ -7,7 +7,7 @@
 
 Kubetsx transforms Kubernetes configuration from fragile YAML files into type-safe, composable TypeScript components. Get full IntelliSense, compile-time validation, and the power of loops and conditionals.
 
-**If you can write React, you can configure Kubernetes.**
+**Type-safe. Composable. Finally, Kubernetes configuration that makes sense.**
 
 ```tsx
 import { render, Manifest, Deployment, Container, Port, Service } from 'kubetsx';
@@ -73,6 +73,14 @@ Or pipe directly to kubectl:
 npx kubetsx your-config.tsx | kubectl apply -f -
 ```
 
+Save to file:
+
+```bash
+npx kubetsx your-config.tsx > k8s.yaml
+```
+
+> **💡 Tip:** Use `console.error()` for debug output. The CLI validates that stdout contains only valid YAML and will error if `console.log()` corrupts the output.
+
 ---
 
 ## 🎯 Quick Start

package/dist/cli.js

@@ -29,7 +29,7 @@ Examples:
     process.exit(0);
 }
 if (args.includes('--version') || args.includes('-v')) {
-    console.log('kubetsx v0.1.1');
+    console.log('kubetsx v0.1.3');
     process.exit(0);
 }
 // Find tsx CLI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kubetsx",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "The Declarative Kubernetes Framework. Write K8s configs with JSX. Yes, really.",
   "type": "module",
   "main": "dist/index.js",
@@ -18,6 +18,11 @@
       "import": "./dist/jsx-runtime.js"
     }
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",

package/examples/basic.tsx

@@ -1,71 +0,0 @@
-/**
- * 🎯 Kubetsx - Basic Example
- * 
- * A simple deployment with service and ingress
- */
-
-import {
-  render,
-  Manifest,
-  Deployment,
-  Container,
-  Port,
-  Env,
-  SecretRef,
-  Resources,
-  Probe,
-  HttpProbe,
-  Service,
-  Ingress,
-  Route,
-} from '../dist/index.js';
-
-const APP_NAME = 'api-server';
-const VERSION = 'v1.2.3';
-
-// Define secrets as data - use loops!
-const secrets = [
-  { env: 'DATABASE_URL', secret: 'db-secrets', secretKey: 'url' },
-  { env: 'REDIS_URL', secret: 'redis-secrets', secretKey: 'url' },
-  { env: 'JWT_SECRET', secret: 'auth-secrets', secretKey: 'jwt' },
-];
-
-// Define probes as data
-const probes = [
-  { type: 'liveness' as const, path: '/health', delay: 30 },
-  { type: 'readiness' as const, path: '/ready', delay: 5 },
-];
-
-const ApiServer = () => (
-  <Manifest>
-    <Deployment name={APP_NAME} replicas={3}>
-      <Container name="api" image={`mycompany/api:${VERSION}`}>
-        <Port container={3000} />
-        {secrets.map(({ env, secret, secretKey }) => (
-          <Env key={env} name={env}>
-            <SecretRef name={secret} secretKey={secretKey} />
-          </Env>
-        ))}
-        <Resources 
-          requestMemory="256Mi" 
-          requestCpu="250m"
-          limitMemory="512Mi"
-          limitCpu="500m"
-        />
-        {probes.map(({ type, path, delay }) => (
-          <Probe key={type} type={type} delay={delay}>
-            <HttpProbe path={path} port={3000} />
-          </Probe>
-        ))}
-      </Container>
-    </Deployment>
-    <Service name={APP_NAME} port={80} targetPort={3000} />
-    <Ingress name="api-ingress" host="api.mycompany.com" ssl>
-      <Route path="/" service={APP_NAME} port={80} />
-    </Ingress>
-  </Manifest>
-);
-
-// Render to YAML
-render(<ApiServer />);
-

package/examples/full-stack.tsx

@@ -1,339 +0,0 @@
-/**
- * 🎯 Kubetsx - Full Stack Example
- * 
- * Complete production-ready deployment with:
- * - Multiple microservices
- * - Namespaces
- * - ConfigMaps & Secrets
- * - Autoscaling
- * - RBAC
- * 
- * @jsxImportSource ../dist
- */
-
-import {
-  render,
-  Manifest,
-  Cluster,
-  Namespace,
-  Deployment,
-  Container,
-  Port,
-  Env,
-  SecretRef,
-  ConfigMapRef,
-  Resources,
-  Probe,
-  HttpProbe,
-  ExecProbe,
-  Service,
-  Ingress,
-  IngressHost,
-  Route,
-  ConfigMap,
-  Secret,
-  Pvc,
-  Hpa,
-  CronJob,
-  ServiceAccount,
-  Role,
-  RoleBinding,
-  Volume,
-  VolumeMount,
-  EmptyDir,
-  PvcVolume,
-} from '../dist/index.js';
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-const VERSION = process.env.VERSION || 'latest';
-const ENV = process.env.NODE_ENV || 'production';
-const isProduction = ENV === 'production';
-
-// Service definitions - just add to this array to deploy new services!
-const services = [
-  { 
-    name: 'api', 
-    replicas: isProduction ? 5 : 1, 
-    port: 3000,
-    host: 'api.mycompany.com',
-    memory: '512Mi',
-    cpu: '500m',
-    secrets: ['DATABASE_URL', 'REDIS_URL', 'JWT_SECRET'],
-    autoscale: { min: 3, max: 10, cpu: 70 },
-  },
-  { 
-    name: 'auth', 
-    replicas: isProduction ? 3 : 1, 
-    port: 4000,
-    host: 'auth.mycompany.com',
-    memory: '256Mi',
-    cpu: '250m',
-    secrets: ['DATABASE_URL', 'OAUTH_CLIENT_SECRET', 'JWT_SECRET'],
-    autoscale: { min: 2, max: 5, cpu: 80 },
-  },
-  { 
-    name: 'worker', 
-    replicas: isProduction ? 3 : 1, 
-    port: 5000,
-    memory: '1Gi',
-    cpu: '1',
-    secrets: ['DATABASE_URL', 'REDIS_URL', 'AWS_ACCESS_KEY', 'AWS_SECRET_KEY'],
-    // No autoscale for workers
-  },
-];
-
-// Cron jobs
-const cronJobs = [
-  { name: 'cleanup', schedule: '0 3 * * *', command: ['node', 'scripts/cleanup.js'] },
-  { name: 'reports', schedule: '0 8 * * 1', command: ['node', 'scripts/weekly-report.js'] },
-  { name: 'backups', schedule: '0 2 * * *', command: ['node', 'scripts/backup.js'] },
-];
-
-// ============================================================================
-// Reusable Components
-// ============================================================================
-
-interface StandardContainerProps {
-  name: string;
-  port: number;
-  memory: string;
-  cpu: string;
-  secrets: string[];
-}
-
-const StandardContainer = ({ name, port, memory, cpu, secrets }: StandardContainerProps) => (
-  <Container name={name} image={`mycompany/${name}:${VERSION}`}>
-    <Port container={port} />
-    
-    {/* Common env vars */}
-    <Env name="NODE_ENV" value={ENV} />
-    <Env name="SERVICE_NAME" value={name} />
-    <Env name="LOG_LEVEL">
-      <ConfigMapRef name="app-config" key="log_level" />
-    </Env>
-    
-    {/* Service-specific secrets */}
-    {secrets.map(secret => (
-      <Env key={secret} name={secret}>
-        <SecretRef name="app-secrets" secretKey={secret.toLowerCase().replace(/_/g, '-')} />
-      </Env>
-    ))}
-    
-    <Resources 
-      requestMemory={memory}
-      requestCpu={cpu}
-      limitMemory={memory}
-      limitCpu={cpu}
-    />
-    
-    <Probe type="liveness" delay={30} period={10}>
-      <HttpProbe path="/health" port={port} />
-    </Probe>
-    <Probe type="readiness" delay={5} period={5}>
-      <HttpProbe path="/ready" port={port} />
-    </Probe>
-    
-    {/* Temp storage for logs */}
-    <VolumeMount name="tmp" mountPath="/tmp" />
-  </Container>
-);
-
-// ============================================================================
-// Main Infrastructure
-// ============================================================================
-
-const ProductionStack = () => (
-  <Cluster name="production">
-    {/* ================================================================== */}
-    {/* Backend Namespace */}
-    {/* ================================================================== */}
-    <Namespace name="backend" labels={{ team: 'platform', env: ENV }}>
-      
-      {/* Shared ConfigMap */}
-      <ConfigMap 
-        name="app-config" 
-        data={{
-          log_level: isProduction ? 'info' : 'debug',
-          feature_flags: JSON.stringify({ newUI: true, analytics: isProduction }),
-        }}
-      />
-      
-      {/* Shared Secret (in practice, use external secrets manager) */}
-      <Secret 
-        name="app-secrets"
-        stringData={{
-          'database-url': '${DATABASE_URL}',
-          'redis-url': '${REDIS_URL}',
-          'jwt-secret': '${JWT_SECRET}',
-          'oauth-client-secret': '${OAUTH_CLIENT_SECRET}',
-          'aws-access-key': '${AWS_ACCESS_KEY}',
-          'aws-secret-key': '${AWS_SECRET_KEY}',
-        }}
-      />
-      
-      {/* Service Account with RBAC */}
-      <ServiceAccount name="backend-sa" />
-      <Role 
-        name="backend-role"
-        rules={[
-          { apiGroups: [''], resources: ['configmaps', 'secrets'], verbs: ['get', 'list', 'watch'] },
-          { apiGroups: [''], resources: ['pods'], verbs: ['get', 'list'] },
-        ]}
-      />
-      <RoleBinding
-        name="backend-role-binding"
-        roleRef={{ kind: 'Role', name: 'backend-role' }}
-        subjects={[{ kind: 'ServiceAccount', name: 'backend-sa' }]}
-      />
-      
-      {/* Deploy all services using loop! */}
-      {services.map(svc => (
-        <Manifest key={svc.name}>
-          <Deployment 
-            name={svc.name} 
-            replicas={svc.replicas}
-            labels={{ app: svc.name, version: VERSION }}
-          >
-            <StandardContainer 
-              name={svc.name}
-              port={svc.port}
-              memory={svc.memory}
-              cpu={svc.cpu}
-              secrets={svc.secrets}
-            />
-            <Volume name="tmp">
-              <EmptyDir />
-            </Volume>
-          </Deployment>
-          
-          <Service 
-            name={svc.name} 
-            port={80} 
-            targetPort={svc.port}
-            selector={{ app: svc.name }}
-          />
-          
-          {/* HPA only for services with autoscale config */}
-          {svc.autoscale && (
-            <Hpa
-              name={`${svc.name}-hpa`}
-              target={svc.name}
-              minReplicas={svc.autoscale.min}
-              maxReplicas={svc.autoscale.max}
-              targetCpuUtilization={svc.autoscale.cpu}
-            />
-          )}
-        </Manifest>
-      ))}
-      
-      {/* Ingress for public services */}
-      <Ingress name="backend-ingress" className="nginx" ssl>
-        {services
-          .filter(svc => svc.host)
-          .map(svc => (
-            <IngressHost key={svc.name} host={svc.host!}>
-              <Route path="/" service={svc.name} port={80} />
-            </IngressHost>
-          ))
-        }
-      </Ingress>
-      
-      {/* Cron Jobs */}
-      {cronJobs.map(job => (
-        <CronJob 
-          key={job.name}
-          name={job.name}
-          schedule={job.schedule}
-          concurrencyPolicy="Forbid"
-        >
-          <Container 
-            name={job.name} 
-            image={`mycompany/jobs:${VERSION}`}
-            command={job.command}
-          >
-            <Env name="DATABASE_URL">
-              <SecretRef name="app-secrets" secretKey="database-url" />
-            </Env>
-            <Resources requestMemory="256Mi" requestCpu="100m" />
-          </Container>
-        </CronJob>
-      ))}
-    </Namespace>
-
-    {/* ================================================================== */}
-    {/* Database Namespace */}
-    {/* ================================================================== */}
-    <Namespace name="databases" labels={{ team: 'platform', env: ENV }}>
-      
-      {/* PostgreSQL PVC */}
-      <Pvc 
-        name="postgres-data" 
-        storage="100Gi"
-        accessModes={['ReadWriteOnce']}
-        storageClassName="ssd"
-      />
-      
-      {/* PostgreSQL Deployment */}
-      <Deployment name="postgres" replicas={1}>
-        <Container name="postgres" image="postgres:15-alpine">
-          <Port container={5432} />
-          <Env name="POSTGRES_PASSWORD">
-            <SecretRef name="postgres-secrets" key="password" />
-          </Env>
-          <Env name="POSTGRES_DB" value="myapp" />
-          <Resources 
-            requestMemory="1Gi" 
-            requestCpu="500m"
-            limitMemory="2Gi"
-            limitCpu="1"
-          />
-          <Probe type="readiness" delay={5} period={10}>
-            <ExecProbe command={['pg_isready', '-U', 'postgres']} />
-          </Probe>
-          <VolumeMount name="data" mountPath="/var/lib/postgresql/data" />
-        </Container>
-        <Volume name="data">
-          <PvcVolume claimName="postgres-data" />
-        </Volume>
-      </Deployment>
-      
-      <Service name="postgres" port={5432} targetPort={5432} type="ClusterIP" />
-      
-      {/* Redis Deployment */}
-      <Deployment name="redis" replicas={1}>
-        <Container name="redis" image="redis:7-alpine">
-          <Port container={6379} />
-          <Resources 
-            requestMemory="256Mi" 
-            requestCpu="100m"
-            limitMemory="512Mi"
-            limitCpu="200m"
-          />
-          <Probe type="readiness" delay={5}>
-            <ExecProbe command={['redis-cli', 'ping']} />
-          </Probe>
-        </Container>
-      </Deployment>
-      
-      <Service name="redis" port={6379} targetPort={6379} type="ClusterIP" />
-      
-    </Namespace>
-  </Cluster>
-);
-
-// ============================================================================
-// Render Output
-// ============================================================================
-
-console.log('🎯 Kubetsx - Generating Kubernetes manifests...\n');
-console.log(`Environment: ${ENV}`);
-console.log(`Version: ${VERSION}`);
-console.log(`Services: ${services.map(s => s.name).join(', ')}`);
-console.log(`Cron Jobs: ${cronJobs.map(j => j.name).join(', ')}`);
-console.log('\n---\n');
-
-render(<ProductionStack />);
-

package/examples/tsconfig.json

@@ -1,21 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "jsx": "react-jsx",
-    "jsxImportSource": "../dist",
-    "paths": {
-      "kubetsx": ["../dist/index.js"],
-      "kubetsx/*": ["../dist/*"]
-    },
-    "baseUrl": "."
-  },
-  "include": ["./**/*"]
-}
-

package/src/cli.ts

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-/**
- * 🎯 Kubetsx CLI
- * 
- * Run Kubernetes config files written in TSX
- * Validates output is clean YAML before emitting
- */
-
-import { spawn } from 'child_process';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { existsSync } from 'fs';
-import { parse as parseYAML } from 'yaml';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-const args = process.argv.slice(2);
-
-if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
-  console.log(`
-🎯 Kubetsx - The Declarative Kubernetes Framework
-
-Usage:
-  kubetsx <file.tsx> [options]     Run a TSX config file
-  kubetsx --help                   Show this help message
-  kubetsx --version                Show version
-
-Examples:
-  kubetsx config.tsx               Generate YAML from config.tsx
-  kubetsx config.tsx > k8s.yaml    Save output to file
-  kubetsx config.tsx | kubectl apply -f -   Apply directly to cluster
-`);
-  process.exit(0);
-}
-
-if (args.includes('--version') || args.includes('-v')) {
-  console.log('kubetsx v0.1.1');
-  process.exit(0);
-}
-
-// Find tsx CLI
-const tsxCliPath = resolve(__dirname, '..', 'node_modules', 'tsx', 'dist', 'cli.mjs');
-const tsxPath = existsSync(tsxCliPath) ? tsxCliPath : null;
-
-// Run tsx and capture output
-const child = spawn(
-  tsxPath ? process.execPath : 'npx',
-  tsxPath ? [tsxCliPath, ...args] : ['tsx', ...args],
-  {
-    stdio: ['inherit', 'pipe', 'pipe'],
-  }
-);
-
-let stdout = '';
-let stderr = '';
-
-child.stdout?.on('data', (data) => {
-  stdout += data.toString();
-});
-
-child.stderr?.on('data', (data) => {
-  stderr += data.toString();
-});
-
-child.on('close', (code) => {
-  // Always pass through stderr
-  if (stderr) {
-    process.stderr.write(stderr);
-  }
-
-  if (code !== 0) {
-    process.exit(code ?? 1);
-  }
-
-  // Validate the output is valid YAML
-  const trimmedOutput = stdout.trim();
-  
-  if (!trimmedOutput) {
-    process.stderr.write('Error: No output generated. Make sure your config calls render().\n');
-    process.exit(1);
-  }
-
-  // Try to parse as YAML to validate
-  try {
-    // Split by document separator and parse each
-    const documents = trimmedOutput.split(/^---$/m).filter(d => d.trim());
-    
-    for (const doc of documents) {
-      const parsed = parseYAML(doc);
-      
-      // Check it looks like a K8s resource
-      if (parsed && typeof parsed === 'object') {
-        if (!('apiVersion' in parsed) || !('kind' in parsed)) {
-          throw new Error('Output does not appear to be a valid Kubernetes resource (missing apiVersion or kind)');
-        }
-      }
-    }
-    
-    // Valid YAML - output it
-    process.stdout.write(trimmedOutput + '\n');
-    
-  } catch (err) {
-    process.stderr.write('\n❌ Error: Output is not valid Kubernetes YAML.\n\n');
-    process.stderr.write('This usually happens when your config file has console.log() statements.\n');
-    process.stderr.write('Use console.error() instead for debug output.\n\n');
-    process.stderr.write('--- Raw output ---\n');
-    process.stderr.write(stdout);
-    process.stderr.write('------------------\n');
-    process.exit(1);
-  }
-});