@crossdelta/infrastructure 0.2.27 → 0.3.0-beta.1

package/dist/runtimes/doks/types.d.ts

@@ -1,5 +1,6 @@
 import type * as digitalocean from '@pulumi/digitalocean';
 import type * as pulumi from '@pulumi/pulumi';
+import type { ServicePorts } from '../../core/types';
 /** DigitalOcean Kubernetes Cluster Args (from @pulumi/digitalocean) */
 export type DOKSClusterArgs = digitalocean.KubernetesClusterArgs;
 /** DigitalOcean VPC Args (from @pulumi/digitalocean) */
@@ -202,8 +203,43 @@ export interface K8sServiceConfig {
      * If not specified, auto-generated from pf.registry config + service name.
      */
     image?: string;
-    /** Port the container listens on */
-    containerPort: number;
+    /**
+     * Unified port configuration (recommended).
+     *
+     * Use the fluent ports API for cleaner configuration:
+     * @example
+     * ```typescript
+     * import { ports } from '@crossdelta/infrastructure'
+     *
+     * // Simple HTTP service
+     * ports: ports().http(8080).public().build()
+     *
+     * // Multi-port service (e.g., NATS)
+     * ports: ports()
+     *   .primary(4222, 'client')
+     *   .add(8222, 'monitoring')
+     *   .add(6222, 'routing')
+     *   .build()
+     * ```
+     */
+    ports?: ServicePorts;
+    /**
+     * Port the container listens on (legacy, deprecated).
+     *
+     * @deprecated Use `ports` instead for better multi-port support.
+     * This field is auto-converted to `ports` internally for backward compatibility.
+     * Will be removed in v0.4.0.
+     *
+     * @example
+     * ```typescript
+     * // Old way (still works)
+     * containerPort: 3000
+     *
+     * // New way (recommended)
+     * ports: ports().http(3000).build()
+     * ```
+     */
+    containerPort?: number;
     /** Number of replicas (defaults to 1) */
     replicas?: number;
     /** Environment variables (plain values) */
@@ -232,7 +268,13 @@ export interface K8sServiceConfig {
     skip?: boolean;
     /** Image pull policy (defaults to 'Always' for :latest, 'IfNotPresent' otherwise) */
     imagePullPolicy?: 'Always' | 'Never' | 'IfNotPresent';
-    /** Additional ports to expose (for services with multiple ports) */
+    /**
+     * Additional ports to expose (legacy, deprecated).
+     *
+     * @deprecated Use `ports.additional` instead.
+     * This field is auto-converted to `ports.additional` internally for backward compatibility.
+     * Will be removed in v0.4.0.
+     */
     additionalPorts?: Array<{
         name: string;
         port: number;

package/dist/runtimes/doks/workloads.d.ts

@@ -13,11 +13,11 @@ import type { DeployK8sServicesOptions, K8sServiceConfig, K8sServiceDeploymentRe
  * })
  * ```
  */
-export declare function createImagePullSecret(provider: k8s.Provider, namespace: string, name: string, config: {
+export declare const createImagePullSecret: (provider: k8s.Provider, namespace: string, name: string, config: {
     registry: string;
     username: pulumi.Input<string>;
     password: pulumi.Input<string>;
-}): k8s.core.v1.Secret;
+}) => k8s.core.v1.Secret;
 /**
  * Deploys a service to Kubernetes.
  *
@@ -50,7 +50,7 @@ export declare function createImagePullSecret(provider: k8s.Provider, namespace:
  * // http://orders.orderboss.svc.cluster.local:4001
  * ```
  */
-export declare function deployK8sService(provider: k8s.Provider, namespace: string, config: K8sServiceConfig): K8sServiceDeploymentResult;
+export declare const deployK8sService: (provider: k8s.Provider, namespace: string, config: K8sServiceConfig) => K8sServiceDeploymentResult;
 /**
  * Deploys multiple services to Kubernetes.
  *
@@ -63,7 +63,7 @@ export declare function deployK8sService(provider: k8s.Provider, namespace: stri
  * ], { imagePullSecretName: 'ghcr-secret' })
  * ```
  */
-export declare function deployK8sServices(provider: k8s.Provider, namespace: string, configs: K8sServiceConfig[], options?: DeployK8sServicesOptions): Map<string, K8sServiceDeploymentResult>;
+export declare const deployK8sServices: (provider: k8s.Provider, namespace: string, configs: K8sServiceConfig[], options?: DeployK8sServicesOptions) => Map<string, K8sServiceDeploymentResult>;
 /**
  * Creates a Kubernetes namespace.
  *
@@ -72,8 +72,8 @@ export declare function deployK8sServices(provider: k8s.Provider, namespace: str
  * const ns = createNamespace(provider, 'orderboss')
  * ```
  */
-export declare function createNamespace(provider: k8s.Provider, name: string, labels?: Record<string, string>): k8s.core.v1.Namespace;
+export declare const createNamespace: (provider: k8s.Provider, name: string, labels?: Record<string, string>) => k8s.core.v1.Namespace;
 /**
  * Builds an internal service URL for cluster-internal communication.
  */
-export declare function buildInternalUrl(serviceName: string, namespace: string, port: number): string;
+export declare const buildInternalUrl: (serviceName: string, namespace: string, port: number) => string;

package/dist/runtimes/local/docker-compose.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Docker Compose Runtime for Local Development
+ *
+ * Simplified local development without Kubernetes complexity.
+ * Perfect for running simple services quickly.
+ */
+import type { K8sServiceConfig } from '../doks/types';
+import type { ComposeProjectConfig, ComposeServiceConfig } from './types';
+/**
+ * Convert K8sServiceConfig to Docker Compose service
+ *
+ * @param config - Kubernetes service configuration
+ * @returns Docker Compose service configuration
+ */
+export declare const convertToComposeService: (config: K8sServiceConfig) => ComposeServiceConfig;
+/**
+ * Generate Docker Compose YAML from K8sServiceConfigs
+ *
+ * @param services - Services to include in docker-compose.yml
+ * @param projectName - Project name (default: 'orderboss-local')
+ * @returns Docker Compose project configuration
+ */
+export declare const generateComposeProject: (services: K8sServiceConfig[], projectName?: string) => ComposeProjectConfig;
+/**
+ * Generate docker-compose.yml content
+ *
+ * @param project - Docker Compose project configuration
+ * @returns YAML string for docker-compose.yml
+ */
+export declare const generateComposeYaml: (project: ComposeProjectConfig) => string;
+/**
+ * Generate setup script for Docker Compose
+ *
+ * @param services - Services to deploy
+ * @param projectName - Project name
+ * @returns Shell script to setup local environment
+ */
+export declare const generateComposeSetupScript: (services: K8sServiceConfig[], projectName?: string) => string;

package/dist/runtimes/local/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Local Development Provider
+ *
+ * Enables local Kubernetes development using k3d or simple Docker Compose setups.
+ * Perfect for testing infrastructure configs before deploying to production.
+ */
+export * from './docker-compose';
+export * from './k3d';
+export * from './types';

package/dist/runtimes/local/k3d.d.ts

@@ -0,0 +1,58 @@
+/**
+ * k3d Runtime for Local Kubernetes Development
+ *
+ * Provides utilities to create and manage local k3d clusters for testing
+ * Kubernetes configurations before deploying to production.
+ *
+ * @see https://k3d.io/
+ */
+import type { K8sServiceConfig } from '../doks/types';
+import type { K3dClusterConfig, LocalProviderOptions } from './types';
+/**
+ * Generate k3d cluster creation command
+ *
+ * @param config - k3d cluster configuration
+ * @returns Shell command to create k3d cluster
+ *
+ * @example
+ * ```typescript
+ * const cmd = generateK3dCreateCommand({ name: 'my-cluster' })
+ * console.log(cmd)
+ * // k3d cluster create my-cluster --servers 1 --agents 1 ...
+ * ```
+ */
+export declare const generateK3dCreateCommand: (config?: K3dClusterConfig) => string;
+/**
+ * Generate k3d cluster deletion command
+ *
+ * @param clusterName - Name of cluster to delete
+ * @returns Shell command to delete k3d cluster
+ */
+export declare const generateK3dDeleteCommand: (clusterName?: string) => string;
+/**
+ * Convert K8sServiceConfig to kubectl apply command
+ *
+ * Generates a kubectl command that creates:
+ * - Deployment
+ * - Service (if ports configured)
+ * - Ingress (if public ports)
+ *
+ * @param config - Service configuration
+ * @param namespace - Kubernetes namespace
+ * @returns Shell command to apply resources
+ */
+export declare const generateKubectlApplyCommand: (config: K8sServiceConfig, namespace?: string) => string;
+/**
+ * Setup script for local k3d development
+ *
+ * Generates a complete shell script that:
+ * 1. Creates k3d cluster
+ * 2. Waits for cluster to be ready
+ * 3. Creates namespace
+ * 4. Deploys all services
+ *
+ * @param services - Services to deploy
+ * @param options - Local provider options
+ * @returns Complete setup script
+ */
+export declare const generateLocalSetupScript: (services: K8sServiceConfig[], options?: LocalProviderOptions) => string;

package/dist/runtimes/local/types.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Local Development Provider Types
+ *
+ * Enables local Kubernetes development using k3d or simple Docker Compose setups.
+ * Perfect for testing infrastructure configs before deploying to production.
+ */
+import type { CoreServiceConfig } from '../../core/types';
+/**
+ * Base configuration for local development services
+ */
+export interface LocalServiceConfig extends CoreServiceConfig {
+    provider: 'local';
+}
+/**
+ * k3d cluster configuration for local Kubernetes development
+ *
+ * @see https://k3d.io/
+ */
+export interface K3dClusterConfig {
+    /** Cluster name (default: 'orderboss-local') */
+    name?: string;
+    /** Number of server nodes (default: 1) */
+    servers?: number;
+    /** Number of agent nodes (default: 1) */
+    agents?: number;
+    /** Port mappings for ingress (default: [{ host: 8080, container: 80 }]) */
+    ports?: Array<{
+        host: number;
+        container: number;
+        protocol?: 'tcp' | 'udp';
+    }>;
+    /** Registry to use (default: k3d-managed registry on port 5000) */
+    registry?: {
+        name?: string;
+        port?: number;
+        host?: string;
+    };
+    /** K3s version to use (default: latest) */
+    k3sVersion?: string;
+    /** Additional k3d options */
+    options?: {
+        /** Wait for cluster to be ready (default: true) */
+        wait?: boolean;
+        /** Timeout in seconds (default: 60) */
+        timeout?: number;
+        /** API port on host (default: 6550) */
+        apiPort?: number;
+    };
+}
+/**
+ * Docker Compose service configuration
+ *
+ * Simplified local development without Kubernetes complexity.
+ */
+export interface ComposeServiceConfig {
+    /** Service name */
+    name: string;
+    /** Docker image */
+    image: string;
+    /** Port mappings (host:container) */
+    ports?: string[];
+    /** Environment variables */
+    environment?: Record<string, string>;
+    /** Volume mappings */
+    volumes?: string[];
+    /** Service dependencies */
+    dependsOn?: string[];
+    /** Command override */
+    command?: string | string[];
+    /** Health check */
+    healthCheck?: {
+        test: string | string[];
+        interval?: string;
+        timeout?: string;
+        retries?: number;
+        startPeriod?: string;
+    };
+    /** Restart policy (default: 'unless-stopped') */
+    restart?: 'no' | 'always' | 'on-failure' | 'unless-stopped';
+    /** Networks to join */
+    networks?: string[];
+    /** Labels */
+    labels?: Record<string, string>;
+}
+/**
+ * Docker Compose project configuration
+ */
+export interface ComposeProjectConfig {
+    /** Project name */
+    name: string;
+    /** Services */
+    services: ComposeServiceConfig[];
+    /** Networks */
+    networks?: Record<string, {
+        driver?: string;
+        external?: boolean;
+    }>;
+    /** Volumes */
+    volumes?: Record<string, {
+        driver?: string;
+        external?: boolean;
+    }>;
+}
+/**
+ * Local provider options
+ */
+export interface LocalProviderOptions {
+    /** Runtime to use (default: 'k3d') */
+    runtime?: 'k3d' | 'docker-compose';
+    /** k3d cluster configuration (for runtime='k3d') */
+    k3d?: K3dClusterConfig;
+    /** Compose project configuration (for runtime='docker-compose') */
+    compose?: Partial<ComposeProjectConfig>;
+    /** Namespace for Kubernetes resources (default: 'default') */
+    namespace?: string;
+    /** Auto-create namespace if it doesn't exist (default: true) */
+    autoCreateNamespace?: boolean;
+}

package/dist/types/index.d.ts

@@ -1,153 +1,19 @@
-import type { AppSpecService } from '@pulumi/digitalocean/types/input';
 /**
- * Supported container registry types for DigitalOcean App Platform.
- */
-export declare const RegistryType: {
-    /** Docker Hub - public or private images */
-    readonly DOCKER_HUB: "DOCKER_HUB";
-    /** GitHub Container Registry */
-    readonly GHCR: "GHCR";
-    /** DigitalOcean Container Registry */
-    readonly DOCR: "DOCR";
-};
-export type RegistryType = (typeof RegistryType)[keyof typeof RegistryType];
-/**
- * Image configuration for a service.
- */
-export interface ImageConfig {
-    /** Registry type */
-    registryType: RegistryType;
-    /** Registry name (e.g., 'library' for official Docker Hub images, 'orderboss' for GHCR) */
-    registry: string;
-    /** Repository name (e.g., 'nats', 'platform/storefront') */
-    repository: string;
-    /** Image tag (e.g., '2.10-alpine', 'latest') */
-    tag: string;
-}
-/**
- * Platform type for service deployment.
- */
-export declare const Platform: {
-    /** DigitalOcean App Platform (default) */
-    readonly APP_PLATFORM: "app-platform";
-    /** DigitalOcean Droplet with Docker */
-    readonly DROPLET: "droplet";
-};
-export type Platform = (typeof Platform)[keyof typeof Platform];
-/**
- * Volume configuration for persistent storage (Droplet only).
- */
-export interface VolumeConfig {
-    /** Volume name (must be unique) */
-    name: string;
-    /** Mount path inside the container */
-    mountPath: string;
-    /** Size in GB */
-    sizeGb: number;
-    /** Optional description for the volume */
-    description?: string;
-}
-/**
- * Droplet-specific configuration options.
- */
-export interface DropletConfig {
-    /** Droplet size slug (e.g., 's-1vcpu-1gb') */
-    size: string;
-    /** Persistent volumes to attach */
-    volumes?: VolumeConfig[];
-    /** Firewall rules for VPC access */
-    vpcPorts?: number[];
-    /** Ports to open for all IPs (use for App Platform access) */
-    publicPorts?: number[];
-    /** Environment variables to pass to the Docker container */
-    envVars?: Record<string, string>;
-    /** Additional Docker run arguments */
-    dockerArgs?: string;
-    /**
-     * Config file to mount into the container.
-     * The content will be written to the Droplet and mounted into Docker.
-     */
-    configFile?: {
-        /** Path inside the container (e.g., '/etc/nats/nats.conf') */
-        containerPath: string;
-        /** File content (will be written to Droplet) */
-        content: string;
-    };
-}
-/**
- * Configuration for a service that will be deployed to DigitalOcean App Platform.
- * Each service in infra/services/*.ts should export a default object of this type.
+ * @crossdelta/infrastructure - Type Definitions
  *
- * ## Port Configuration
+ * This file contains shared type definitions that don't belong to a specific
+ * runtime (DOKS, EKS, AKS, etc.).
  *
- * Services can expose ports in two ways:
+ * For runtime-specific types, see:
+ * - Kubernetes (DOKS/EKS/AKS/GKE): lib/runtimes/doks/types.ts
+ * - Local development: lib/runtimes/local/types.ts (coming soon)
  *
- * - `httpPort`: Public HTTP port with ingress routing (requires `ingressPrefix`)
- * - `internalPorts`: Internal-only ports, not publicly accessible
+ * @deprecated The following types are DEPRECATED (removed in v0.4.0):
+ * - ServiceConfig (use K8sServiceConfig instead)
+ * - Platform enum (use Provider enum from core/types.ts)
+ * - RegistryType, ImageConfig (use simple string URLs)
+ * - VolumeConfig, DropletConfig (moved to DOKS types)
  *
- * The **first port** (httpPort or internalPorts[0]) is used as the primary port for:
- * - `<SERVICE>_PORT` environment variable
- * - `<SERVICE>_URL` environment variable (unless `internalUrl` is set)
- *
- * ## Platform Selection
- *
- * By default, services run on App Platform. Set `platform: 'droplet'` for services
- * that need persistent storage or special networking (e.g., NATS with JetStream).
- *
- * ## Examples
- *
- * ```ts
- * // Public service on App Platform (API Gateway)
- * { httpPort: 4000, ingressPrefix: '/api' }
- *
- * // Internal-only service on App Platform (Orders)
- * { internalPorts: [4001] }
- *
- * // Service on Droplet with persistent volume (NATS)
- * {
- *   platform: 'droplet',
- *   internalPorts: [4222, 8222],
- *   internalUrl: 'nats://nats:4222',
- *   droplet: {
- *     size: 's-1vcpu-1gb',
- *     volumes: [{ name: 'nats-data', mountPath: '/data', sizeGb: 10 }],
- *   },
- * }
- * ```
- *
- * @see https://docs.digitalocean.com/reference/api/digitalocean/#tag/Apps
- */
-export type ServiceConfig = Partial<Omit<AppSpecService, 'image'>> & {
-    /** Unique name of the service (required) */
-    name: string;
-    /**
-     * Deployment platform. Defaults to 'app-platform'.
-     * Use 'droplet' for services that need persistent storage or special networking.
-     */
-    platform?: Platform;
-    /**
-     * Ingress path prefix for public routing (e.g., '/api').
-     * Only used when `httpPort` is set. Services with only `internalPorts` cannot have ingress.
-     */
-    ingressPrefix?: string;
-    /** Set to true to exclude this service from deployment */
-    skip?: boolean;
-    /** Custom image configuration (defaults to GHCR image based on service name) */
-    image?: ImageConfig;
-    /**
-     * Override the internal URL for service-to-service communication.
-     * Use this for non-HTTP protocols (e.g., 'nats://nats:4222').
-     * If not set, defaults to `http://{name}:{primaryPort}`.
-     */
-    internalUrl?: string;
-    /**
-     * Droplet-specific configuration. Only used when `platform: 'droplet'`.
-     */
-    droplet?: DropletConfig;
-};
-/**
- * Full service spec after merging with common config.
- * This is what gets passed to the DigitalOcean App spec.
+ * See MIGRATION.md for upgrade guide.
  */
-export type FullServiceSpec = AppSpecService;
 export * from './service-names';

package/dist/types/service-names.d.ts

@@ -6,4 +6,4 @@
  * Known service names in the platform.
  * This type is auto-generated from infra/services/*.ts
  */
-export type ServiceName = 'nats' | 'orders' | 'storefront' | 'api-gateway';
+export type ServiceName = 'my-hono-service' | 'orders' | 'notifications' | 'storefront' | 'api-gateway';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/infrastructure",
-  "version": "0.2.27",
+  "version": "0.3.0-beta.1",
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -40,6 +40,7 @@
     "@pulumi/pulumi": "^3.208.0",
     "@types/bun": "latest",
     "@types/node": "^24.10.1",
+    "bun-types": "^1.3.4",
     "typescript": "^5.9.3"
   },
   "scripts": {
@@ -47,6 +48,6 @@
     "prepublishOnly": "bun run build",
     "generate-env": "bun run cli/commands/generate-env.ts",
     "lint": "biome lint --fix",
-    "test": "echo \"No tests specified\" && exit 0"
+    "test": "bun test"
   }
 }

package/dist/helpers/config.d.ts

@@ -1,29 +0,0 @@
-import type { Input } from '@pulumi/pulumi';
-/**
- * Ensures that a string ends with a dot (useful for DNS CNAME values).
- */
-export declare const ensureDot: (str: string) => string;
-/**
- * Common alert configuration for services
- */
-export declare const defaultAlerts: {
-    rule: string;
-    operator: string;
-    value: number;
-    window: string;
-}[];
-/**
- * Creates log destinations config with Logtail token
- */
-export declare const createLogDestinations: (logtailToken: Input<string>) => {
-    name: string;
-    logtail: {
-        token: Input<string>;
-    };
-}[];
-/**
- * Default health check configuration
- */
-export declare const defaultHealthCheck: {
-    httpPath: string;
-};

package/dist/helpers/droplet-builder.d.ts

@@ -1,44 +0,0 @@
-import * as digitalocean from '@pulumi/digitalocean';
-import * as pulumi from '@pulumi/pulumi';
-import type { ServiceConfig } from '../types';
-export interface DropletServiceResources {
-    droplet: digitalocean.Droplet;
-    volume?: digitalocean.Volume;
-    volumeAttachment?: digitalocean.VolumeAttachment;
-    firewall?: digitalocean.Firewall;
-    /** Private IP for VPC communication */
-    privateIp: pulumi.Output<string>;
-}
-/**
- * Environment variables that can contain Pulumi secrets.
- */
-export type SecretEnvVars = Record<string, pulumi.Output<string> | string>;
-export interface BuildDropletServicesOptions {
-    /** Service configs with platform: 'droplet' */
-    serviceConfigs: ServiceConfig[];
-    /** DigitalOcean region (e.g., 'fra1') */
-    region: string;
-    /** VPC UUID for private networking */
-    vpcUuid: pulumi.Input<string>;
-    /** SSH key IDs for Droplet access (optional) */
-    sshKeyIds?: pulumi.Input<pulumi.Input<string>[]>;
-    /** Registry credentials for private images (optional) */
-    registryCredentials?: pulumi.Output<string>;
-    /** Service-specific environment variables (can include secrets) */
-    serviceEnvVars?: Record<string, SecretEnvVars>;
-}
-/**
- * Builds Droplet resources for services with platform: 'droplet'.
- *
- * Creates:
- * - Droplet with Docker and cloud-init script
- * - Volume(s) for persistent storage (if configured)
- * - Firewall rules for VPC access
- *
- * @returns Map of service name to created resources
- */
-export declare function buildDropletServices(options: BuildDropletServicesOptions): Map<string, DropletServiceResources>;
-/**
- * Filters service configs by platform type.
- */
-export declare function filterByPlatform(configs: ServiceConfig[], platform: 'app-platform' | 'droplet'): ServiceConfig[];

package/dist/helpers/image.d.ts

@@ -1,30 +0,0 @@
-import type { Output } from '@pulumi/pulumi';
-/**
- * Gets the full GHCR image URL for a service.
- *
- * @param registry - The GHCR registry/org name (e.g., 'orderboss')
- * @param serviceName - The service name (e.g., 'storefront', 'api-gateway')
- * @returns Full image URL (e.g., 'ghcr.io/orderboss/storefront:abc123')
- *
- * @example
- * ```typescript
- * const config: K8sServiceConfig = {
- *   name: 'storefront',
- *   image: ghcrImage('orderboss', 'storefront'),
- * }
- * ```
- */
-export declare const ghcrImage: (registry: string, serviceName: string) => string;
-/**
- * Gets the image configuration for a given repository.
- * @param repository - The name of the repository.
- * @returns The image configuration.
- * @deprecated Use ghcrImage instead
- */
-export declare const getImage: (registry: string, repository: string, registryCredentials: Output<string>) => {
-    registryType: any;
-    registry: string;
-    repository: string;
-    registryCredentials: Output<string>;
-    tag: string;
-};