typekro 0.22.1 → 0.24.0

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

@@ -0,0 +1,36 @@
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { Cel } from '../../../core/references/cel.js';
+import { clickstackHelmRepository } from '../resources/helm.js';
+import { ClickStackHelmRepositorySingletonSpecSchema, ClickStackHelmRepositorySingletonStatusSchema, } from '../types.js';
+/**
+ * Shared ClickStack HelmRepository singleton.
+ *
+ * The official ClickStack chart repository
+ * (https://clickhouse.github.io/ClickStack-helm-charts) is a single
+ * cluster-level Flux source — the same URL serves every consumer. Deploying it
+ * inline in the `clickstackBootstrap` 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 every instance's
+ * HelmRelease references it by the same `sourceRef`. (Same pattern as the
+ * dagster/clickhouse bootstraps' shared repositories.)
+ */
+export const clickstackHelmRepositoryBootstrap = kubernetesComposition({
+    name: 'clickstack-helm-repository',
+    kind: 'ClickStackHelmRepository',
+    spec: ClickStackHelmRepositorySingletonSpecSchema,
+    status: ClickStackHelmRepositorySingletonStatusSchema,
+}, (spec) => {
+    const repository = clickstackHelmRepository({
+        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=clickstack-helm-repository.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clickstack-helm-repository.js","sourceRoot":"","sources":["../../../../src/factories/clickstack/compositions/clickstack-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;;;;;;;;;;;;;;GAcG;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/clickstack/compositions/index.d.ts

@@ -0,0 +1,5 @@
+export * from './clickstack-bootstrap.js';
+export * from './clickstack-helm-repository.js';
+export * from './k8s-telemetry.js';
+export * from './otel-helm-repository.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/compositions/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './clickstack-bootstrap.js';
+export * from './clickstack-helm-repository.js';
+export * from './k8s-telemetry.js';
+export * from './otel-helm-repository.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/clickstack/compositions/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}

package/dist/factories/clickstack/compositions/k8s-telemetry.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ClickStack Kubernetes Telemetry Composition.
+ *
+ * The documented ClickStack pattern for collecting cluster telemetry
+ * (https://clickhouse.com/docs/use-cases/observability/clickstack/ingesting-data/kubernetes):
+ * TWO instances of the STOCK `opentelemetry-collector` chart from
+ * https://open-telemetry.github.io/opentelemetry-helm-charts —
+ *
+ * 1. A DAEMONSET instance on every node: presets `logsCollection`,
+ *    `hostMetrics`, `kubernetesAttributes`, `kubeletMetrics` (+ the
+ *    docs-recommended kubeletstats utilization metrics).
+ * 2. A DEPLOYMENT instance (single replica): presets `kubernetesAttributes`,
+ *    `kubernetesEvents`, `clusterMetrics`.
+ *
+ * Both export `otlphttp` to the ClickStack gateway collector (default: the
+ * in-cluster `clickstack-otel-collector` Service on 4318 — prefer wiring
+ * `stack.status.gateway.otlpHttpEndpoint` from the bootstrap's status
+ * contract) authenticated with an `authorization: <HYPERDX_API_KEY>` header.
+ * The key is delivered via a `secretKeyRef` env var and referenced through
+ * OTel `${env:…}` config expansion, so the key value never lands in Helm
+ * values.
+ *
+ * BUILD-TIME vs RUNTIME: per-instance raw chart values are BUILD-TIME options
+ * on `makeClickstackK8sTelemetry(...)` (a free-form values tree cannot be
+ * represented per-instance in a KRO schema without silently dropping it);
+ * the runtime spec carries only proxy-safe values (name, namespace, version,
+ * endpoint, apiKeySecret coordinates).
+ *
+ * This is deliberately NOT the clickstack chart — the gateway collector ships
+ * with `clickstackBootstrap`; these are the per-cluster edge collectors.
+ *
+ * @example
+ * ```typescript
+ * const factory = clickstackK8sTelemetry.factory('kro', {
+ *   namespace: 'clickstack-telemetry',
+ * });
+ *
+ * await factory.deploy({
+ *   name: 'clickstack-telemetry',
+ *   apiKeySecret: { name: 'hyperdx-secret' },
+ *   endpoint: stack.status.gateway.otlpHttpEndpoint,
+ * });
+ * ```
+ */
+import { type ClickStackK8sTelemetryBuildOptions } from '../types.js';
+/**
+ * Construct a k8s telemetry composition. Build-time options bake static raw
+ * chart values per collector instance; everything per-instance stays in the
+ * runtime spec.
+ */
+export declare function makeClickstackK8sTelemetry(options?: ClickStackK8sTelemetryBuildOptions): import("../../../index.js").CallableComposition<{
+    name: string;
+    apiKeySecret: {
+        name: string;
+        key?: string;
+    };
+    namespace?: string;
+    version?: string;
+    endpoint?: string;
+}, {
+    ready: boolean;
+    phase: "Ready" | "Installing";
+}>;
+/** Composition type for the k8s telemetry pair. */
+export type ClickStackK8sTelemetryComposition = ReturnType<typeof makeClickstackK8sTelemetry>;
+/**
+ * The default k8s telemetry composition (no build-time value overrides).
+ * Use `makeClickstackK8sTelemetry(...)` to bake per-instance raw chart values.
+ */
+export declare const clickstackK8sTelemetry: import("../../../index.js").CallableComposition<{
+    name: string;
+    apiKeySecret: {
+        name: string;
+        key?: string;
+    };
+    namespace?: string;
+    version?: string;
+    endpoint?: string;
+}, {
+    ready: boolean;
+    phase: "Ready" | "Installing";
+}>;
+//# sourceMappingURL=k8s-telemetry.d.ts.map

package/dist/factories/clickstack/compositions/k8s-telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s-telemetry.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/compositions/k8s-telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAcH,OAAO,EACL,KAAK,kCAAkC,EAIxC,MAAM,aAAa,CAAC;AAOrB;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,kCAAuC;;;;;;;;;;;;GAoF1F;AAED,mDAAmD;AACnD,MAAM,MAAM,iCAAiC,GAAG,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9F;;;GAGG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;EAA+B,CAAC"}

package/dist/factories/clickstack/compositions/k8s-telemetry.js

@@ -0,0 +1,134 @@
+/**
+ * ClickStack Kubernetes Telemetry Composition.
+ *
+ * The documented ClickStack pattern for collecting cluster telemetry
+ * (https://clickhouse.com/docs/use-cases/observability/clickstack/ingesting-data/kubernetes):
+ * TWO instances of the STOCK `opentelemetry-collector` chart from
+ * https://open-telemetry.github.io/opentelemetry-helm-charts —
+ *
+ * 1. A DAEMONSET instance on every node: presets `logsCollection`,
+ *    `hostMetrics`, `kubernetesAttributes`, `kubeletMetrics` (+ the
+ *    docs-recommended kubeletstats utilization metrics).
+ * 2. A DEPLOYMENT instance (single replica): presets `kubernetesAttributes`,
+ *    `kubernetesEvents`, `clusterMetrics`.
+ *
+ * Both export `otlphttp` to the ClickStack gateway collector (default: the
+ * in-cluster `clickstack-otel-collector` Service on 4318 — prefer wiring
+ * `stack.status.gateway.otlpHttpEndpoint` from the bootstrap's status
+ * contract) authenticated with an `authorization: <HYPERDX_API_KEY>` header.
+ * The key is delivered via a `secretKeyRef` env var and referenced through
+ * OTel `${env:…}` config expansion, so the key value never lands in Helm
+ * values.
+ *
+ * BUILD-TIME vs RUNTIME: per-instance raw chart values are BUILD-TIME options
+ * on `makeClickstackK8sTelemetry(...)` (a free-form values tree cannot be
+ * represented per-instance in a KRO schema without silently dropping it);
+ * the runtime spec carries only proxy-safe values (name, namespace, version,
+ * endpoint, apiKeySecret coordinates).
+ *
+ * This is deliberately NOT the clickstack chart — the gateway collector ships
+ * with `clickstackBootstrap`; these are the per-cluster edge collectors.
+ *
+ * @example
+ * ```typescript
+ * const factory = clickstackK8sTelemetry.factory('kro', {
+ *   namespace: 'clickstack-telemetry',
+ * });
+ *
+ * await factory.deploy({
+ *   name: 'clickstack-telemetry',
+ *   apiKeySecret: { name: 'hyperdx-secret' },
+ *   endpoint: stack.status.gateway.otlpHttpEndpoint,
+ * });
+ * ```
+ */
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { DEFAULT_FLUX_NAMESPACE } from '../../../core/config/defaults.js';
+import { Cel } from '../../../core/references/cel.js';
+import { singleton } from '../../../core/singleton/singleton.js';
+import { containsKubernetesRefs, isKubernetesRef } from '../../../utils/type-guards.js';
+import { namespace } from '../../kubernetes/core/namespace.js';
+import { DEFAULT_OTEL_COLLECTOR_VERSION, DEFAULT_OTEL_REPO_NAME, DEFAULT_OTEL_REPO_URL, otelCollectorHelmRelease, } from '../resources/helm.js';
+import { ClickStackK8sTelemetryConfigSchema, ClickStackK8sTelemetryStatusSchema, } from '../types.js';
+import { DEFAULT_CLICKSTACK_TELEMETRY_NAMESPACE, mapK8sTelemetryConfigToHelmValues, } from '../utils/helm-values-mapper.js';
+import { otelHelmRepositoryBootstrap } from './otel-helm-repository.js';
+/**
+ * Construct a k8s telemetry composition. Build-time options bake static raw
+ * chart values per collector instance; everything per-instance stays in the
+ * runtime spec.
+ */
+export function makeClickstackK8sTelemetry(options = {}) {
+    // Build-time options must be CONCRETE (see makeClickstackBootstrap): per-instance values belong
+    // in the runtime spec.
+    if (containsKubernetesRefs(options)) {
+        throw new Error('makeClickstackK8sTelemetry: build-time options contain a schema/resource reference. ' +
+            'Move per-instance values into the runtime spec instead.');
+    }
+    return kubernetesComposition({
+        name: options.name ?? 'clickstack-k8s-telemetry',
+        kind: options.kind ?? 'ClickStackK8sTelemetry',
+        spec: ClickStackK8sTelemetryConfigSchema,
+        status: ClickStackK8sTelemetryStatusSchema,
+    }, (spec) => {
+        const resolvedNamespace = isKubernetesRef(spec.namespace)
+            ? Cel.default(spec.namespace, DEFAULT_CLICKSTACK_TELEMETRY_NAMESPACE)
+            : (spec.namespace ?? DEFAULT_CLICKSTACK_TELEMETRY_NAMESPACE);
+        const resolvedVersion = isKubernetesRef(spec.version)
+            ? Cel.default(spec.version, DEFAULT_OTEL_COLLECTOR_VERSION)
+            : (spec.version ?? DEFAULT_OTEL_COLLECTOR_VERSION);
+        const { daemonset: daemonsetValues, deployment: deploymentValues } = mapK8sTelemetryConfigToHelmValues(spec, {
+            ...(options.daemonset !== undefined && { daemonset: options.daemonset }),
+            ...(options.deployment !== undefined && { deployment: options.deployment }),
+        });
+        const _telemetryNamespace = namespace({
+            metadata: {
+                name: resolvedNamespace,
+                labels: {
+                    'app.kubernetes.io/name': 'clickstack-k8s-telemetry',
+                    'app.kubernetes.io/instance': spec.name,
+                    'app.kubernetes.io/managed-by': 'typekro',
+                },
+            },
+            id: 'clickstackTelemetryNamespace',
+        });
+        // Shared cluster-level OTel chart repository singleton (ApplySet
+        // ownership rationale documented on otelHelmRepositoryBootstrap).
+        const _otelHelmRepository = singleton(otelHelmRepositoryBootstrap, {
+            id: 'opentelemetry-helm-repository',
+            spec: {
+                name: DEFAULT_OTEL_REPO_NAME,
+                namespace: DEFAULT_FLUX_NAMESPACE,
+                url: DEFAULT_OTEL_REPO_URL,
+            },
+        });
+        // Template-literal names work in both modes: concrete strings in direct
+        // mode, marker tokens rewritten to CEL in KRO mode (searxng precedent).
+        const _daemonsetRelease = otelCollectorHelmRelease({
+            name: `${spec.name}-daemonset`,
+            namespace: resolvedNamespace,
+            version: resolvedVersion,
+            values: daemonsetValues,
+            id: 'clickstackTelemetryDaemonset',
+        });
+        const _deploymentRelease = otelCollectorHelmRelease({
+            name: `${spec.name}-deployment`,
+            namespace: resolvedNamespace,
+            version: resolvedVersion,
+            values: deploymentValues,
+            id: 'clickstackTelemetryDeployment',
+        });
+        return {
+            ready: Cel.expr('clickstackTelemetryDaemonset.status.conditions.exists(c, c.type == "Ready" && c.status == "True") && ' +
+                'clickstackTelemetryDeployment.status.conditions.exists(c, c.type == "Ready" && c.status == "True")'),
+            phase: Cel.expr('clickstackTelemetryDaemonset.status.conditions.exists(c, c.type == "Ready" && c.status == "True") && ' +
+                'clickstackTelemetryDeployment.status.conditions.exists(c, c.type == "Ready" && c.status == "True") ' +
+                '? "Ready" : "Installing"'),
+        };
+    });
+}
+/**
+ * The default k8s telemetry composition (no build-time value overrides).
+ * Use `makeClickstackK8sTelemetry(...)` to bake per-instance raw chart values.
+ */
+export const clickstackK8sTelemetry = makeClickstackK8sTelemetry();
+//# sourceMappingURL=k8s-telemetry.js.map

package/dist/factories/clickstack/compositions/k8s-telemetry.js.map

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

package/dist/factories/clickstack/compositions/otel-helm-repository.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared OpenTelemetry HelmRepository singleton.
+ *
+ * The official OpenTelemetry chart repository
+ * (https://open-telemetry.github.io/opentelemetry-helm-charts) is a single
+ * cluster-level Flux source shared by every `clickstackK8sTelemetry` instance
+ * (and any other OTel chart consumer). Owned via `singleton(...)` for the
+ * same ApplySet-ownership reason documented on
+ * `clickstackHelmRepositoryBootstrap`.
+ */
+export declare const otelHelmRepositoryBootstrap: import("../../../index.js").CallableComposition<{
+    name: string;
+    namespace: string;
+    url: string;
+}, {
+    ready: boolean;
+}>;
+//# sourceMappingURL=otel-helm-repository.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"otel-helm-repository.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/compositions/otel-helm-repository.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B;;;;;;EAsBvC,CAAC"}

package/dist/factories/clickstack/compositions/otel-helm-repository.js

@@ -0,0 +1,31 @@
+import { kubernetesComposition } from '../../../core/composition/imperative.js';
+import { Cel } from '../../../core/references/cel.js';
+import { otelHelmRepository } from '../resources/helm.js';
+import { OtelHelmRepositorySingletonSpecSchema, OtelHelmRepositorySingletonStatusSchema, } from '../types.js';
+/**
+ * Shared OpenTelemetry HelmRepository singleton.
+ *
+ * The official OpenTelemetry chart repository
+ * (https://open-telemetry.github.io/opentelemetry-helm-charts) is a single
+ * cluster-level Flux source shared by every `clickstackK8sTelemetry` instance
+ * (and any other OTel chart consumer). Owned via `singleton(...)` for the
+ * same ApplySet-ownership reason documented on
+ * `clickstackHelmRepositoryBootstrap`.
+ */
+export const otelHelmRepositoryBootstrap = kubernetesComposition({
+    name: 'opentelemetry-helm-repository',
+    kind: 'OpenTelemetryHelmRepository',
+    spec: OtelHelmRepositorySingletonSpecSchema,
+    status: OtelHelmRepositorySingletonStatusSchema,
+}, (spec) => {
+    const repository = otelHelmRepository({
+        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=otel-helm-repository.js.map

package/dist/factories/clickstack/compositions/otel-helm-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel-helm-repository.js","sourceRoot":"","sources":["../../../../src/factories/clickstack/compositions/otel-helm-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yCAAyC,CAAC;AAChF,OAAO,EAAE,GAAG,EAAE,MAAM,iCAAiC,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,qCAAqC,EACrC,uCAAuC,GACxC,MAAM,aAAa,CAAC;AAErB;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAC9D;IACE,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,6BAA6B;IACnC,IAAI,EAAE,qCAAqC;IAC3C,MAAM,EAAE,uCAAuC;CAChD,EACD,CAAC,IAAI,EAAE,EAAE;IACP,MAAM,UAAU,GAAG,kBAAkB,CAAC;QACpC,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/clickstack/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ClickStack (HyperDX) Integration for TypeKro — EXTERNAL ClickHouse only.
+ *
+ * Type-safe deployment primitives for ClickStack observability on Kubernetes
+ * via the OFFICIAL `clickstack` Helm chart (MIT) from
+ * https://clickhouse.github.io/ClickStack-helm-charts, wired to an EXTERNAL
+ * ClickHouse (e.g. an Altinity-operator-managed ClickHouseInstallation).
+ * The chart's bundled ClickHouse and MongoDB are hard-disabled — their CRDs
+ * belong to the `clickstack-operators` prerequisite chart, whose ClickHouse
+ * operator would collide with the Altinity operator.
+ *
+ * ## Compositions
+ * - `clickstackBootstrap` — Namespace + shared HelmRepository singleton +
+ *   optional internal Mongo (StatefulSet/Service) + clickstack HelmRelease
+ *   (HyperDX UI/API/OpAMP + OTel gateway collector).
+ * - `clickstackK8sTelemetry` — the documented k8s ingestion pattern: a
+ *   daemonset + a deployment instance of the STOCK `opentelemetry-collector`
+ *   chart exporting otlphttp to the ClickStack gateway.
+ *
+ * ## Resources
+ * - `clickstackHelmRepository()` / `otelHelmRepository()` — chart repositories
+ * - `clickstackHelmRelease()` / `otelCollectorHelmRelease()` — releases
+ * - `clickstackMongoStatefulSet()` / `clickstackMongoService()` — internal Mongo
+ *
+ * @example
+ * ```typescript
+ * import { clickstackBootstrap } from 'typekro/clickstack';
+ *
+ * const factory = clickstackBootstrap.factory('kro', { namespace: 'clickstack' });
+ * ```
+ *
+ * @see https://github.com/ClickHouse/ClickStack-helm-charts
+ * @see https://clickhouse.com/docs/use-cases/observability/clickstack
+ * @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/clickstack/index.d.ts.map

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

package/dist/factories/clickstack/index.js

@@ -0,0 +1,40 @@
+/**
+ * ClickStack (HyperDX) Integration for TypeKro — EXTERNAL ClickHouse only.
+ *
+ * Type-safe deployment primitives for ClickStack observability on Kubernetes
+ * via the OFFICIAL `clickstack` Helm chart (MIT) from
+ * https://clickhouse.github.io/ClickStack-helm-charts, wired to an EXTERNAL
+ * ClickHouse (e.g. an Altinity-operator-managed ClickHouseInstallation).
+ * The chart's bundled ClickHouse and MongoDB are hard-disabled — their CRDs
+ * belong to the `clickstack-operators` prerequisite chart, whose ClickHouse
+ * operator would collide with the Altinity operator.
+ *
+ * ## Compositions
+ * - `clickstackBootstrap` — Namespace + shared HelmRepository singleton +
+ *   optional internal Mongo (StatefulSet/Service) + clickstack HelmRelease
+ *   (HyperDX UI/API/OpAMP + OTel gateway collector).
+ * - `clickstackK8sTelemetry` — the documented k8s ingestion pattern: a
+ *   daemonset + a deployment instance of the STOCK `opentelemetry-collector`
+ *   chart exporting otlphttp to the ClickStack gateway.
+ *
+ * ## Resources
+ * - `clickstackHelmRepository()` / `otelHelmRepository()` — chart repositories
+ * - `clickstackHelmRelease()` / `otelCollectorHelmRelease()` — releases
+ * - `clickstackMongoStatefulSet()` / `clickstackMongoService()` — internal Mongo
+ *
+ * @example
+ * ```typescript
+ * import { clickstackBootstrap } from 'typekro/clickstack';
+ *
+ * const factory = clickstackBootstrap.factory('kro', { namespace: 'clickstack' });
+ * ```
+ *
+ * @see https://github.com/ClickHouse/ClickStack-helm-charts
+ * @see https://clickhouse.com/docs/use-cases/observability/clickstack
+ * @module
+ */
+export * from './compositions/index.js';
+export * from './resources/index.js';
+export * from './types.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/factories/clickstack/index.js.map

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

package/dist/factories/clickstack/resources/helm.d.ts

@@ -0,0 +1,78 @@
+/**
+ * ClickStack Helm Resource Factories
+ *
+ * Wrappers around the generic Flux Helm factories with ClickStack- and
+ * OpenTelemetry-specific defaults (build-around: we wrap the OFFICIAL charts,
+ * never hand-rolled manifests).
+ *
+ * Charts:
+ * - `clickstack` from https://clickhouse.github.io/ClickStack-helm-charts
+ *   (classic Helm repo, MIT). NOT the archived hyperdxio/helm-charts repo and
+ *   NOT the deprecated `hdx-oss-v2` chart.
+ * - `opentelemetry-collector` from
+ *   https://open-telemetry.github.io/opentelemetry-helm-charts (the stock
+ *   chart used by the documented ClickStack k8s ingestion pattern; it is also
+ *   the clickstack chart's only dependency, vendored as alias `otel-collector`).
+ *
+ * Both chart repositories are cluster-level Flux sources shared by every
+ * consumer, so the bootstrap compositions deploy them via `singleton(...)`
+ * (see compositions/*-helm-repository.ts). NOTE from the clickhouse family:
+ * direct-mode `toYaml()` omits singleton-owned resources — tests must assert
+ * repository URLs on the KRO instance bundle instead.
+ */
+import type { Composable, Enhanced } from '../../../core/types/index.js';
+import { type HelmRepositorySpec, type HelmRepositoryStatus } from '../../helm/helm-repository.js';
+import type { HelmReleaseSpec, HelmReleaseStatus } from '../../helm/types.js';
+import type { ClickStackHelmReleaseConfig, ClickStackHelmRepositoryConfig, OtelCollectorHelmReleaseConfig } from '../types.js';
+/** Official ClickStack Helm chart repository URL (classic repo, not OCI). */
+export declare const DEFAULT_CLICKSTACK_REPO_URL = "https://clickhouse.github.io/ClickStack-helm-charts";
+/** Default Flux HelmRepository name for the ClickStack chart repository. */
+export declare const DEFAULT_CLICKSTACK_REPO_NAME = "clickstack";
+/** Official ClickStack chart name. */
+export declare const CLICKSTACK_CHART_NAME = "clickstack";
+/**
+ * Default clickstack chart version (verified against the live repo index on
+ * 2026-07-06: 3.0.1, appVersion 2.29.0).
+ */
+export declare const DEFAULT_CLICKSTACK_VERSION = "3.0.1";
+/** Official OpenTelemetry Helm chart repository URL. */
+export declare const DEFAULT_OTEL_REPO_URL = "https://open-telemetry.github.io/opentelemetry-helm-charts";
+/** Default Flux HelmRepository name for the OpenTelemetry chart repository. */
+export declare const DEFAULT_OTEL_REPO_NAME = "open-telemetry";
+/** Stock collector chart name. */
+export declare const OTEL_COLLECTOR_CHART_NAME = "opentelemetry-collector";
+/**
+ * Default stock opentelemetry-collector chart version for the k8s telemetry
+ * collectors. Pinned to the same minor the clickstack chart declares for its
+ * gateway subchart dependency (`~0.146.0`; 0.146.1 verified on the live repo
+ * index 2026-07-06) so gateway and edge collectors stay aligned.
+ */
+export declare const DEFAULT_OTEL_COLLECTOR_VERSION = "0.146.1";
+/** HyperDX UI port (`hyperdx.ports.app`). */
+export declare const CLICKSTACK_APP_PORT = 3000;
+/** HyperDX API port (`hyperdx.ports.api`). */
+export declare const CLICKSTACK_API_PORT = 8000;
+/** Gateway collector OTLP/HTTP servicePort (`otel-collector.ports.otlp-http`). */
+export declare const CLICKSTACK_OTLP_HTTP_PORT = 4318;
+/** Gateway collector OTLP/gRPC servicePort (`otel-collector.ports.otlp`). */
+export declare const CLICKSTACK_OTLP_GRPC_PORT = 4317;
+/** Suffix the chart appends to `.Release.Name` for the gateway collector Service. */
+export declare const CLICKSTACK_GATEWAY_NAME_SUFFIX = "-otel-collector";
+/**
+ * Create a Flux HelmRepository for the official ClickStack chart repository.
+ */
+export declare function clickstackHelmRepository(config: Composable<ClickStackHelmRepositoryConfig>): Enhanced<HelmRepositorySpec, HelmRepositoryStatus>;
+/**
+ * Create a Flux HelmRepository for the official OpenTelemetry chart repository.
+ */
+export declare function otelHelmRepository(config: Composable<ClickStackHelmRepositoryConfig>): Enhanced<HelmRepositorySpec, HelmRepositoryStatus>;
+/**
+ * Create a Flux HelmRelease for ClickStack using the official chart defaults.
+ */
+export declare function clickstackHelmRelease(config: Composable<ClickStackHelmReleaseConfig>): Enhanced<HelmReleaseSpec, HelmReleaseStatus>;
+/**
+ * Create a Flux HelmRelease for a stock opentelemetry-collector instance
+ * (daemonset or deployment mode is decided by the supplied values).
+ */
+export declare function otelCollectorHelmRelease(config: Composable<OtelCollectorHelmReleaseConfig>): Enhanced<HelmReleaseSpec, HelmReleaseStatus>;
+//# sourceMappingURL=helm.d.ts.map

package/dist/factories/clickstack/resources/helm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helm.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/resources/helm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAEzE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EAC1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,KAAK,EACV,2BAA2B,EAC3B,8BAA8B,EAC9B,8BAA8B,EAC/B,MAAM,aAAa,CAAC;AAErB,6EAA6E;AAC7E,eAAO,MAAM,2BAA2B,wDAAwD,CAAC;AAEjG,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,eAAe,CAAC;AAEzD,sCAAsC;AACtC,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,0BAA0B,UAAU,CAAC;AAElD,wDAAwD;AACxD,eAAO,MAAM,qBAAqB,+DAA+D,CAAC;AAElG,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,mBAAmB,CAAC;AAEvD,kCAAkC;AAClC,eAAO,MAAM,yBAAyB,4BAA4B,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,YAAY,CAAC;AAKxD,6CAA6C;AAC7C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,8BAA8B,oBAAoB,CAAC;AAEhE;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,CAAC,8BAA8B,CAAC,GACjD,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAgBpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,CAAC,8BAA8B,CAAC,GACjD,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAcpD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,CAAC,2BAA2B,CAAC,GAC9C,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAoB9C;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,UAAU,CAAC,8BAA8B,CAAC,GACjD,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAoB9C"}