typekro 0.5.0 → 0.8.0

package/dist/factories/valkey/resources/valkey.js

@@ -0,0 +1,123 @@
+/**
+ * Hyperspike Valkey Cluster Factory
+ *
+ * Creates a Valkey CRD resource representing a Valkey cluster
+ * managed by the Hyperspike operator.
+ */
+import { createConditionBasedReadinessEvaluator } from '../../../core/readiness/index.js';
+import { createResource } from '../../shared.js';
+/** Base condition-based evaluator for Valkey Ready condition. */
+const baseValkeyEvaluator = createConditionBasedReadinessEvaluator({ kind: 'Valkey' });
+/**
+ * Valkey Readiness Evaluator
+ *
+ * Checks the standard Ready condition first. If status has a top-level
+ * `ready` boolean (Hyperspike pattern), uses that as a fast path.
+ * Falls back to condition-based evaluation for detailed state.
+ */
+function valkeyReadinessEvaluator(liveResource) {
+    const resource = liveResource;
+    const status = resource?.status;
+    if (!status) {
+        return {
+            ready: false,
+            message: 'Valkey cluster has no status yet',
+            reason: 'StatusMissing',
+        };
+    }
+    // Fast path: Hyperspike reports a top-level ready boolean
+    if (status.ready === true) {
+        return {
+            ready: true,
+            message: 'Valkey cluster is ready',
+            reason: 'Ready',
+        };
+    }
+    if (status.ready === false) {
+        // Check conditions for a more specific reason
+        const readyCondition = status.conditions?.find((c) => c.type === 'Ready');
+        if (readyCondition) {
+            return {
+                ready: false,
+                message: readyCondition.message || 'Valkey cluster is not ready',
+                reason: readyCondition.reason || 'NotReady',
+            };
+        }
+        return {
+            ready: false,
+            message: 'Valkey cluster is not ready',
+            reason: 'NotReady',
+        };
+    }
+    // Fall back to condition-based evaluation
+    return baseValkeyEvaluator(liveResource);
+}
+/**
+ * Hyperspike Valkey Cluster Factory
+ *
+ * Creates a Valkey cluster managed by the Hyperspike operator. Supports
+ * sharded clusters with optional replication, TLS, external access via
+ * Envoy proxy or LoadBalancer, and Prometheus monitoring.
+ *
+ * @param config - Valkey cluster configuration following hyperspike.io/v1 API
+ * @returns Enhanced Valkey resource with readiness evaluation
+ *
+ * @example
+ * ```typescript
+ * const cache = valkey({
+ *   name: 'app-cache',
+ *   namespace: 'default',
+ *   spec: {
+ *     shards: 3,
+ *     replicas: 1,
+ *     storage: {
+ *       spec: {
+ *         storageClassName: 'gp3',
+ *         resources: { requests: { storage: '10Gi' } },
+ *       },
+ *     },
+ *     resources: {
+ *       requests: { cpu: '250m', memory: '512Mi' },
+ *       limits: { cpu: '1', memory: '2Gi' },
+ *     },
+ *     prometheus: true,
+ *   },
+ *   id: 'appCache',
+ * });
+ * ```
+ */
+function createValkeyResource(config) {
+    // Map the user-facing `shards` field to the CRD's `nodes` JSON tag.
+    // The Hyperspike CRD Go type uses `Nodes int32 \`json:"nodes"\``
+    // but we expose it as `shards` for clarity.
+    const spec = config.spec;
+    const crdSpec = {};
+    for (const [key, value] of Object.entries(spec)) {
+        if (key === 'shards') {
+            crdSpec.nodes = value;
+        }
+        else {
+            crdSpec[key] = value;
+        }
+    }
+    return createResource({
+        apiVersion: 'hyperspike.io/v1',
+        kind: 'Valkey',
+        metadata: {
+            name: config.name,
+            ...(config.namespace && { namespace: config.namespace }),
+            // Labels must be non-empty: the Hyperspike operator's labels() function
+            // panics on nil map assignment when metadata.labels is absent.
+            // https://github.com/hyperspike/valkey-operator/blob/v0.0.61/internal/controller/valkey_controller.go#L250
+            labels: {
+                'app.kubernetes.io/name': 'valkey',
+                'app.kubernetes.io/instance': config.name,
+                'app.kubernetes.io/managed-by': 'typekro',
+            },
+        },
+        spec: crdSpec,
+        ...(config.id && { id: config.id }),
+    }, { scope: 'namespaced' }).withReadinessEvaluator(valkeyReadinessEvaluator);
+}
+export const valkey = createValkeyResource;
+//# sourceMappingURL=valkey.js.map

package/dist/factories/valkey/resources/valkey.js.map

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

package/dist/factories/valkey/types.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Hyperspike Valkey Operator Type Definitions
+ *
+ * ArkType schemas are the SINGLE source of truth for validated config types.
+ * TypeScript types are INFERRED from schemas using `typeof Schema.infer`.
+ * Status interfaces remain hand-written since they represent k8s API responses,
+ * not user-provided config that needs validation.
+ *
+ * @see https://github.com/hyperspike/valkey-operator
+ * @see https://doc.crds.dev/github.com/hyperspike/valkey-operator
+ */
+/**
+ * ArkType schema for the Valkey operator bootstrap configuration.
+ *
+ * Used by the `valkeyBootstrap` composition to deploy the operator
+ * controller into the cluster via Helm.
+ */
+export declare const ValkeyBootstrapConfigSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    name: string;
+    namespace?: string;
+    version?: string;
+    customValues?: Record<string, unknown>;
+}, {}>;
+/** Configuration for installing the Hyperspike Valkey operator via Helm. */
+export type ValkeyBootstrapConfig = typeof ValkeyBootstrapConfigSchema.infer;
+/**
+ * ArkType schema for a Hyperspike Valkey cluster configuration.
+ *
+ * The `storage` field mirrors `*corev1.PersistentVolumeClaim` from the CRD Go types.
+ * The `servicePassword` field mirrors `*corev1.SecretKeySelector` (name + key).
+ * The `resources` field mirrors `*corev1.ResourceRequirements`.
+ * The `shards` field maps to the CRD json tag `"nodes"` — the factory handles this mapping.
+ *
+ * @see https://doc.crds.dev/github.com/hyperspike/valkey-operator
+ */
+export declare const ValkeyConfigSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    name: string;
+    spec: {
+        image?: string;
+        exporterImage?: string;
+        shards?: number;
+        replicas?: number;
+        clusterDomain?: string;
+        anonymousAuth?: boolean;
+        servicePassword?: {
+            name: string;
+            key: string;
+        };
+        tls?: boolean;
+        certIssuer?: string;
+        certIssuerType?: string;
+        storage?: {
+            spec?: {
+                accessModes?: string[];
+                storageClassName?: string;
+                resources?: {
+                    requests?: {
+                        storage?: string;
+                    };
+                };
+            };
+        };
+        volumePermissions?: boolean;
+        resources?: {
+            requests?: {
+                cpu?: string;
+                memory?: string;
+            };
+            limits?: {
+                cpu?: string;
+                memory?: string;
+            };
+        };
+        platformManagedSecurityContext?: boolean;
+        clusterPreferredEndpointType?: "ip" | "hostname" | "unknown-endpoint";
+        externalAccess?: {
+            enabled?: boolean;
+            type?: "Proxy" | "LoadBalancer";
+            externalDNS?: boolean;
+            certIssuer?: string;
+            certIssuerType?: string;
+            proxy?: {
+                image?: string;
+                replicas?: number;
+                hostname?: string;
+                resources?: {
+                    requests?: {
+                        cpu?: string;
+                        memory?: string;
+                    };
+                    limits?: {
+                        cpu?: string;
+                        memory?: string;
+                    };
+                };
+                extraConfig?: string;
+                annotations?: Record<string, string>;
+            };
+            loadBalancer?: {
+                annotations?: Record<string, string>;
+            };
+        };
+        prometheus?: boolean;
+        prometheusLabels?: Record<string, string>;
+        serviceMonitor?: boolean;
+        nodeSelector?: Record<string, string>;
+        tolerations?: {
+            key?: string;
+            operator?: "Exists" | "Equal";
+            value?: string;
+            effect?: "NoSchedule" | "PreferNoSchedule" | "NoExecute";
+            tolerationSeconds?: number;
+        }[];
+    };
+    namespace?: string;
+    id?: string;
+}, {}>;
+/** Configuration for a Hyperspike Valkey cluster. */
+export type ValkeyConfig = typeof ValkeyConfigSchema.infer;
+/** Status condition for a Valkey cluster. */
+export interface ValkeyCondition {
+    type: string;
+    status: 'True' | 'False' | 'Unknown';
+    reason: string;
+    message: string;
+    lastTransitionTime: string;
+}
+/**
+ * Observed status of a Valkey cluster.
+ */
+export interface ValkeyStatus {
+    /** Whether the cluster is operational. */
+    ready?: boolean;
+    /** Cluster service hostname (derived from resource name). */
+    hostname?: string;
+    /** Status conditions. */
+    conditions?: ValkeyCondition[];
+}
+/**
+ * Observed status of a Valkey operator deployment.
+ */
+export interface ValkeyBootstrapStatus {
+    /**
+     * Overall deployment phase (derived from HelmRelease Ready condition).
+     * Note: cannot distinguish Failed from Installing due to CEL limitation (#48).
+     * Use the `failed` field for failure detection.
+     */
+    phase: 'Ready' | 'Installing';
+    /** Whether the operator is ready to manage Valkey clusters. */
+    ready: boolean;
+    /** Whether the HelmRelease Ready condition is explicitly False. */
+    failed: boolean;
+    /** Deployed operator version (app version, not chart version). */
+    version?: string;
+}
+/** ArkType schema for ValkeyBootstrapStatus. */
+export declare const ValkeyBootstrapStatusSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    phase: "Ready" | "Installing";
+    ready: boolean;
+    failed: boolean;
+    version?: string;
+}, {}>;
+/** ArkType schema for the Valkey operator Helm chart repository configuration. */
+export declare const ValkeyHelmRepositoryConfigSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    name?: string;
+    namespace?: string;
+    url?: string;
+    type?: "default" | "oci";
+    interval?: string;
+    id?: string;
+}, {}>;
+/** Configuration for the Valkey operator Helm chart repository. */
+export type ValkeyHelmRepositoryConfig = typeof ValkeyHelmRepositoryConfigSchema.infer;
+/** ArkType schema for the Valkey operator Helm release configuration. */
+export declare const ValkeyHelmReleaseConfigSchema: import("arktype/internal/methods/object.ts").ObjectType<{
+    name: string;
+    namespace?: string;
+    version?: string;
+    values?: Record<string, unknown>;
+    repositoryName?: string;
+    id?: string;
+}, {}>;
+/** Configuration for the Valkey operator Helm release. */
+export type ValkeyHelmReleaseConfig = typeof ValkeyHelmReleaseConfigSchema.infer;
+//# sourceMappingURL=types.d.ts.map

package/dist/factories/valkey/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/factories/valkey/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA2BH;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B;;;;;MAStC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,KAAK,CAAC;AAM7E;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA6G7B,CAAC;AAEH,qDAAqD;AACrD,MAAM,MAAM,YAAY,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC;AAM3D,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yBAAyB;IACzB,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,EAAE,OAAO,GAAG,YAAY,CAAC;IAC9B,+DAA+D;IAC/D,KAAK,EAAE,OAAO,CAAC;IACf,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,gDAAgD;AAChD,eAAO,MAAM,2BAA2B;;;;;MAKtC,CAAC;AAMH,kFAAkF;AAClF,eAAO,MAAM,gCAAgC;;;;;;;MAa3C,CAAC;AAEH,mEAAmE;AACnE,MAAM,MAAM,0BAA0B,GAAG,OAAO,gCAAgC,CAAC,KAAK,CAAC;AAEvF,yEAAyE;AACzE,eAAO,MAAM,6BAA6B;;;;;;;MAaxC,CAAC;AAEH,0DAA0D;AAC1D,MAAM,MAAM,uBAAuB,GAAG,OAAO,6BAA6B,CAAC,KAAK,CAAC"}

package/dist/factories/valkey/types.js

@@ -0,0 +1,204 @@
+/**
+ * Hyperspike Valkey Operator Type Definitions
+ *
+ * ArkType schemas are the SINGLE source of truth for validated config types.
+ * TypeScript types are INFERRED from schemas using `typeof Schema.infer`.
+ * Status interfaces remain hand-written since they represent k8s API responses,
+ * not user-provided config that needs validation.
+ *
+ * @see https://github.com/hyperspike/valkey-operator
+ * @see https://doc.crds.dev/github.com/hyperspike/valkey-operator
+ */
+import { type } from 'arktype';
+// ============================================================================
+// Shared Schema Shapes
+// ============================================================================
+/** Shared ArkType schema shape for Kubernetes tolerations. */
+const tolerationSchemaShape = {
+    'key?': 'string',
+    'operator?': '"Exists" | "Equal"',
+    'value?': 'string',
+    'effect?': '"NoSchedule" | "PreferNoSchedule" | "NoExecute"',
+    'tolerationSeconds?': 'number',
+};
+/** Shared ArkType schema shape for pod resource requirements. */
+const resourceRequirementsSchemaShape = {
+    'requests?': { 'cpu?': 'string', 'memory?': 'string' },
+    'limits?': { 'cpu?': 'string', 'memory?': 'string' },
+};
+// ============================================================================
+// Bootstrap Config (Helm Operator Install)
+// ============================================================================
+/**
+ * ArkType schema for the Valkey operator bootstrap configuration.
+ *
+ * Used by the `valkeyBootstrap` composition to deploy the operator
+ * controller into the cluster via Helm.
+ */
+export const ValkeyBootstrapConfigSchema = type({
+    /** Release name for the Helm installation. */
+    name: 'string',
+    /** Namespace for the operator (default: 'valkey-operator-system'). */
+    'namespace?': 'string',
+    /** Chart version. */
+    'version?': 'string',
+    /** Additional Helm values for user overrides. */
+    'customValues?': 'Record<string, unknown>',
+});
+// ============================================================================
+// Valkey CRD Resource
+// ============================================================================
+/**
+ * ArkType schema for a Hyperspike Valkey cluster configuration.
+ *
+ * The `storage` field mirrors `*corev1.PersistentVolumeClaim` from the CRD Go types.
+ * The `servicePassword` field mirrors `*corev1.SecretKeySelector` (name + key).
+ * The `resources` field mirrors `*corev1.ResourceRequirements`.
+ * The `shards` field maps to the CRD json tag `"nodes"` — the factory handles this mapping.
+ *
+ * @see https://doc.crds.dev/github.com/hyperspike/valkey-operator
+ */
+export const ValkeyConfigSchema = type({
+    /** Cluster name. */
+    name: 'string',
+    /** Target namespace. */
+    'namespace?': 'string',
+    /** Resource ID for composition references. */
+    'id?': 'string',
+    /** Valkey cluster specification. */
+    spec: {
+        // Core
+        /** Valkey container image. */
+        'image?': 'string',
+        /** Metrics exporter image. */
+        'exporterImage?': 'string',
+        /** Number of primary nodes/shards (default: 3). */
+        'shards?': 'number',
+        /** Additional replicas per shard (default: 0). */
+        'replicas?': 'number',
+        /** Cluster domain (default: 'cluster.local'). */
+        'clusterDomain?': 'string',
+        // Authentication
+        /** Allow connections without authentication (default: false). */
+        'anonymousAuth?': 'boolean',
+        /** Reference to an existing password secret (*corev1.SecretKeySelector). */
+        'servicePassword?': { name: 'string', key: 'string' },
+        // TLS
+        /** Enable TLS encryption (default: false). */
+        'tls?': 'boolean',
+        /** Certificate issuer name (requires cert-manager). */
+        'certIssuer?': 'string',
+        /** Certificate issuer type: 'ClusterIssuer' or 'Issuer' (default: 'ClusterIssuer'). */
+        'certIssuerType?': 'string',
+        // Storage & Resources
+        /** Persistent storage configuration (*corev1.PersistentVolumeClaim). */
+        'storage?': {
+            'spec?': {
+                /** PVC access modes (default: ['ReadWriteOnce']). */
+                'accessModes?': 'string[]',
+                /** Storage class name. */
+                'storageClassName?': 'string',
+                /** Storage resource requests. */
+                'resources?': {
+                    'requests?': { 'storage?': 'string' },
+                },
+            },
+        },
+        /** Run init container to fix volume permissions (default: false). */
+        'volumePermissions?': 'boolean',
+        /** Pod resource requirements (*corev1.ResourceRequirements). */
+        'resources?': resourceRequirementsSchemaShape,
+        /** Platform-managed security context (default: false). */
+        'platformManagedSecurityContext?': 'boolean',
+        // Networking
+        /** Preferred endpoint type for cluster communication. */
+        'clusterPreferredEndpointType?': '"ip" | "hostname" | "unknown-endpoint"',
+        // External Access
+        /** External access configuration. */
+        'externalAccess?': {
+            /** Enable external access (default: false). */
+            'enabled?': 'boolean',
+            /** Access type: 'Proxy' (Envoy) or 'LoadBalancer' (default: 'Proxy'). */
+            'type?': '"LoadBalancer" | "Proxy"',
+            /** Enable external DNS support. */
+            'externalDNS?': 'boolean',
+            /** TLS certificate issuer name. */
+            'certIssuer?': 'string',
+            /** Certificate issuer type (default: 'ClusterIssuer'). */
+            'certIssuerType?': 'string',
+            /** Envoy proxy settings (when type is 'Proxy'). */
+            'proxy?': {
+                /** Envoy proxy image (default: 'envoyproxy/envoy:v1.32.1'). */
+                'image?': 'string',
+                /** Number of proxy replicas (default: 1). */
+                'replicas?': 'number',
+                /** External proxy hostname. */
+                'hostname?': 'string',
+                /** Proxy pod resources. */
+                'resources?': resourceRequirementsSchemaShape,
+                /** Additional Envoy configuration. */
+                'extraConfig?': 'string',
+                /** Service annotations. */
+                'annotations?': 'Record<string, string>',
+            },
+            /** LoadBalancer settings (when type is 'LoadBalancer'). */
+            'loadBalancer?': {
+                /** Service annotations. */
+                'annotations?': 'Record<string, string>',
+            },
+        },
+        // Monitoring
+        /** Enable Prometheus metrics endpoint (default: false). */
+        'prometheus?': 'boolean',
+        /** Labels for Prometheus metric matching. */
+        'prometheusLabels?': 'Record<string, string>',
+        /** Create Prometheus ServiceMonitor resource (default: false). */
+        'serviceMonitor?': 'boolean',
+        // Scheduling
+        /** Node label selectors for pod placement. */
+        'nodeSelector?': 'Record<string, string>',
+        /** Taint tolerations. */
+        'tolerations?': type(tolerationSchemaShape).array(),
+    },
+});
+/** ArkType schema for ValkeyBootstrapStatus. */
+export const ValkeyBootstrapStatusSchema = type({
+    phase: '"Ready" | "Installing"',
+    ready: 'boolean',
+    failed: 'boolean',
+    'version?': 'string',
+});
+// ============================================================================
+// Helm Integration
+// ============================================================================
+/** ArkType schema for the Valkey operator Helm chart repository configuration. */
+export const ValkeyHelmRepositoryConfigSchema = type({
+    /** Repository name (default: 'valkey-operator-repo'). */
+    'name?': 'string',
+    /** Namespace for the HelmRepository (default: flux-system). */
+    'namespace?': 'string',
+    /** OCI registry URL (default: 'oci://ghcr.io/hyperspike'). */
+    'url?': 'string',
+    /** Repository type (default: 'oci' — Hyperspike uses OCI registry). */
+    'type?': '"default" | "oci"',
+    /** Sync interval (default: '5m'). */
+    'interval?': 'string',
+    /** Resource ID for composition references. */
+    'id?': 'string',
+});
+/** ArkType schema for the Valkey operator Helm release configuration. */
+export const ValkeyHelmReleaseConfigSchema = type({
+    /** Release name. */
+    name: 'string',
+    /** Target namespace. */
+    'namespace?': 'string',
+    /** Chart version. */
+    'version?': 'string',
+    /** Helm values. */
+    'values?': 'Record<string, unknown>',
+    /** HelmRepository name to reference (default: 'valkey-operator-repo'). */
+    'repositoryName?': 'string',
+    /** Resource ID for composition references. */
+    'id?': 'string',
+});
+//# sourceMappingURL=types.js.map

package/dist/factories/valkey/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/factories/valkey/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE/B,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,8DAA8D;AAC9D,MAAM,qBAAqB,GAAG;IAC5B,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,QAAQ;IAClB,SAAS,EAAE,iDAAiD;IAC5D,oBAAoB,EAAE,QAAQ;CACtB,CAAC;AAEX,iEAAiE;AACjE,MAAM,+BAA+B,GAAG;IACtC,WAAW,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;IACtD,SAAS,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE;CAC5C,CAAC;AAEX,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;IAC9C,8CAA8C;IAC9C,IAAI,EAAE,QAAQ;IACd,sEAAsE;IACtE,YAAY,EAAE,QAAQ;IACtB,qBAAqB;IACrB,UAAU,EAAE,QAAQ;IACpB,iDAAiD;IACjD,eAAe,EAAE,yBAAyB;CAC3C,CAAC,CAAC;AAKH,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC;IACrC,oBAAoB;IACpB,IAAI,EAAE,QAAQ;IACd,wBAAwB;IACxB,YAAY,EAAE,QAAQ;IACtB,8CAA8C;IAC9C,KAAK,EAAE,QAAQ;IACf,oCAAoC;IACpC,IAAI,EAAE;QACJ,OAAO;QACP,8BAA8B;QAC9B,QAAQ,EAAE,QAAQ;QAClB,8BAA8B;QAC9B,gBAAgB,EAAE,QAAQ;QAC1B,mDAAmD;QACnD,SAAS,EAAE,QAAQ;QACnB,kDAAkD;QAClD,WAAW,EAAE,QAAQ;QACrB,iDAAiD;QACjD,gBAAgB,EAAE,QAAQ;QAE1B,iBAAiB;QACjB,iEAAiE;QACjE,gBAAgB,EAAE,SAAS;QAC3B,4EAA4E;QAC5E,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE;QAErD,MAAM;QACN,8CAA8C;QAC9C,MAAM,EAAE,SAAS;QACjB,uDAAuD;QACvD,aAAa,EAAE,QAAQ;QACvB,uFAAuF;QACvF,iBAAiB,EAAE,QAAQ;QAE3B,sBAAsB;QACtB,wEAAwE;QACxE,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,qDAAqD;gBACrD,cAAc,EAAE,UAAU;gBAC1B,0BAA0B;gBAC1B,mBAAmB,EAAE,QAAQ;gBAC7B,iCAAiC;gBACjC,YAAY,EAAE;oBACZ,WAAW,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;iBACtC;aACF;SACF;QACD,qEAAqE;QACrE,oBAAoB,EAAE,SAAS;QAC/B,gEAAgE;QAChE,YAAY,EAAE,+BAA+B;QAC7C,0DAA0D;QAC1D,iCAAiC,EAAE,SAAS;QAE5C,aAAa;QACb,yDAAyD;QACzD,+BAA+B,EAAE,wCAAwC;QAEzE,kBAAkB;QAClB,qCAAqC;QACrC,iBAAiB,EAAE;YACjB,+CAA+C;YAC/C,UAAU,EAAE,SAAS;YACrB,yEAAyE;YACzE,OAAO,EAAE,0BAA0B;YACnC,mCAAmC;YACnC,cAAc,EAAE,SAAS;YACzB,mCAAmC;YACnC,aAAa,EAAE,QAAQ;YACvB,0DAA0D;YAC1D,iBAAiB,EAAE,QAAQ;YAC3B,mDAAmD;YACnD,QAAQ,EAAE;gBACR,+DAA+D;gBAC/D,QAAQ,EAAE,QAAQ;gBAClB,6CAA6C;gBAC7C,WAAW,EAAE,QAAQ;gBACrB,+BAA+B;gBAC/B,WAAW,EAAE,QAAQ;gBACrB,2BAA2B;gBAC3B,YAAY,EAAE,+BAA+B;gBAC7C,sCAAsC;gBACtC,cAAc,EAAE,QAAQ;gBACxB,2BAA2B;gBAC3B,cAAc,EAAE,wBAAwB;aACzC;YACD,2DAA2D;YAC3D,eAAe,EAAE;gBACf,2BAA2B;gBAC3B,cAAc,EAAE,wBAAwB;aACzC;SACF;QAED,aAAa;QACb,2DAA2D;QAC3D,aAAa,EAAE,SAAS;QACxB,6CAA6C;QAC7C,mBAAmB,EAAE,wBAAwB;QAC7C,kEAAkE;QAClE,iBAAiB,EAAE,SAAS;QAE5B,aAAa;QACb,8CAA8C;QAC9C,eAAe,EAAE,wBAAwB;QACzC,yBAAyB;QACzB,cAAc,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC,KAAK,EAAE;KACpD;CACF,CAAC,CAAC;AAgDH,gDAAgD;AAChD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;IAC9C,KAAK,EAAE,wBAAwB;IAC/B,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,UAAU,EAAE,QAAQ;CACrB,CAAC,CAAC;AAEH,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,kFAAkF;AAClF,MAAM,CAAC,MAAM,gCAAgC,GAAG,IAAI,CAAC;IACnD,yDAAyD;IACzD,OAAO,EAAE,QAAQ;IACjB,+DAA+D;IAC/D,YAAY,EAAE,QAAQ;IACtB,8DAA8D;IAC9D,MAAM,EAAE,QAAQ;IAChB,uEAAuE;IACvE,OAAO,EAAE,mBAAmB;IAC5B,qCAAqC;IACrC,WAAW,EAAE,QAAQ;IACrB,8CAA8C;IAC9C,KAAK,EAAE,QAAQ;CAChB,CAAC,CAAC;AAKH,yEAAyE;AACzE,MAAM,CAAC,MAAM,6BAA6B,GAAG,IAAI,CAAC;IAChD,oBAAoB;IACpB,IAAI,EAAE,QAAQ;IACd,wBAAwB;IACxB,YAAY,EAAE,QAAQ;IACtB,qBAAqB;IACrB,UAAU,EAAE,QAAQ;IACpB,mBAAmB;IACnB,SAAS,EAAE,yBAAyB;IACpC,0EAA0E;IAC1E,iBAAiB,EAAE,QAAQ;IAC3B,8CAA8C;IAC9C,KAAK,EAAE,QAAQ;CAChB,CAAC,CAAC"}

package/dist/factories/valkey/utils/helm-values-mapper.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Helm Values Mapper for Hyperspike Valkey Operator
+ *
+ * Maps ValkeyBootstrapConfig to Helm chart values for the valkey-operator chart.
+ * The operator chart is simple — it deploys the controller only.
+ *
+ * @see https://github.com/hyperspike/valkey-operator
+ */
+import type { ValkeyBootstrapConfig } from '../types.js';
+/** Helm values structure for the valkey-operator chart. */
+export interface ValkeyHelmValues {
+    [key: string]: unknown;
+}
+/**
+ * Map ValkeyBootstrapConfig to Helm chart values.
+ *
+ * The Hyperspike operator chart has minimal configuration — most settings
+ * are on the Valkey CRD itself, not the operator. Custom values are passed
+ * through directly for any operator-level overrides.
+ *
+ * @param config - Resolved Valkey bootstrap configuration
+ * @returns Helm values object compatible with the valkey-operator chart
+ */
+export declare function mapValkeyConfigToHelmValues(config: ValkeyBootstrapConfig): ValkeyHelmValues;
+/**
+ * Get advisory warnings for Valkey operator Helm values configuration.
+ *
+ * @param _config - Bootstrap configuration to check
+ * @returns Array of warning messages (empty if configuration looks good)
+ */
+export declare function getValkeyHelmValueWarnings(_config: ValkeyBootstrapConfig): string[];
+//# sourceMappingURL=helm-values-mapper.d.ts.map

package/dist/factories/valkey/utils/helm-values-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helm-values-mapper.d.ts","sourceRoot":"","sources":["../../../../src/factories/valkey/utils/helm-values-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,WAAW,gBAAgB;IAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,gBAAgB,CAQ3F;AAsBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAInF"}

package/dist/factories/valkey/utils/helm-values-mapper.js

@@ -0,0 +1,58 @@
+/**
+ * Helm Values Mapper for Hyperspike Valkey Operator
+ *
+ * Maps ValkeyBootstrapConfig to Helm chart values for the valkey-operator chart.
+ * The operator chart is simple — it deploys the controller only.
+ *
+ * @see https://github.com/hyperspike/valkey-operator
+ */
+/**
+ * Map ValkeyBootstrapConfig to Helm chart values.
+ *
+ * The Hyperspike operator chart has minimal configuration — most settings
+ * are on the Valkey CRD itself, not the operator. Custom values are passed
+ * through directly for any operator-level overrides.
+ *
+ * @param config - Resolved Valkey bootstrap configuration
+ * @returns Helm values object compatible with the valkey-operator chart
+ */
+export function mapValkeyConfigToHelmValues(config) {
+    const values = {};
+    if (config.customValues) {
+        Object.assign(values, config.customValues);
+    }
+    return removeUndefinedValues(values);
+}
+/**
+ * Recursively remove undefined values from an object.
+ * Helm doesn't handle undefined well — only include explicitly set values.
+ */
+function removeUndefinedValues(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined)
+            continue;
+        if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+            const cleaned = removeUndefinedValues(value);
+            if (Object.keys(cleaned).length > 0) {
+                result[key] = cleaned;
+            }
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * Get advisory warnings for Valkey operator Helm values configuration.
+ *
+ * @param _config - Bootstrap configuration to check
+ * @returns Array of warning messages (empty if configuration looks good)
+ */
+export function getValkeyHelmValueWarnings(_config) {
+    // The Hyperspike operator chart has minimal configuration.
+    // Most settings are on the Valkey CRD, not the operator.
+    return [];
+}
+//# sourceMappingURL=helm-values-mapper.js.map

package/dist/factories/valkey/utils/helm-values-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helm-values-mapper.js","sourceRoot":"","sources":["../../../../src/factories/valkey/utils/helm-values-mapper.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAA6B;IACvE,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAoC,GAAM;IACtE,MAAM,MAAM,GAAG,EAA6B,CAAC;IAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzE,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAgC,CAAC,CAAC;YACxE,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;YACxB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,MAAW,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA8B;IACvE,2DAA2D;IAC3D,yDAAyD;IACzD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/factories/valkey/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './helm-values-mapper.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/valkey/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/valkey/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/factories/valkey/utils/index.js

@@ -0,0 +1,2 @@
+export * from './helm-values-mapper.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/valkey/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/valkey/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC"}

package/dist/factories/webapp/compositions/index.d.ts

@@ -0,0 +1,2 @@
+export { webAppWithProcessing } from './web-app-with-processing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/webapp/compositions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/webapp/compositions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/factories/webapp/compositions/index.js

@@ -0,0 +1,2 @@
+export { webAppWithProcessing } from './web-app-with-processing.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/webapp/compositions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/webapp/compositions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC"}