kubetsx 0.1.0

package/examples/full-stack.tsx

@@ -0,0 +1,339 @@
+/**
+ * 🎯 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

@@ -0,0 +1,21 @@
+{
+  "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/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "kubetsx",
+  "version": "0.1.0",
+  "description": "The Declarative Kubernetes Framework. Write K8s configs with JSX. Yes, really.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./jsx-runtime": {
+      "types": "./dist/jsx-runtime.d.ts",
+      "import": "./dist/jsx-runtime.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "example": "npm run build && node --experimental-strip-types examples/full-stack.tsx",
+    "example:basic": "npm run build && node --experimental-strip-types examples/basic.tsx",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "kubernetes",
+    "k8s",
+    "jsx",
+    "tsx",
+    "yaml",
+    "declarative",
+    "infrastructure",
+    "config",
+    "devops"
+  ],
+  "author": "malekabdelkader",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/malekabdelkader/kubetsx.git"
+  },
+  "bugs": {
+    "url": "https://github.com/malekabdelkader/kubetsx/issues"
+  },
+  "homepage": "https://github.com/malekabdelkader/kubetsx#readme",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "dependencies": {
+    "yaml": "^2.7.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}
+

package/src/components/index.ts

@@ -0,0 +1,241 @@
+/**
+ * 🎯 Kubetsx - Component Definitions
+ * 
+ * All Kubernetes resource components as JSX elements
+ */
+
+import { h } from '../jsx-runtime.js';
+import type {
+  KubexElement,
+  KubexNode,
+  ManifestProps,
+  ClusterProps,
+  NamespaceProps,
+  DeploymentProps,
+  ContainerProps,
+  PortProps,
+  EnvProps,
+  SecretRefProps,
+  ConfigMapRefProps,
+  ResourcesProps,
+  ProbeProps,
+  HttpProbeProps,
+  TcpProbeProps,
+  ExecProbeProps,
+  ServiceProps,
+  IngressProps,
+  IngressHostProps,
+  RouteProps,
+  ConfigMapProps,
+  SecretProps,
+  VolumeProps,
+  VolumeMountProps,
+  EmptyDirProps,
+  PvcVolumeProps,
+  ConfigMapVolumeProps,
+  SecretVolumeProps,
+  PvcProps,
+  HpaProps,
+  JobProps,
+  CronJobProps,
+  ServiceAccountProps,
+  RoleProps,
+  ClusterRoleProps,
+  RoleBindingProps,
+  ClusterRoleBindingProps,
+} from '../types.js';
+
+// Helper to get children array
+function getChildren(children: KubexNode | undefined): KubexNode[] {
+  if (!children) return [];
+  return Array.isArray(children) ? children : [children];
+}
+
+// Cast helper
+function toProps(props: object): Record<string, unknown> {
+  return props as Record<string, unknown>;
+}
+
+// ============================================================================
+// Manifest (Fragment alternative - groups multiple resources)
+// ============================================================================
+
+export function Manifest(props: ManifestProps): KubexElement {
+  return h('Manifest', toProps(props), ...getChildren(props.children));
+}
+
+// ============================================================================
+// Cluster & Namespace
+// ============================================================================
+
+export function Cluster(props: ClusterProps): KubexElement {
+  return h('Cluster', toProps(props), ...getChildren(props.children));
+}
+
+export function Namespace(props: NamespaceProps): KubexElement {
+  return h('Namespace', toProps(props), ...getChildren(props.children));
+}
+
+// ============================================================================
+// Workloads
+// ============================================================================
+
+export function Deployment(props: DeploymentProps): KubexElement {
+  return h('Deployment', toProps(props), ...getChildren(props.children));
+}
+
+export function Container(props: ContainerProps & { children?: KubexNode }): KubexElement {
+  return h('Container', toProps(props), ...getChildren(props.children));
+}
+
+export function Job(props: JobProps): KubexElement {
+  return h('Job', toProps(props), ...getChildren(props.children));
+}
+
+export function CronJob(props: CronJobProps): KubexElement {
+  return h('CronJob', toProps(props), ...getChildren(props.children));
+}
+
+// ============================================================================
+// Container Configuration
+// ============================================================================
+
+export function Port(props: PortProps): KubexElement {
+  return h('Port', toProps(props));
+}
+
+export function Env(props: EnvProps): KubexElement {
+  return h('Env', toProps(props), ...getChildren(props.children));
+}
+
+export function SecretRef(props: SecretRefProps): KubexElement {
+  return h('SecretRef', toProps(props));
+}
+
+export function ConfigMapRef(props: ConfigMapRefProps): KubexElement {
+  return h('ConfigMapRef', toProps(props));
+}
+
+export function Resources(props: ResourcesProps): KubexElement {
+  return h('Resources', toProps(props));
+}
+
+// ============================================================================
+// Probes
+// ============================================================================
+
+export function Probe(props: ProbeProps): KubexElement {
+  return h('Probe', toProps(props), ...getChildren(props.children));
+}
+
+export function HttpProbe(props: HttpProbeProps): KubexElement {
+  return h('HttpProbe', toProps(props));
+}
+
+export function TcpProbe(props: TcpProbeProps): KubexElement {
+  return h('TcpProbe', toProps(props));
+}
+
+export function ExecProbe(props: ExecProbeProps): KubexElement {
+  return h('ExecProbe', toProps(props));
+}
+
+// ============================================================================
+// Networking
+// ============================================================================
+
+export function Service(props: ServiceProps): KubexElement {
+  return h('Service', toProps(props));
+}
+
+export function Ingress(props: IngressProps & { host?: string }): KubexElement {
+  return h('Ingress', toProps(props), ...getChildren(props.children));
+}
+
+export function IngressHost(props: IngressHostProps): KubexElement {
+  return h('IngressHost', toProps(props), ...getChildren(props.children));
+}
+
+export function Route(props: RouteProps): KubexElement {
+  return h('Route', toProps(props));
+}
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+export function ConfigMap(props: ConfigMapProps): KubexElement {
+  return h('ConfigMap', toProps(props));
+}
+
+export function Secret(props: SecretProps): KubexElement {
+  return h('Secret', toProps(props));
+}
+
+// ============================================================================
+// Volumes
+// ============================================================================
+
+export function Volume(props: VolumeProps): KubexElement {
+  return h('Volume', toProps(props), ...getChildren(props.children));
+}
+
+export function VolumeMount(props: VolumeMountProps): KubexElement {
+  return h('VolumeMount', toProps(props));
+}
+
+export function EmptyDir(props: EmptyDirProps = {}): KubexElement {
+  return h('EmptyDir', toProps(props));
+}
+
+export function PvcVolume(props: PvcVolumeProps): KubexElement {
+  return h('PvcVolume', toProps(props));
+}
+
+export function ConfigMapVolume(props: ConfigMapVolumeProps): KubexElement {
+  return h('ConfigMapVolume', toProps(props));
+}
+
+export function SecretVolume(props: SecretVolumeProps): KubexElement {
+  return h('SecretVolume', toProps(props));
+}
+
+// ============================================================================
+// Storage
+// ============================================================================
+
+export function Pvc(props: PvcProps): KubexElement {
+  return h('Pvc', toProps(props));
+}
+
+// ============================================================================
+// Autoscaling
+// ============================================================================
+
+export function Hpa(props: HpaProps): KubexElement {
+  return h('Hpa', toProps(props));
+}
+
+// ============================================================================
+// RBAC & Service Accounts
+// ============================================================================
+
+export function ServiceAccount(props: ServiceAccountProps): KubexElement {
+  return h('ServiceAccount', toProps(props));
+}
+
+export function Role(props: RoleProps): KubexElement {
+  return h('Role', toProps(props));
+}
+
+export function ClusterRole(props: ClusterRoleProps): KubexElement {
+  return h('ClusterRole', toProps(props));
+}
+
+export function RoleBinding(props: RoleBindingProps): KubexElement {
+  return h('RoleBinding', toProps(props));
+}
+
+export function ClusterRoleBinding(props: ClusterRoleBindingProps): KubexElement {
+  return h('ClusterRoleBinding', toProps(props));
+}