typekro 0.22.0 → 0.23.0

package/dist/factories/clickhouse/compositions/clickhouse-cluster.js

@@ -0,0 +1,251 @@
+/**
+ * ClickHouse Cluster Composition (build-time topology constructor)
+ *
+ * `makeClickHouseCluster(topology)` separates the two halves of a CHI
+ * honestly:
+ *
+ * - BUILD-TIME topology (`zones`, `replicas`, `shards`, `keeper` presence,
+ *   user names/networks) is fixed when the composition is CONSTRUCTED. The
+ *   zone-pinned layout enumerates pod templates and per-replica entries, so
+ *   it can never be instance-dynamic (the operator's own `podDistribution`
+ *   supports only the hostname topologyKey — Altinity/clickhouse-operator
+ *   issue #772 — and EBS volumes are zonal, so replicas must be pinned).
+ *
+ * - RUNTIME spec (`name`, `namespace`, `version`, `storage`, `clusterName`,
+ *   keeper host, per-user password hashes) flows through as schema proxies
+ *   and serializes to clean CEL in kro mode.
+ *
+ * Same construction pattern as `makeCaddyIngress`: build-time options select
+ * the resource/schema shape statically — no runtime `includeWhen`
+ * conditionals, no accepted-but-ignored spec fields.
+ */
+import { type } from 'arktype';
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { Cel } from '../../../core/references/cel.js';
+import { ClickHouseClusterStatusSchema, } from '../types.js';
+import { clickHouseInstallation, DEFAULT_CHI_CLUSTER_NAME, } from '../resources/installation.js';
+import { assertPositiveIntegerCount } from '../utils/validation.js';
+/** Native (TCP) ClickHouse port — operator default ChDefaultTCPPortNumber. */
+export const CLICKHOUSE_NATIVE_PORT = 9000;
+/** HTTP interface port — operator default ChDefaultHTTPPortNumber. */
+export const CLICKHOUSE_HTTP_PORT = 8123;
+/** Default Keeper/ZooKeeper client port — operator default KpDefaultZKPortNumber. */
+export const CLICKHOUSE_KEEPER_PORT = 2181;
+/** Default database exposed on the status contract. */
+export const CLICKHOUSE_DEFAULT_DATABASE = 'default';
+/** Default allowed source networks for declared users. */
+export const DEFAULT_USER_NETWORKS_IP = ['::/0'];
+/** Resource id of the CHI inside the composition graph. */
+const CHI_RESOURCE_ID = 'clickhouse';
+function resolveTopology(topology) {
+    const replicas = topology.replicas ?? 1;
+    const shards = topology.shards ?? 1;
+    // Fail at CONSTRUCTION time (not first serialization): counts are
+    // build-time topology, and zero/fractional/negative counts compile to
+    // invalid operator input (`replicasCount: 0` / `shardsCount: 0`).
+    assertPositiveIntegerCount('makeClickHouseCluster', 'replicas', replicas);
+    assertPositiveIntegerCount('makeClickHouseCluster', 'shards', shards);
+    return {
+        zones: topology.zones ?? [],
+        replicas,
+        shards,
+        // Replicated tables need coordination — default keeper on for
+        // multi-replica clusters unless the caller opts out explicitly.
+        keeper: topology.keeper ?? replicas > 1,
+        users: (topology.users ?? []).map((user) => ({
+            name: user.name,
+            networksIp: user.networksIp ?? DEFAULT_USER_NETWORKS_IP,
+        })),
+    };
+}
+/**
+ * Build the runtime spec ArkType schema for a resolved topology. The SHAPE of
+ * the schema is a build-time product: `keeper` is required iff the topology
+ * enables it, and one `users.<name>` entry (with a required password hash) is
+ * required per declared user — user names are literal schema keys, never
+ * dynamic path fragments.
+ */
+function buildSpecSchema(topology) {
+    const definition = {
+        name: 'string',
+        namespace: 'string',
+        version: 'string',
+        'clusterName?': 'string',
+        storage: {
+            size: 'string',
+            'storageClassName?': 'string',
+        },
+        'podResources?': {
+            'requests?': { 'cpu?': 'string', 'memory?': 'string' },
+            'limits?': { 'cpu?': 'string', 'memory?': 'string' },
+        },
+    };
+    if (topology.keeper) {
+        definition.keeper = { host: 'string', 'port?': 'number' };
+    }
+    if (topology.users.length > 0) {
+        definition.users = Object.fromEntries(topology.users.map((user) => [user.name, { passwordSha256Hex: 'string' }]));
+    }
+    return type(definition);
+}
+/**
+ * Construct a ClickHouse cluster composition with a FIXED topology.
+ *
+ * The result is a normal TypeKro composition: use it directly
+ * (`factory('kro').deploy({...})`) or nest it in other compositions with
+ * schema references for every runtime field.
+ *
+ * @example
+ * ```typescript
+ * const clickhouse = makeClickHouseCluster({
+ *   zones: ['us-east-2a', 'us-east-2b'],  // zone-pinned replicas (EBS is zonal)
+ *   replicas: 2,
+ *   shards: 1,
+ *   users: [{ name: 'signoz' }],          // names are build-time path fragments
+ * });
+ *
+ * await clickhouse.factory('kro').deploy({
+ *   name: 'signoz-clickhouse',
+ *   namespace: 'observability',
+ *   version: '25.12.5',
+ *   storage: { size: '100Gi', storageClassName: 'gp3-expandable' },
+ *   keeper: { host: 'keeper-signoz.observability.svc.cluster.local' },
+ *   users: { signoz: { passwordSha256Hex: '...' } },
+ * });
+ * ```
+ *
+ * Downstream compositions consume the typed service contract:
+ * ```typescript
+ * signoz({
+ *   clickhouse: {
+ *     host: ch.status.clickhouse.host,
+ *     port: ch.status.clickhouse.port,
+ *     cluster: ch.status.clickhouse.clusterName,
+ *   },
+ * });
+ * ```
+ */
+export function makeClickHouseCluster(topology = {}) {
+    const resolved = resolveTopology(topology);
+    const specSchema = buildSpecSchema(resolved);
+    const firstUserName = resolved.users[0]?.name;
+    return kubernetesComposition({
+        name: 'clickhouse-cluster',
+        kind: 'ClickHouseCluster',
+        spec: specSchema,
+        status: ClickHouseClusterStatusSchema,
+    }, (spec) => {
+        const clusterName = spec.clusterName ?? DEFAULT_CHI_CLUSTER_NAME;
+        // Runtime credentials pair with build-time user names by LITERAL key:
+        // `spec.users.<name>.passwordSha256Hex` is a plain schema path, so it
+        // serializes to clean CEL. Names/networks come from the topology.
+        const users = resolved.users.map((user) => ({
+            name: user.name,
+            // biome-ignore lint/style/noNonNullAssertion: the generated schema requires one users.<name> entry per declared user
+            passwordSha256Hex: spec.users[user.name].passwordSha256Hex,
+            networksIp: [...user.networksIp],
+        }));
+        const clickhouse = clickHouseInstallation({
+            name: spec.name,
+            namespace: spec.namespace,
+            version: spec.version,
+            clusterName,
+            // BUILD-TIME topology — concrete values from the constructor.
+            shards: resolved.shards,
+            replicas: resolved.replicas,
+            ...(resolved.zones.length > 0 ? { zones: [...resolved.zones] } : {}),
+            storage: {
+                size: spec.storage.size,
+                storageClassName: spec.storage.storageClassName,
+            },
+            ...(users.length > 0 ? { users } : {}),
+            ...(resolved.keeper
+                ? {
+                    keeper: {
+                        // biome-ignore lint/style/noNonNullAssertion: the generated schema requires keeper when the topology enables it
+                        host: spec.keeper.host,
+                        port: spec.keeper?.port ?? CLICKHOUSE_KEEPER_PORT,
+                    },
+                }
+                : {}),
+            podResources: spec.podResources,
+            id: CHI_RESOURCE_ID,
+        });
+        // Connection contract derived from the operator's ACTUAL naming
+        // (release-0.27.1): the CR-level Service is `clickhouse-{chi-name}`
+        // (type ClusterIP; pkg/model/chi/namer/patterns.go +
+        // pkg/model/chi/creator/service.go), listening on native 9000 /
+        // HTTP 8123 (type_host.go defaults). Per-host services
+        // (`chi-{chi}-{cluster}-{shard}-{replica}`) exist too but the CR
+        // service is the stable entrypoint.
+        //
+        // DERIVED FROM THE OWNED CHI RESOURCE (not schema.spec): KRO status
+        // CEL cannot reference schema.spec.*, so a spec-derived field is
+        // classified static (client-hydrated) and DROPPED from the KRO CR's
+        // status. Anchoring the derivation on the CHI resource
+        // (`clickhouse.metadata.*` / `clickhouse.spec.*`) makes these
+        // serialize as KRO status CEL, so GitOps/KRO consumers see the
+        // connection contract on the live CR.
+        //
+        // The string concats are RAW Cel.expr over the resource id: the
+        // status-builder proxy passes `metadata` values through verbatim
+        // (which would resolve back to schema.spec.name → static), and the
+        // serializer inlines CelExpression-valued template fields (like the
+        // defaulted clusterName / keeper port) back to their schema
+        // expressions — a raw resource-path expression survives both. Port
+        // constants ride INSIDE the resource-derived URL strings; the BARE
+        // constant fields (port/database/user) have no resource anchor and
+        // stay client-hydrated — see ClickHouseClusterStatus for the split.
+        const chiMeta = `${CHI_RESOURCE_ID}.metadata`;
+        const chiHostCel = `"clickhouse-" + ${chiMeta}.name + "." + ${chiMeta}.namespace + ".svc.cluster.local"`;
+        return {
+            ready: clickhouse.status.status === 'Completed',
+            phase: clickhouse.status.status === 'Completed'
+                ? 'Ready'
+                : clickhouse.status.status === 'Aborted'
+                    ? 'Failed'
+                    : 'Installing',
+            clickhouse: {
+                host: Cel.expr(chiHostCel),
+                // Bare numeric constant — client-hydrated only (no resource
+                // anchor); the port also appears in the KRO-visible URLs below.
+                port: CLICKHOUSE_NATIVE_PORT,
+                nativeUrl: Cel.expr(`"clickhouse://" + ${chiHostCel} + ":${CLICKHOUSE_NATIVE_PORT}"`),
+                httpUrl: Cel.expr(`"http://" + ${chiHostCel} + ":${CLICKHOUSE_HTTP_PORT}"`),
+                // The resolved logical cluster name is IN the owned CHI
+                // (configuration.clusters[0].name), so read it from there — the
+                // `spec.clusterName ?? default` expression itself is schema-only
+                // and would be dropped.
+                clusterName: Cel.expr(`${CHI_RESOURCE_ID}.spec.configuration.clusters[0].name`),
+                database: CLICKHOUSE_DEFAULT_DATABASE,
+                ...(firstUserName ? { user: firstUserName } : {}),
+            },
+            ...(resolved.keeper
+                ? {
+                    keeper: {
+                        // Echo the keeper endpoint from the CHI's own zookeeper
+                        // section (resource-derived → lands in KRO status) rather
+                        // than from schema.spec.keeper (static → dropped).
+                        host: Cel.expr(`${CHI_RESOURCE_ID}.spec.configuration.zookeeper.nodes[0].host`),
+                        port: Cel.expr(`${CHI_RESOURCE_ID}.spec.configuration.zookeeper.nodes[0].port`),
+                    },
+                }
+                : {}),
+            installation: {
+                // CHI identity from the owned resource (same reachability rule).
+                name: Cel.expr(`${chiMeta}.name`),
+                namespace: Cel.expr(`${chiMeta}.namespace`),
+                endpoint: clickhouse.status.endpoint,
+                hostsCount: clickhouse.status.hostsCount,
+                hostsCompletedCount: clickhouse.status.hostsCompletedCount,
+            },
+        };
+    });
+}
+/**
+ * The default single-node cluster composition (1 shard, 1 replica, no zones,
+ * no keeper, no declared users). See {@link makeClickHouseCluster} for
+ * topology options.
+ */
+export const clickHouseCluster = makeClickHouseCluster();
+//# sourceMappingURL=clickhouse-cluster.js.map

package/dist/factories/clickhouse/compositions/clickhouse-cluster.js.map

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

package/dist/factories/clickhouse/compositions/clickhouse-helm-repository.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared Altinity HelmRepository singleton.
+ *
+ * The official Altinity chart repository (https://helm.altinity.com) is a
+ * single cluster-level Flux source — the same URL serves every consumer.
+ * Deploying it inline in the `clickhouseOperatorBootstrap` RGD would make
+ * each instance's KRO ApplySet try to *own* the HelmRepository exclusively,
+ * so a second instance of the RGD fails to reconcile ("resource belongs to a
+ * different ApplySet ... cannot reassign"). Modelling the repository as its
+ * own composition lets the bootstrap consume it via `singleton(...)`, so one
+ * shared HelmRepository is owned outside any single instance's ApplySet and
+ * the operator HelmRelease references it by the same `sourceRef`.
+ * (Same pattern as the Dagster bootstrap's shared repository.)
+ */
+export declare const clickhouseHelmRepositoryBootstrap: import("../../../index.js").CallableComposition<{
+    name: string;
+    namespace: string;
+    url: string;
+}, {
+    ready: boolean;
+}>;
+//# sourceMappingURL=clickhouse-helm-repository.d.ts.map

package/dist/factories/clickhouse/compositions/clickhouse-helm-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-helm-repository.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickhouse/compositions/clickhouse-helm-repository.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iCAAiC;;;;;;EAsB7C,CAAC"}

package/dist/factories/clickhouse/compositions/clickhouse-helm-repository.js

@@ -0,0 +1,35 @@
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { Cel } from '../../../core/references/cel.js';
+import { clickhouseHelmRepository } from '../resources/helm.js';
+import { ClickHouseHelmRepositorySingletonSpecSchema, ClickHouseHelmRepositorySingletonStatusSchema, } from '../types.js';
+/**
+ * Shared Altinity HelmRepository singleton.
+ *
+ * The official Altinity chart repository (https://helm.altinity.com) is a
+ * single cluster-level Flux source — the same URL serves every consumer.
+ * Deploying it inline in the `clickhouseOperatorBootstrap` RGD would make
+ * each instance's KRO ApplySet try to *own* the HelmRepository exclusively,
+ * so a second instance of the RGD fails to reconcile ("resource belongs to a
+ * different ApplySet ... cannot reassign"). Modelling the repository as its
+ * own composition lets the bootstrap consume it via `singleton(...)`, so one
+ * shared HelmRepository is owned outside any single instance's ApplySet and
+ * the operator HelmRelease references it by the same `sourceRef`.
+ * (Same pattern as the Dagster bootstrap's shared repository.)
+ */
+export const clickhouseHelmRepositoryBootstrap = kubernetesComposition({
+    name: 'clickhouse-helm-repository',
+    kind: 'ClickHouseHelmRepository',
+    spec: ClickHouseHelmRepositorySingletonSpecSchema,
+    status: ClickHouseHelmRepositorySingletonStatusSchema,
+}, (spec) => {
+    const repository = clickhouseHelmRepository({
+        name: spec.name,
+        namespace: spec.namespace,
+        url: spec.url,
+        id: 'repository',
+    });
+    return {
+        ready: Cel.expr(repository.status.conditions, '.exists(c, c.type == "Ready" && c.status == "True")'),
+    };
+});
+//# sourceMappingURL=clickhouse-helm-repository.js.map

package/dist/factories/clickhouse/compositions/clickhouse-helm-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-helm-repository.js","sourceRoot":"","sources":["../../../../src/factories/clickhouse/compositions/clickhouse-helm-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,2CAA2C,EAC3C,6CAA6C,GAC9C,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,qBAAqB,CACpE;IACE,IAAI,EAAE,4BAA4B;IAClC,IAAI,EAAE,0BAA0B;IAChC,IAAI,EAAE,2CAA2C;IACjD,MAAM,EAAE,6CAA6C;CACtD,EACD,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,UAAU,GAAG,wBAAwB,CAAC;QAC1C,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,EAAE,EAAE,YAAY;KACjB,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,GAAG,CAAC,IAAI,CACb,UAAU,CAAC,MAAM,CAAC,UAAU,EAC5B,qDAAqD,CACtD;KACF,CAAC;AACJ,CAAC,CACF,CAAC"}

package/dist/factories/clickhouse/compositions/clickhouse-operator-bootstrap.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Altinity clickhouse-operator Bootstrap Composition
+ *
+ * Deploys the OFFICIAL Altinity clickhouse-operator via HelmRepository and
+ * HelmRelease resources (chart `altinity-clickhouse-operator` 0.27.x from
+ * https://helm.altinity.com, Apache-2.0). Build-around: we wrap the official
+ * chart — never hand-rolled operator manifests.
+ *
+ * IMPORTANT — ONE OPERATOR PER CLUSTER: the operator is cluster-scoped and
+ * owns the ClickHouse CRDs (`clickhouseinstallations`,
+ * `clickhouseinstallationtemplates`, `clickhouseoperatorconfigurations` under
+ * `clickhouse.altinity.com/v1`; `clickhousekeeperinstallations` under
+ * `clickhouse-keeper.altinity.com/v1`). Install it exactly once; every
+ * `clickHouseInstallation()`/`clickHouseKeeperInstallation()` in the cluster
+ * is reconciled by that single install. The default `shared: true` tags the
+ * operator resources with `scopes: ['cluster']` so instance deletion leaves
+ * the shared operator intact.
+ *
+ * This composition:
+ * 1. Creates the target namespace
+ * 2. References the shared Altinity HelmRepository singleton
+ * 3. Creates a HelmRelease that installs the operator
+ *
+ * After the operator is running, use `clickHouseInstallation()` and
+ * `clickHouseKeeperInstallation()` to create ClickHouse resources.
+ *
+ * @example
+ * ```typescript
+ * const operatorFactory = clickhouseOperatorBootstrap.factory('kro', {
+ *   namespace: 'clickhouse-system',
+ *   waitForReady: true,
+ * });
+ *
+ * await operatorFactory.deploy({
+ *   name: 'clickhouse-operator',
+ *   namespace: 'clickhouse-system',
+ *   version: '0.27.1',
+ * });
+ * ```
+ */
+export declare const clickhouseOperatorBootstrap: import("../../../index.js").CallableComposition<{
+    name: string;
+    namespace?: string;
+    version?: string;
+    metrics?: {
+        enabled?: boolean;
+    };
+    crdHook?: {
+        enabled?: boolean;
+    };
+    resources?: {
+        requests?: {
+            cpu?: string;
+            memory?: string;
+        };
+        limits?: {
+            cpu?: string;
+            memory?: string;
+        };
+    };
+    customValues?: Record<string, unknown>;
+    shared?: boolean;
+}, {
+    phase: "Ready" | "Installing";
+    ready: boolean;
+    version?: string;
+}>;
+//# sourceMappingURL=clickhouse-operator-bootstrap.d.ts.map

package/dist/factories/clickhouse/compositions/clickhouse-operator-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clickhouse-operator-bootstrap.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickhouse/compositions/clickhouse-operator-bootstrap.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;EAoGvC,CAAC"}

package/dist/factories/clickhouse/compositions/clickhouse-operator-bootstrap.js

@@ -0,0 +1,137 @@
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { DEFAULT_FLUX_NAMESPACE } from '../../../core/config/defaults.js';
+import { setMetadataField } from '../../../core/metadata/index.js';
+import { Cel } from '../../../core/references/cel.js';
+import { singleton } from '../../../core/singleton/singleton.js';
+import { namespace } from '../../kubernetes/core/namespace.js';
+import { clickhouseOperatorHelmRelease, DEFAULT_CLICKHOUSE_OPERATOR_VERSION, DEFAULT_CLICKHOUSE_REPO_NAME, DEFAULT_CLICKHOUSE_REPO_URL, } from '../resources/helm.js';
+import { ClickHouseOperatorBootstrapConfigSchema, ClickHouseOperatorBootstrapStatusSchema, } from '../types.js';
+import { mapClickHouseOperatorConfigToHelmValues } from '../utils/helm-values-mapper.js';
+import { clickhouseHelmRepositoryBootstrap } from './clickhouse-helm-repository.js';
+/**
+ * Altinity clickhouse-operator Bootstrap Composition
+ *
+ * Deploys the OFFICIAL Altinity clickhouse-operator via HelmRepository and
+ * HelmRelease resources (chart `altinity-clickhouse-operator` 0.27.x from
+ * https://helm.altinity.com, Apache-2.0). Build-around: we wrap the official
+ * chart — never hand-rolled operator manifests.
+ *
+ * IMPORTANT — ONE OPERATOR PER CLUSTER: the operator is cluster-scoped and
+ * owns the ClickHouse CRDs (`clickhouseinstallations`,
+ * `clickhouseinstallationtemplates`, `clickhouseoperatorconfigurations` under
+ * `clickhouse.altinity.com/v1`; `clickhousekeeperinstallations` under
+ * `clickhouse-keeper.altinity.com/v1`). Install it exactly once; every
+ * `clickHouseInstallation()`/`clickHouseKeeperInstallation()` in the cluster
+ * is reconciled by that single install. The default `shared: true` tags the
+ * operator resources with `scopes: ['cluster']` so instance deletion leaves
+ * the shared operator intact.
+ *
+ * This composition:
+ * 1. Creates the target namespace
+ * 2. References the shared Altinity HelmRepository singleton
+ * 3. Creates a HelmRelease that installs the operator
+ *
+ * After the operator is running, use `clickHouseInstallation()` and
+ * `clickHouseKeeperInstallation()` to create ClickHouse resources.
+ *
+ * @example
+ * ```typescript
+ * const operatorFactory = clickhouseOperatorBootstrap.factory('kro', {
+ *   namespace: 'clickhouse-system',
+ *   waitForReady: true,
+ * });
+ *
+ * await operatorFactory.deploy({
+ *   name: 'clickhouse-operator',
+ *   namespace: 'clickhouse-system',
+ *   version: '0.27.1',
+ * });
+ * ```
+ */
+export const clickhouseOperatorBootstrap = kubernetesComposition({
+    name: 'clickhouse-operator-bootstrap',
+    kind: 'ClickHouseOperatorBootstrap',
+    spec: ClickHouseOperatorBootstrapConfigSchema,
+    status: ClickHouseOperatorBootstrapStatusSchema,
+}, (spec) => {
+    const resolvedNamespace = spec.namespace || 'clickhouse-system';
+    const resolvedVersion = spec.version || DEFAULT_CLICKHOUSE_OPERATOR_VERSION;
+    // Default to shared-lifecycle: the operator is one-per-cluster
+    // infrastructure (it owns the CRDs) and must survive individual consumer
+    // instance deletions. `shared: false` exists only for throwaway
+    // environments such as kind-cluster integration tests.
+    const isShared = spec.shared !== false;
+    // Map config to Helm values (metrics.enabled / crdHook.enabled /
+    // operator resources + customValues merged LAST). Fields are passed
+    // EXPLICITLY — spreading the schema proxy (`...spec`) enumerates proxy
+    // keys and leaks `__typekroSchemaKey` markers into the rendered values.
+    // In kro mode `spec.customValues` is a schema ref, so the mapper routes
+    // it through the graph-aware runtime values merge and the override map
+    // lands in the serialized HelmRelease values.
+    const helmValues = mapClickHouseOperatorConfigToHelmValues({
+        metrics: spec.metrics,
+        crdHook: spec.crdHook,
+        resources: spec.resources,
+        customValues: spec.customValues,
+    });
+    // Resources are _-prefixed because they're registered via side effects in
+    // the kubernetesComposition callback — the composition captures them
+    // automatically. They're referenced in the status return via their `id`.
+    const _clickhouseNamespace = namespace({
+        metadata: {
+            name: resolvedNamespace,
+            labels: {
+                'app.kubernetes.io/name': 'altinity-clickhouse-operator',
+                'app.kubernetes.io/instance': spec.name,
+                'app.kubernetes.io/version': resolvedVersion,
+                'app.kubernetes.io/managed-by': 'typekro',
+            },
+        },
+        id: 'clickhouseNamespace',
+    });
+    // The Altinity chart repository is one cluster-level Flux source shared
+    // by every consumer, so deploy it once via singleton(...) with a fixed
+    // identity (same rationale as the Dagster bootstrap: inlining it would
+    // make each instance's KRO ApplySet try to own the HelmRepository
+    // exclusively, breaking a second instance with an ApplySet reassignment
+    // error). The HelmRelease references the shared repository by the
+    // official `sourceRef` defaults.
+    const _clickhouseHelmRepository = singleton(clickhouseHelmRepositoryBootstrap, {
+        id: 'clickhouse-helm-repository',
+        spec: {
+            name: DEFAULT_CLICKHOUSE_REPO_NAME,
+            namespace: DEFAULT_FLUX_NAMESPACE,
+            url: DEFAULT_CLICKHOUSE_REPO_URL,
+        },
+    });
+    // Create HelmRelease for the operator itself.
+    const _helmRelease = clickhouseOperatorHelmRelease({
+        name: spec.name,
+        namespace: resolvedNamespace,
+        version: resolvedVersion,
+        values: helmValues,
+        id: 'clickhouseOperatorHelmRelease',
+    });
+    // Tag resources with 'cluster' scope so factory-level deleteInstance
+    // leaves the shared operator install intact for other consumers. Callers
+    // can explicitly tear down shared infra with
+    // `deleteInstance(name, { scopes: ['cluster'] })`.
+    if (isShared) {
+        setMetadataField(_clickhouseNamespace, 'scopes', ['cluster']);
+        setMetadataField(_helmRelease, 'scopes', ['cluster']);
+    }
+    // Status derived from HelmRelease conditions.
+    // Flux HelmRelease v2 uses conditions with type='Ready' for readiness;
+    // the release does not set `disableWait`, so helm-controller waits for
+    // the chart's workloads before reporting Ready (readiness is
+    // workload-aware, mirroring the cnpg/dagster bootstraps).
+    return {
+        ready: Cel.expr(_helmRelease.status.conditions, '.exists(c, c.type == "Ready" && c.status == "True")'),
+        // Two-state phase: nested ternaries with .exists() require repeating the
+        // full resource path in CEL, which Cel.expr(ref, operator) cannot
+        // express (same constraint as the cnpg bootstrap).
+        phase: Cel.expr(_helmRelease.status.conditions, '.exists(c, c.type == "Ready" && c.status == "True") ? "Ready" : "Installing"'),
+        version: resolvedVersion,
+    };
+});
+//# sourceMappingURL=clickhouse-operator-bootstrap.js.map

package/dist/factories/clickhouse/compositions/clickhouse-operator-bootstrap.js.map

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

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

@@ -0,0 +1,4 @@
+export { CLICKHOUSE_DEFAULT_DATABASE, CLICKHOUSE_HTTP_PORT, CLICKHOUSE_KEEPER_PORT, CLICKHOUSE_NATIVE_PORT, clickHouseCluster, DEFAULT_USER_NETWORKS_IP, makeClickHouseCluster, } from './clickhouse-cluster.js';
+export { clickhouseHelmRepositoryBootstrap } from './clickhouse-helm-repository.js';
+export { clickhouseOperatorBootstrap } from './clickhouse-operator-bootstrap.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickhouse/compositions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC"}

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

@@ -0,0 +1,4 @@
+export { CLICKHOUSE_DEFAULT_DATABASE, CLICKHOUSE_HTTP_PORT, CLICKHOUSE_KEEPER_PORT, CLICKHOUSE_NATIVE_PORT, clickHouseCluster, DEFAULT_USER_NETWORKS_IP, makeClickHouseCluster, } from './clickhouse-cluster.js';
+export { clickhouseHelmRepositoryBootstrap } from './clickhouse-helm-repository.js';
+export { clickhouseOperatorBootstrap } from './clickhouse-operator-bootstrap.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/clickhouse/compositions/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iCAAiC,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/factories/clickhouse/index.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ClickHouse (Altinity clickhouse-operator) Integration for TypeKro
+ *
+ * Provides type-safe factories for managing ClickHouse clusters on Kubernetes
+ * using the OFFICIAL Altinity clickhouse-operator (build-around: the official
+ * `altinity-clickhouse-operator` chart from https://helm.altinity.com,
+ * Apache-2.0 — never hand-rolled manifests).
+ *
+ * ONE OPERATOR PER CLUSTER: the operator is cluster-scoped and owns the
+ * ClickHouse CRDs; install exactly one `clickhouseOperatorBootstrap` per
+ * cluster and point every CHI/CHK at it.
+ *
+ * BUILD-TIME vs RUNTIME: topology (`zones`/`replicas`/`shards`/keeper
+ * presence/user names) is fixed at CONSTRUCTION time via
+ * `makeClickHouseCluster(topology)`; everything else (name, namespace,
+ * version, storage, credentials, keeper host) is proxy-safe RUNTIME spec.
+ *
+ * ## Compositions
+ * - `makeClickHouseCluster(topology)` — build-time topology constructor;
+ *   returns a composition whose runtime spec is fully schema-ref safe and
+ *   whose status exposes the typed connection contract
+ * - `clickHouseCluster` — the default single-node topology
+ * - `clickhouseOperatorBootstrap` — complete operator deployment
+ *   (namespace + shared Helm repo singleton + release)
+ * - `clickhouseHelmRepositoryBootstrap` — shared HelmRepository singleton owner
+ *
+ * ## Resources
+ * - `clickHouseInstallation()` — LOW-LEVEL typed CHI (concrete topology only;
+ *   zone-pinned replica layout, SigNoz-compatible `cluster` name default)
+ * - `clickHouseKeeperInstallation()` — typed CHK (coordination service)
+ * - `clickhouseHelmRepository()` — Altinity Helm chart repository
+ * - `clickhouseOperatorHelmRelease()` — operator installation via Helm
+ *
+ * @example
+ * ```typescript
+ * import {
+ *   clickhouseOperatorBootstrap,
+ *   makeClickHouseCluster,
+ * } from 'typekro/clickhouse';
+ *
+ * // Install the operator (once per cluster)
+ * const operatorFactory = clickhouseOperatorBootstrap.factory('kro', {
+ *   namespace: 'clickhouse-system',
+ * });
+ * await operatorFactory.deploy({ name: 'clickhouse-operator' });
+ *
+ * // Fix the topology at construction, deploy with runtime spec
+ * const clickhouse = makeClickHouseCluster({
+ *   zones: ['us-east-2a', 'us-east-2b'],
+ *   replicas: 2,
+ *   users: [{ name: 'signoz' }],
+ * });
+ * await clickhouse.factory('kro', { namespace: 'observability' }).deploy({
+ *   name: 'signoz-clickhouse',
+ *   namespace: 'observability',
+ *   version: '25.12.5',
+ *   storage: { size: '100Gi', storageClassName: 'gp3-expandable' },
+ *   keeper: { host: 'keeper-signoz.observability.svc.cluster.local' },
+ *   users: { signoz: { passwordSha256Hex: '<sha256-hex>' } },
+ * });
+ * ```
+ *
+ * @see https://github.com/Altinity/clickhouse-operator
+ * @module
+ */
+export * from './compositions/index.js';
+export * from './resources/index.js';
+export * from './types.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/factories/clickhouse/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/factories/clickhouse/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgEG;AACH,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC"}