@owlmeans/kluster 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OwlMeans Common — Fullstack typescript framework
+
+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,640 @@
+# @owlmeans/kluster
+
+The **@owlmeans/kluster** package provides Kubernetes integration for OwlMeans Common Libraries, enabling applications to interact with Kubernetes clusters for service discovery, pod management, and configuration resolution in cloud-native environments.
+
+## Purpose
+
+This package serves as a Kubernetes integration layer for OwlMeans applications, specifically designed for:
+
+- **Service Discovery**: Automatically discover and connect to services running in Kubernetes clusters
+- **Pod Management**: Query and interact with pods using label selectors
+- **Configuration Resolution**: Resolve configuration values from Kubernetes resources at runtime
+- **Cloud-native Deployment**: Enable applications to work seamlessly in Kubernetes environments
+- **Dynamic Service Endpoints**: Automatically resolve service hostnames and endpoints
+- **Network API Integration**: Access Kubernetes networking APIs for advanced operations
+
+## Key Concepts
+
+### Kubernetes Service Discovery
+The package provides automatic service discovery within Kubernetes clusters, allowing applications to find and connect to other services without hardcoded endpoints.
+
+### Configuration Directives
+Special configuration syntax (`kluster:directive:query`) that gets resolved at runtime using Kubernetes API calls, enabling dynamic configuration based on cluster state.
+
+### Lazy Initialization
+Kubernetes client is initialized lazily when first accessed, reducing startup time and resource usage when Kubernetes features are not immediately needed.
+
+### Label Selector Queries
+Uses Kubernetes label selectors to query for pods and services, providing flexible and powerful resource discovery capabilities.
+
+## Installation
+
+```bash
+npm install @owlmeans/kluster
+```
+
+## API Reference
+
+### Types
+
+#### `KlusterService`
+Main service interface for Kubernetes operations.
+
+```typescript
+interface KlusterService extends LazyService {
+  config?: KubeConfig
+  api?: CoreV1Api
+  
+  getHostnames(selector: string): Promise<string[]>
+  getServiceHostname(selector: string): Promise<string>
+  dispatch<T>(action: string, query: string): Promise<T>
+  makeNetworkingApi(): NetworkingV1Api
+}
+```
+
+#### `KlusterConfig`
+Configuration interface extending ServerConfig.
+
+```typescript
+interface KlusterConfig extends ServerConfig {
+  kluster?: {
+    namespace?: string
+  }
+}
+```
+
+### Core Functions
+
+#### `makeKlusterService(alias?: string): KlusterService`
+
+Creates a Kubernetes service instance with lazy initialization.
+
+**Parameters:**
+- `alias`: Service alias (defaults to 'kluster')
+
+**Returns:** KlusterService instance
+
+```typescript
+import { makeKlusterService } from '@owlmeans/kluster'
+
+const klusterService = makeKlusterService('k8s-client')
+```
+
+#### `klusterize<C extends KlusterConfig, T extends BasicContext<C>>(context: T, alias?: string): T`
+
+Enhances a context with Kubernetes capabilities and registers necessary middleware.
+
+**Parameters:**
+- `context`: Application context to enhance
+- `alias`: Service alias (defaults to 'kluster')
+
+**Returns:** Enhanced context with Kubernetes support
+
+```typescript
+import { klusterize } from '@owlmeans/kluster'
+import { makeServerContext } from '@owlmeans/server-context'
+
+const context = makeServerContext(config)
+const k8sContext = klusterize(context)
+```
+
+#### `createMiddleware(alias?: string): Middleware`
+
+Creates middleware for processing Kubernetes configuration directives.
+
+**Parameters:**
+- `alias`: Service alias (defaults to 'kluster')
+
+**Returns:** Middleware instance
+
+```typescript
+import { createMiddleware } from '@owlmeans/kluster'
+
+const middleware = createMiddleware('k8s-client')
+context.registerMiddleware(middleware)
+```
+
+### Service Methods
+
+#### `getHostnames(selector: string): Promise<string[]>`
+
+Retrieves pod IP addresses using a label selector.
+
+**Parameters:**
+- `selector`: Kubernetes label selector
+
+**Returns:** Promise resolving to array of pod IP addresses
+
+```typescript
+const klusterService = context.service<KlusterService>('kluster')
+const podIPs = await klusterService.getHostnames('app=redis,tier=cache')
+```
+
+#### `getServiceHostname(selector: string): Promise<string>`
+
+Retrieves service hostname using a label selector.
+
+**Parameters:**
+- `selector`: Kubernetes label selector
+
+**Returns:** Promise resolving to service hostname
+
+```typescript
+const serviceName = await klusterService.getServiceHostname('app=database')
+```
+
+#### `dispatch<T>(action: string, query: string): Promise<T>`
+
+Dispatches actions for configuration resolution.
+
+**Parameters:**
+- `action`: Action type ('hostname' or 'service')
+- `query`: Query string (label selector or config path)
+
+**Returns:** Promise resolving to action result
+
+```typescript
+const result = await klusterService.dispatch('service', 'app=api-gateway')
+```
+
+#### `makeNetworkingApi(): NetworkingV1Api`
+
+Creates a Kubernetes Networking API client.
+
+**Returns:** NetworkingV1Api instance
+
+```typescript
+const networkingApi = klusterService.makeNetworkingApi()
+const ingresses = await networkingApi.listIngressForAllNamespaces()
+```
+
+### Constants
+
+#### Service Configuration
+```typescript
+const DEFAULT_ALIAS = 'kluster'
+const DEFAULT_NAMESPACE = 'default'
+```
+
+#### Configuration Directives
+```typescript
+const DIRECTIVE = 'kluster'
+const SEP = ':'
+const ACT_HOST = 'hostname'
+const ACT_SERVICE = 'service'
+```
+
+## Usage Examples
+
+### Basic Kubernetes Integration
+
+```typescript
+import { klusterize } from '@owlmeans/kluster'
+import { makeServerContext, makeServerConfig } from '@owlmeans/server-context'
+
+// Create server configuration with Kubernetes settings
+const config = makeServerConfig('k8s-app', {
+  kluster: {
+    namespace: 'production'
+  },
+  port: 8080
+})
+
+// Create and enhance context with Kubernetes capabilities
+const context = makeServerContext(config)
+const k8sContext = klusterize(context)
+
+await k8sContext.configure().init()
+```
+
+### Service Discovery
+
+```typescript
+import { KlusterService } from '@owlmeans/kluster'
+
+// Get Kubernetes service
+const klusterService = context.service<KlusterService>('kluster')
+
+// Discover database service
+const dbServiceName = await klusterService.getServiceHostname('app=postgres,tier=database')
+console.log('Database service:', dbServiceName)
+
+// Get all Redis cache pod IPs
+const redisIPs = await klusterService.getHostnames('app=redis,tier=cache')
+console.log('Redis pods:', redisIPs)
+
+// Connect to discovered service
+const dbConnection = createConnection({
+  host: dbServiceName,
+  port: 5432,
+  database: 'myapp'
+})
+```
+
+### Configuration Directives
+
+```typescript
+// Configuration with Kubernetes directives
+const config = makeServerConfig('microservice', {
+  kluster: {
+    namespace: 'production'
+  },
+  services: {
+    // These will be resolved at runtime using Kubernetes API
+    database: 'kluster:service:app=postgres',
+    cache: 'kluster:service:app=redis',
+    messageQueue: 'kluster:service:app=rabbitmq'
+  },
+  externalServices: {
+    // Resolve to actual pod IPs for load balancing
+    apiNodes: 'kluster:hostname:app=api,tier=backend'
+  }
+})
+
+// After context initialization, directives are resolved
+await context.configure().init()
+
+// Now services contain actual Kubernetes service names
+console.log(context.cfg.services.database) // e.g., "postgres-service"
+console.log(context.cfg.externalServices.apiNodes) // e.g., ["10.1.1.5", "10.1.1.6"]
+```
+
+### Microservice Communication
+
+```typescript
+import { klusterize, KlusterService } from '@owlmeans/kluster'
+
+// Setup microservice with Kubernetes discovery
+const config = makeServerConfig('user-service', {
+  kluster: { namespace: 'microservices' },
+  downstream: {
+    authService: 'kluster:service:app=auth-service',
+    emailService: 'kluster:service:app=email-service',
+    notificationService: 'kluster:service:app=notification-service'
+  }
+})
+
+const context = klusterize(makeServerContext(config))
+await context.configure().init()
+
+// Use discovered services
+async function createUser(userData: UserData) {
+  // Call authentication service
+  const authResponse = await fetch(`http://${context.cfg.downstream.authService}/validate`, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(userData)
+  })
+  
+  if (authResponse.ok) {
+    const user = await saveUser(userData)
+    
+    // Send welcome email
+    await fetch(`http://${context.cfg.downstream.emailService}/send`, {
+      method: 'POST',
+      body: JSON.stringify({
+        to: user.email,
+        template: 'welcome',
+        data: { userName: user.name }
+      })
+    })
+    
+    return user
+  }
+  
+  throw new Error('Authentication failed')
+}
+```
+
+### Load Balancing with Pod Discovery
+
+```typescript
+import { KlusterService } from '@owlmeans/kluster'
+
+class LoadBalancedClient {
+  private klusterService: KlusterService
+  private endpoints: string[] = []
+  private currentIndex = 0
+  
+  constructor(klusterService: KlusterService, private selector: string) {
+    this.klusterService = klusterService
+    this.refreshEndpoints()
+  }
+  
+  private async refreshEndpoints() {
+    try {
+      this.endpoints = await this.klusterService.getHostnames(this.selector)
+      console.log(`Discovered ${this.endpoints.length} endpoints`)
+    } catch (error) {
+      console.error('Failed to refresh endpoints:', error)
+    }
+  }
+  
+  private getNextEndpoint(): string {
+    if (this.endpoints.length === 0) {
+      throw new Error('No available endpoints')
+    }
+    
+    const endpoint = this.endpoints[this.currentIndex]
+    this.currentIndex = (this.currentIndex + 1) % this.endpoints.length
+    return endpoint
+  }
+  
+  async makeRequest(path: string, options: RequestInit = {}) {
+    const endpoint = this.getNextEndpoint()
+    const url = `http://${endpoint}:8080${path}`
+    
+    try {
+      const response = await fetch(url, options)
+      return response
+    } catch (error) {
+      console.error(`Request to ${endpoint} failed:`, error)
+      // Refresh endpoints and retry
+      await this.refreshEndpoints()
+      throw error
+    }
+  }
+}
+
+// Usage
+const klusterService = context.service<KlusterService>('kluster')
+const apiClient = new LoadBalancedClient(klusterService, 'app=api,tier=backend')
+
+const response = await apiClient.makeRequest('/health')
+```
+
+### Health Monitoring
+
+```typescript
+import { KlusterService } from '@owlmeans/kluster'
+
+class HealthMonitor {
+  constructor(
+    private klusterService: KlusterService,
+    private services: Record<string, string>
+  ) {}
+  
+  async checkServiceHealth(): Promise<Record<string, boolean>> {
+    const healthStatus: Record<string, boolean> = {}
+    
+    for (const [serviceName, selector] of Object.entries(this.services)) {
+      try {
+        const serviceHost = await this.klusterService.getServiceHostname(selector)
+        const response = await fetch(`http://${serviceHost}/health`, {
+          timeout: 5000
+        })
+        healthStatus[serviceName] = response.ok
+      } catch (error) {
+        console.error(`Health check failed for ${serviceName}:`, error)
+        healthStatus[serviceName] = false
+      }
+    }
+    
+    return healthStatus
+  }
+  
+  async checkPodHealth(): Promise<Record<string, number>> {
+    const podCounts: Record<string, number> = {}
+    
+    for (const [serviceName, selector] of Object.entries(this.services)) {
+      try {
+        const podIPs = await this.klusterService.getHostnames(selector)
+        podCounts[serviceName] = podIPs.length
+      } catch (error) {
+        console.error(`Pod discovery failed for ${serviceName}:`, error)
+        podCounts[serviceName] = 0
+      }
+    }
+    
+    return podCounts
+  }
+}
+
+// Setup health monitoring
+const healthMonitor = new HealthMonitor(klusterService, {
+  'database': 'app=postgres',
+  'cache': 'app=redis',
+  'api': 'app=api,tier=backend'
+})
+
+// Monitor health every 30 seconds
+setInterval(async () => {
+  const serviceHealth = await healthMonitor.checkServiceHealth()
+  const podCounts = await healthMonitor.checkPodHealth()
+  
+  console.log('Service Health:', serviceHealth)
+  console.log('Pod Counts:', podCounts)
+}, 30000)
+```
+
+### Ingress Management
+
+```typescript
+import { KlusterService } from '@owlmeans/kluster'
+
+async function manageIngress(klusterService: KlusterService) {
+  const networkingApi = klusterService.makeNetworkingApi()
+  
+  // List all ingresses
+  const ingresses = await networkingApi.listIngressForAllNamespaces()
+  console.log('Available ingresses:', ingresses.body.items.map(i => i.metadata?.name))
+  
+  // Create new ingress
+  const ingressManifest = {
+    apiVersion: 'networking.k8s.io/v1',
+    kind: 'Ingress',
+    metadata: {
+      name: 'api-ingress',
+      namespace: 'production'
+    },
+    spec: {
+      rules: [{
+        host: 'api.example.com',
+        http: {
+          paths: [{
+            path: '/',
+            pathType: 'Prefix',
+            backend: {
+              service: {
+                name: 'api-service',
+                port: { number: 80 }
+              }
+            }
+          }]
+        }
+      }]
+    }
+  }
+  
+  try {
+    await networkingApi.createNamespacedIngress('production', ingressManifest)
+    console.log('Ingress created successfully')
+  } catch (error) {
+    console.error('Failed to create ingress:', error)
+  }
+}
+```
+
+### Configuration File Resolution
+
+```typescript
+// config.yaml
+const yamlConfig = `
+database:
+  host: kluster:service:app=postgres
+  port: 5432
+  replicas: kluster:hostname:app=postgres
+
+cache:
+  primary: kluster:service:app=redis-primary
+  replicas: kluster:hostname:app=redis-replica
+
+services:
+  auth: kluster:service:app=auth-service
+  notification: kluster:service:app=notification-service
+`
+
+// Load and process configuration
+import yaml from 'yaml'
+
+const config = yaml.parse(yamlConfig)
+const context = klusterize(makeServerContext(config))
+
+// After initialization, all kluster directives are resolved
+await context.configure().init()
+
+console.log('Resolved configuration:', context.cfg)
+// Output:
+// {
+//   database: { host: 'postgres-service', port: 5432, replicas: ['10.1.1.10', '10.1.1.11'] },
+//   cache: { primary: 'redis-primary-service', replicas: ['10.1.2.20', '10.1.2.21'] },
+//   services: { auth: 'auth-service', notification: 'notification-service' }
+// }
+```
+
+## Error Handling
+
+```typescript
+import { KlusterService } from '@owlmeans/kluster'
+
+async function robustServiceDiscovery(klusterService: KlusterService) {
+  try {
+    // Attempt service discovery
+    const serviceName = await klusterService.getServiceHostname('app=api')
+    return serviceName
+  } catch (error) {
+    console.error('Service discovery failed:', error)
+    
+    // Fallback to default service name
+    return 'api-service'
+  }
+}
+
+// Handle network errors gracefully
+async function resilientPodDiscovery(klusterService: KlusterService, selector: string) {
+  const maxRetries = 3
+  let retries = 0
+  
+  while (retries < maxRetries) {
+    try {
+      const pods = await klusterService.getHostnames(selector)
+      if (pods.length > 0) {
+        return pods
+      }
+      throw new Error('No pods found')
+    } catch (error) {
+      retries++
+      console.warn(`Pod discovery attempt ${retries} failed:`, error.message)
+      
+      if (retries < maxRetries) {
+        // Exponential backoff
+        await new Promise(resolve => setTimeout(resolve, Math.pow(2, retries) * 1000))
+      }
+    }
+  }
+  
+  throw new Error(`Failed to discover pods after ${maxRetries} attempts`)
+}
+```
+
+## Integration Patterns
+
+### Deployment Configuration
+
+```yaml
+# kubernetes-config.yaml
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: app-config
+  namespace: production
+data:
+  config.json: |
+    {
+      "database": "kluster:service:app=postgres",
+      "cache": "kluster:service:app=redis",
+      "messageQueue": "kluster:service:app=rabbitmq"
+    }
+```
+
+```typescript
+// Application code
+import { klusterize } from '@owlmeans/kluster'
+
+const config = makeServerConfig('app', {
+  kluster: { namespace: 'production' },
+  // Configuration loaded from ConfigMap
+  database: 'kluster:service:app=postgres',
+  cache: 'kluster:service:app=redis'
+})
+
+const context = klusterize(makeServerContext(config))
+```
+
+### Helm Chart Integration
+
+```yaml
+# values.yaml
+app:
+  namespace: {{ .Values.namespace }}
+  services:
+    database: "kluster:service:app=postgres"
+    cache: "kluster:service:app=redis"
+
+# deployment.yaml
+apiVersion: apps/v1
+kind: Deployment
+spec:
+  template:
+    spec:
+      containers:
+      - name: app
+        env:
+        - name: KLUSTER_NAMESPACE
+          value: {{ .Values.namespace }}
+```
+
+## Best Practices
+
+1. **Namespace Management**: Always specify appropriate namespaces for service discovery
+2. **Label Consistency**: Use consistent labeling conventions across services
+3. **Error Handling**: Implement robust error handling for network operations
+4. **Caching**: Consider caching service discovery results to reduce API calls
+5. **Security**: Ensure proper RBAC permissions for Kubernetes API access
+6. **Monitoring**: Monitor service discovery operations and cluster health
+7. **Fallbacks**: Provide fallback mechanisms when service discovery fails
+
+## Dependencies
+
+This package depends on:
+- `@owlmeans/config` - Configuration management
+- `@owlmeans/context` - Context management system
+- `@owlmeans/server-config` - Server configuration utilities
+- `@owlmeans/server-context` - Server context management
+- `@kubernetes/client-node` - Official Kubernetes client library
+
+## Related Packages
+
+- [`@owlmeans/server-app`](../server-app) - Server application framework
+- [`@owlmeans/server-context`](../server-context) - Server context management
+- [`@owlmeans/config`](../config) - Configuration management system

package/build/consts.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_ALIAS = "kluster";
+export declare const DIRECTIVE = "kluster";
+export declare const SEP = ":";
+export declare const DEFAULT_NAMESPACE = "default";
+export declare const ACT_HOST = "hostname";
+export declare const ACT_SERVICE = "service";
+//# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC,eAAO,MAAM,SAAS,YAAY,CAAA;AAElC,eAAO,MAAM,GAAG,MAAM,CAAA;AAEtB,eAAO,MAAM,iBAAiB,YAAY,CAAA;AAE1C,eAAO,MAAM,QAAQ,aAAa,CAAA;AAElC,eAAO,MAAM,WAAW,YAAY,CAAA"}

package/build/consts.js

@@ -0,0 +1,7 @@
+export const DEFAULT_ALIAS = 'kluster';
+export const DIRECTIVE = 'kluster';
+export const SEP = ':';
+export const DEFAULT_NAMESPACE = 'default';
+export const ACT_HOST = 'hostname';
+export const ACT_SERVICE = 'service';
+//# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAA;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAG,SAAS,CAAA;AAElC,MAAM,CAAC,MAAM,GAAG,GAAG,GAAG,CAAA;AAEtB,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAE1C,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAA;AAElC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAA"}

package/build/helper.d.ts

@@ -0,0 +1,5 @@
+import type { BasicContext, Middleware } from '@owlmeans/context';
+import type { KlusterConfig } from './types.js';
+export declare const klusterize: <C extends KlusterConfig, T extends BasicContext<C>>(context: T, alias?: string) => T;
+export declare const createMiddleware: (alias?: string) => Middleware;
+//# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAIjE,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,YAAY,CAAA;AAE/D,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,aAAa,EAAE,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,UAAS,MAAM,KAAmB,CAQ1H,CAAA;AAED,eAAO,MAAM,gBAAgB,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,UAiBjD,CAAA"}

package/build/helper.js

@@ -0,0 +1,26 @@
+import { DEFAULT_ALIAS, DIRECTIVE, SEP } from './consts.js';
+import { makeKlusterService } from './service.js';
+import { MiddlewareStage, MiddlewareType } from '@owlmeans/context';
+import { visitConfigLeafs } from '@owlmeans/config/utils';
+export const klusterize = (context, alias = DEFAULT_ALIAS) => {
+    const service = makeKlusterService(alias);
+    context.registerService(service);
+    context.registerMiddleware(createMiddleware(alias));
+    return context;
+};
+export const createMiddleware = (alias = DEFAULT_ALIAS) => ({
+    type: MiddlewareType.Config,
+    stage: MiddlewareStage.Loading,
+    apply: async (context) => {
+        await visitConfigLeafs(context.cfg, async (value) => {
+            if (value.startsWith(DIRECTIVE + SEP)) {
+                const service = context.service(alias);
+                await service.ready?.();
+                const [, directive, query] = value.split(SEP, 3);
+                value = await service.dispatch(directive, query);
+            }
+            return value;
+        });
+    }
+});
+//# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAIzD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAqD,OAAU,EAAE,QAAgB,aAAa,EAAK,EAAE;IAC7H,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAEzC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IAEhC,OAAO,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAA;IAEnD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAmC,CAAC,KAAK,GAAG,aAAa,EAAE,EAAE,CAAC,CAAC;IAC1F,IAAI,EAAE,cAAc,CAAC,MAAM;IAE3B,KAAK,EAAE,eAAe,CAAC,OAAO;IAE9B,KAAK,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;QACrB,MAAM,gBAAgB,CAAC,OAAO,CAAC,GAAsB,EAAE,KAAK,EAAC,KAAK,EAAC,EAAE;YACnE,IAAI,KAAK,CAAC,UAAU,CAAC,SAAS,GAAG,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAiB,KAAK,CAAC,CAAA;gBACtD,MAAM,OAAO,CAAC,KAAK,EAAE,EAAE,CAAA;gBACvB,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAA;gBAChD,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAA;YAClD,CAAC;YAED,OAAO,KAAK,CAAA;QACd,CAAC,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA"}

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export * from './consts.js';
+export * from './service.js';
+export * from './types.js';
+export * from './helper.js';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/build/index.js

@@ -0,0 +1,5 @@
+export * from './consts.js';
+export * from './service.js';
+export * from './types.js';
+export * from './helper.js';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/build/service.d.ts

@@ -0,0 +1,3 @@
+import type { KlusterService } from './types.js';
+export declare const makeKlusterService: (alias?: string) => KlusterService;
+//# sourceMappingURL=service.d.ts.map

package/build/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,YAAY,CAAA;AAS/D,eAAO,MAAM,kBAAkB,WAAW,MAAM,KAAmB,cAyElE,CAAA"}

package/build/service.js

@@ -0,0 +1,68 @@
+import { ACT_HOST, ACT_SERVICE, DEFAULT_ALIAS, DEFAULT_NAMESPACE } from './consts.js';
+import { assertContext, createLazyService } from '@owlmeans/context';
+import { KubeConfig, CoreV1Api, HttpError, NetworkingV1Api } from '@kubernetes/client-node';
+import { readConfigValue } from '@owlmeans/server-config';
+export const makeKlusterService = (alias = DEFAULT_ALIAS) => {
+    const location = `kluster:${alias}`;
+    const updateSelector = (selector) => selector.startsWith('/') || selector.startsWith('file:')
+        ? readConfigValue(selector, selector) : selector;
+    const service = createLazyService(alias, {
+        getHostnames: async (selector) => {
+            try {
+                const ctx = assertContext(service.ctx, location);
+                const namespace = ctx.cfg.kluster?.namespace ?? DEFAULT_NAMESPACE;
+                const { body } = await service.api.listNamespacedPod(namespace, undefined, undefined, undefined, undefined, selector);
+                return body.items.map(item => item.status?.podIP).filter(name => name != null);
+            }
+            catch (e) {
+                if (e instanceof HttpError) {
+                    console.error(e.name, e.cause, e.message, e.body);
+                }
+                else {
+                    throw e;
+                }
+                return [];
+            }
+        },
+        getServiceHostname: async (selector) => {
+            try {
+                const ctx = assertContext(service.ctx, location);
+                const namespace = ctx.cfg.kluster?.namespace ?? DEFAULT_NAMESPACE;
+                const { body } = await service.api.listNamespacedService(namespace, undefined, undefined, undefined, undefined, selector);
+                if (body.items[0] == null) {
+                    return selector;
+                }
+                return body.items[0].metadata?.name ?? selector;
+            }
+            catch (e) {
+                if (e instanceof HttpError) {
+                    console.error(e.name, e.cause, e.message, e.body);
+                }
+                else {
+                    throw e;
+                }
+                return selector;
+            }
+        },
+        dispatch: async (action, query) => {
+            query = updateSelector(query);
+            switch (action) {
+                case ACT_HOST:
+                    return service.getHostnames(query);
+                case ACT_SERVICE:
+                    return service.getServiceHostname(query);
+            }
+            throw new SyntaxError(`Unknown kluster directive: ${action}`);
+        },
+        makeNetworkingApi: () => service.config.makeApiClient(NetworkingV1Api)
+    }, service => async () => {
+        if (service.config == null || service.api == null) {
+            service.config = new KubeConfig();
+            service.config.loadFromDefault();
+            service.api = service.config.makeApiClient(CoreV1Api);
+        }
+        service.initialized = true;
+    });
+    return service;
+};
+//# sourceMappingURL=service.js.map

package/build/service.js.map

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

package/build/types.d.ts

@@ -0,0 +1,17 @@
+import type { LazyService } from '@owlmeans/context';
+import type { KubeConfig, CoreV1Api, NetworkingV1Api } from '@kubernetes/client-node';
+import type { ServerConfig } from '@owlmeans/server-context';
+export interface KlusterService extends LazyService {
+    config?: KubeConfig;
+    api?: CoreV1Api;
+    getHostnames: (selector: string) => Promise<string[]>;
+    getServiceHostname: (selector: string) => Promise<string>;
+    dispatch: <T>(action: string, query: string) => Promise<T>;
+    makeNetworkingApi: () => NetworkingV1Api;
+}
+export interface KlusterConfig extends ServerConfig {
+    kluster?: {
+        namespace?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,GAAG,CAAC,EAAE,SAAS,CAAA;IAEf,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAErD,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAEzD,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAE1D,iBAAiB,EAAE,MAAM,eAAe,CAAA;CACzC;AAED,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,OAAO,CAAC,EAAE;QACR,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;CACF"}

package/build/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/build/types.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@owlmeans/kluster",
+  "version": "0.1.0",
+  "type": "module",
+  "scripts": {
+    "build": "tsc -b",
+    "dev": "sleep 180 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
+    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+  },
+  "main": "build/index.js",
+  "module": "build/index.js",
+  "types": "build/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./build/index.js",
+      "require": "./build/index.js",
+      "default": "./build/index.js",
+      "module": "./build/index.js",
+      "types": "./build/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@kubernetes/client-node": "^0.22.0",
+    "@owlmeans/config": "^0.1.0",
+    "@owlmeans/context": "^0.1.0",
+    "@owlmeans/server-config": "^0.1.0",
+    "@owlmeans/server-context": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.8",
+    "nodemon": "^3.1.7",
+    "typescript": "^5.6.3"
+  },
+  "private": false,
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/consts.ts

@@ -0,0 +1,12 @@
+
+export const DEFAULT_ALIAS = 'kluster'
+
+export const DIRECTIVE = 'kluster'
+
+export const SEP = ':'
+
+export const DEFAULT_NAMESPACE = 'default'
+
+export const ACT_HOST = 'hostname'
+
+export const ACT_SERVICE = 'service'

package/src/helper.ts

@@ -0,0 +1,36 @@
+import { DEFAULT_ALIAS, DIRECTIVE, SEP } from './consts.js'
+import { makeKlusterService } from './service.js'
+import type { BasicContext, Middleware } from '@owlmeans/context'
+import { MiddlewareStage, MiddlewareType } from '@owlmeans/context'
+import { visitConfigLeafs } from '@owlmeans/config/utils'
+import type { Tree } from '@owlmeans/config/utils'
+import type { KlusterConfig, KlusterService } from './types.js'
+
+export const klusterize = <C extends KlusterConfig, T extends BasicContext<C>>(context: T, alias: string = DEFAULT_ALIAS): T => {
+  const service = makeKlusterService(alias)
+
+  context.registerService(service)
+
+  context.registerMiddleware(createMiddleware(alias))
+
+  return context
+}
+
+export const createMiddleware: (alias?: string) => Middleware = (alias = DEFAULT_ALIAS) => ({
+  type: MiddlewareType.Config,
+
+  stage: MiddlewareStage.Loading,
+
+  apply: async context => {
+    await visitConfigLeafs(context.cfg as unknown as Tree, async value => {
+      if (value.startsWith(DIRECTIVE + SEP)) {
+        const service = context.service<KlusterService>(alias)
+        await service.ready?.()
+        const [, directive, query] = value.split(SEP, 3)
+        value = await service.dispatch(directive, query)
+      }
+
+      return value
+    })
+  }
+})

package/src/index.ts

@@ -0,0 +1,5 @@
+
+export * from './consts.js'
+export * from './service.js'
+export * from './types.js'
+export * from './helper.js'

package/src/service.ts

@@ -0,0 +1,84 @@
+import { ACT_HOST, ACT_SERVICE, DEFAULT_ALIAS, DEFAULT_NAMESPACE } from './consts.js'
+import type { KlusterConfig, KlusterService } from './types.js'
+import { assertContext, createLazyService } from '@owlmeans/context'
+import { KubeConfig, CoreV1Api, HttpError, NetworkingV1Api } from '@kubernetes/client-node'
+import { ServerContext } from '@owlmeans/server-context'
+import { readConfigValue } from '@owlmeans/server-config'
+
+type Config = KlusterConfig
+type Context = ServerContext<Config>
+
+export const makeKlusterService = (alias: string = DEFAULT_ALIAS): KlusterService => {
+  const location = `kluster:${alias}`
+
+  const updateSelector = (selector: string): string =>
+    selector.startsWith('/') || selector.startsWith('file:')
+      ? readConfigValue(selector, selector) : selector
+
+  const service: KlusterService = createLazyService<KlusterService>(alias, {
+    getHostnames: async selector => {
+      try {
+        const ctx = assertContext<Config, Context>(service.ctx as Context, location)
+        const namespace = ctx.cfg.kluster?.namespace ?? DEFAULT_NAMESPACE
+
+        const { body } = await service.api!.listNamespacedPod(
+          namespace, undefined, undefined, undefined, undefined, selector
+        )
+
+        return body.items.map(item => item.status?.podIP).filter(name => name != null)
+      } catch (e) {
+        if (e instanceof HttpError) {
+          console.error(e.name, e.cause, e.message, e.body)
+        } else {
+          throw e
+        }
+        return []
+      }
+    },
+
+    getServiceHostname: async selector => {
+      try {
+        const ctx = assertContext<Config, Context>(service.ctx as Context, location)
+        const namespace = ctx.cfg.kluster?.namespace ?? DEFAULT_NAMESPACE
+
+        const { body } = await service.api!.listNamespacedService(namespace, undefined, undefined, undefined, undefined, selector)
+
+        if (body.items[0] == null) {
+          return selector
+        }
+
+        return body.items[0].metadata?.name ?? selector
+      } catch (e) {
+        if (e instanceof HttpError) {
+          console.error(e.name, e.cause, e.message, e.body)
+        } else {
+          throw e
+        }
+        return selector
+      }
+    },
+
+    dispatch: async <T>(action: string, query: string) => {
+      query = updateSelector(query)
+      switch (action) {
+        case ACT_HOST:
+          return service.getHostnames(query) as T
+        case ACT_SERVICE:
+          return service.getServiceHostname(query) as T
+      }
+      throw new SyntaxError(`Unknown kluster directive: ${action}`)
+    },
+
+    makeNetworkingApi: () => service.config!.makeApiClient(NetworkingV1Api)
+  }, service => async () => {
+    if (service.config == null || service.api == null) {
+      service.config = new KubeConfig()
+      service.config.loadFromDefault()
+      service.api = service.config.makeApiClient(CoreV1Api)
+    }
+
+    service.initialized = true
+  })
+
+  return service
+}

package/src/types.ts

@@ -0,0 +1,22 @@
+import type { LazyService } from '@owlmeans/context'
+import type { KubeConfig, CoreV1Api, NetworkingV1Api } from '@kubernetes/client-node'
+import type { ServerConfig } from '@owlmeans/server-context'
+
+export interface KlusterService extends LazyService {
+  config?: KubeConfig
+  api?: CoreV1Api
+
+  getHostnames: (selector: string) => Promise<string[]>
+
+  getServiceHostname: (selector: string) => Promise<string>
+
+  dispatch: <T>(action: string, query: string) => Promise<T>
+
+  makeNetworkingApi: () => NetworkingV1Api
+}
+
+export interface KlusterConfig extends ServerConfig {
+  kluster?: {
+    namespace?: string
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": [
+    "../tsconfig.default.json",
+  ],
+  "compilerOptions": {
+    "rootDir": "./src/", /* Specify the root folder within your source files. */
+    "outDir": "./build/", /* Specify an output folder for all emitted files. */
+    "moduleResolution": "Bundler"
+  },
+  "exclude": [
+    "./dist/**/*",
+    "./build/**/*",
+    "./*.ts"
+  ]
+}

package/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["./src/consts.ts","./src/helper.ts","./src/index.ts","./src/service.ts","./src/types.ts"],"version":"5.6.3"}