typekro 0.23.0 → 0.24.1

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"}

package/dist/factories/clickstack/resources/helm.js

@@ -0,0 +1,139 @@
+/**
+ * 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 { DEFAULT_FLUX_NAMESPACE } from '../../../core/config/defaults.js';
+import { setMetadataField } from '../../../core/metadata/resource-metadata.js';
+import { helmRelease } from '../../helm/helm-release.js';
+import { createHelmRepositoryReadinessEvaluator, helmRepository, } from '../../helm/helm-repository.js';
+import { createLabeledHelmReleaseEvaluator } from '../../helm/readiness-evaluators.js';
+/** Official ClickStack Helm chart repository URL (classic repo, not OCI). */
+export const DEFAULT_CLICKSTACK_REPO_URL = 'https://clickhouse.github.io/ClickStack-helm-charts';
+/** Default Flux HelmRepository name for the ClickStack chart repository. */
+export const DEFAULT_CLICKSTACK_REPO_NAME = 'clickstack';
+/** Official ClickStack chart name. */
+export 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 const DEFAULT_CLICKSTACK_VERSION = '3.0.1';
+/** Official OpenTelemetry Helm chart repository URL. */
+export const DEFAULT_OTEL_REPO_URL = 'https://open-telemetry.github.io/opentelemetry-helm-charts';
+/** Default Flux HelmRepository name for the OpenTelemetry chart repository. */
+export const DEFAULT_OTEL_REPO_NAME = 'open-telemetry';
+/** Stock collector chart name. */
+export 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 const DEFAULT_OTEL_COLLECTOR_VERSION = '0.146.1';
+// Chart port facts (values.yaml `hyperdx.ports` and `otel-collector.ports`,
+// chart 3.0.1) — the bootstrap status contract is built on these defaults.
+/** HyperDX UI port (`hyperdx.ports.app`). */
+export const CLICKSTACK_APP_PORT = 3000;
+/** HyperDX API port (`hyperdx.ports.api`). */
+export const CLICKSTACK_API_PORT = 8000;
+/** Gateway collector OTLP/HTTP servicePort (`otel-collector.ports.otlp-http`). */
+export const CLICKSTACK_OTLP_HTTP_PORT = 4318;
+/** Gateway collector OTLP/gRPC servicePort (`otel-collector.ports.otlp`). */
+export const CLICKSTACK_OTLP_GRPC_PORT = 4317;
+/** Suffix the chart appends to `.Release.Name` for the gateway collector Service. */
+export const CLICKSTACK_GATEWAY_NAME_SUFFIX = '-otel-collector';
+/**
+ * Create a Flux HelmRepository for the official ClickStack chart repository.
+ */
+export function clickstackHelmRepository(config) {
+    const repo = helmRepository({
+        name: config.name || DEFAULT_CLICKSTACK_REPO_NAME,
+        namespace: config.namespace || DEFAULT_FLUX_NAMESPACE,
+        url: config.url || DEFAULT_CLICKSTACK_REPO_URL,
+        interval: config.interval || '5m',
+        ...(config.id && { id: config.id }),
+    }).withReadinessEvaluator(createHelmRepositoryReadinessEvaluator('ClickStack'));
+    // One cluster-level Flux source shared by every consumer — never torn down
+    // with an individual instance.
+    setMetadataField(repo, 'scopes', ['cluster']);
+    return repo;
+}
+/**
+ * Create a Flux HelmRepository for the official OpenTelemetry chart repository.
+ */
+export function otelHelmRepository(config) {
+    const repo = helmRepository({
+        name: config.name || DEFAULT_OTEL_REPO_NAME,
+        namespace: config.namespace || DEFAULT_FLUX_NAMESPACE,
+        url: config.url || DEFAULT_OTEL_REPO_URL,
+        interval: config.interval || '5m',
+        ...(config.id && { id: config.id }),
+    }).withReadinessEvaluator(createHelmRepositoryReadinessEvaluator('OpenTelemetry'));
+    setMetadataField(repo, 'scopes', ['cluster']);
+    return repo;
+}
+/**
+ * Create a Flux HelmRelease for ClickStack using the official chart defaults.
+ */
+export function clickstackHelmRelease(config) {
+    return helmRelease({
+        name: config.name,
+        namespace: config.namespace || 'clickstack',
+        chart: {
+            repository: DEFAULT_CLICKSTACK_REPO_URL,
+            name: CLICKSTACK_CHART_NAME,
+            version: config.version || DEFAULT_CLICKSTACK_VERSION,
+        },
+        sourceRef: {
+            name: config.repositoryName || DEFAULT_CLICKSTACK_REPO_NAME,
+            namespace: config.repositoryNamespace || DEFAULT_FLUX_NAMESPACE,
+            kind: 'HelmRepository',
+        },
+        driftDetection: { mode: 'enabled' },
+        values: config.values || {},
+        ...(config.id && { id: config.id }),
+    }).withReadinessEvaluator(createLabeledHelmReleaseEvaluator('ClickStack'));
+}
+/**
+ * Create a Flux HelmRelease for a stock opentelemetry-collector instance
+ * (daemonset or deployment mode is decided by the supplied values).
+ */
+export function otelCollectorHelmRelease(config) {
+    return helmRelease({
+        name: config.name,
+        namespace: config.namespace || 'clickstack-telemetry',
+        chart: {
+            repository: DEFAULT_OTEL_REPO_URL,
+            name: OTEL_COLLECTOR_CHART_NAME,
+            version: config.version || DEFAULT_OTEL_COLLECTOR_VERSION,
+        },
+        sourceRef: {
+            name: config.repositoryName || DEFAULT_OTEL_REPO_NAME,
+            namespace: config.repositoryNamespace || DEFAULT_FLUX_NAMESPACE,
+            kind: 'HelmRepository',
+        },
+        driftDetection: { mode: 'enabled' },
+        values: config.values || {},
+        ...(config.id && { id: config.id }),
+    }).withReadinessEvaluator(createLabeledHelmReleaseEvaluator('OtelCollector'));
+}
+//# sourceMappingURL=helm.js.map

package/dist/factories/clickstack/resources/helm.js.map

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/factories/clickstack/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * ClickStack Internal MongoDB Resources
+ *
+ * HyperDX has a HARD MongoDB dependency for app state (dashboards, alerts,
+ * users, saved sources — MongoDB is SSPL at runtime). The official chart's
+ * bundled MongoDB is a `MongoDBCommunity` CRD owned by the separate
+ * `clickstack-operators` prerequisite chart, which this family deliberately
+ * does NOT install (its ClickHouse operator CRDs would collide with the
+ * Altinity operator; see types.ts). Internal mode therefore provisions a
+ * minimal typekro-native StatefulSet + Service instead — NO operator, NO CRDs.
+ *
+ * ⚠️ LOUD CAVEATS — read before pointing production at this:
+ * - APP METADATA ONLY: observability data lives in ClickHouse; Mongo holds
+ *   HyperDX dashboards/alerts/users. Losing it loses UI state, not telemetry.
+ * - SINGLE REPLICA, NO AUTH: one `mongo:7` pod with a PVC, reachable only
+ *   inside the cluster via its ClusterIP Service. Dev-first sizing — use
+ *   `mongo: { mode: 'external', uri }` for anything with an SLA.
+ */
+import type { Composable, Enhanced } from '../../../core/types/index.js';
+import type { V1ServiceSpec, V1ServiceStatus } from '../../kubernetes/types.js';
+import { type V1StatefulSetSpec, type V1StatefulSetStatus } from '../../kubernetes/workloads/stateful-set.js';
+import type { ClickStackMongoConfig } from '../types.js';
+/** Pinned major-version Mongo image for the internal app-state store. */
+export declare const DEFAULT_CLICKSTACK_MONGO_IMAGE = "mongo:7";
+/** MongoDB port. */
+export declare const CLICKSTACK_MONGO_PORT = 27017;
+/** Default PVC size for the internal Mongo. */
+export declare const DEFAULT_CLICKSTACK_MONGO_STORAGE_SIZE = "5Gi";
+/** Suffix appended to the ClickStack instance name for Mongo resources. */
+export declare const CLICKSTACK_MONGO_NAME_SUFFIX = "-mongodb";
+/**
+ * Create the single-replica internal Mongo StatefulSet (`<name>-mongodb`).
+ */
+export declare function clickstackMongoStatefulSet(config: Composable<ClickStackMongoConfig>): Enhanced<V1StatefulSetSpec, V1StatefulSetStatus>;
+/**
+ * Create the ClusterIP Service (`<name>-mongodb`) fronting the internal Mongo.
+ * `hyperdx.config.MONGO_URI` points at this Service's DNS name.
+ */
+export declare function clickstackMongoService(config: Composable<ClickStackMongoConfig>): Enhanced<V1ServiceSpec, V1ServiceStatus>;
+//# sourceMappingURL=mongo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongo.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/resources/mongo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEhF,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAEzD,yEAAyE;AACzE,eAAO,MAAM,8BAA8B,YAAY,CAAC;AAExD,oBAAoB;AACpB,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAE3C,+CAA+C;AAC/C,eAAO,MAAM,qCAAqC,QAAQ,CAAC;AAE3D,2EAA2E;AAC3E,eAAO,MAAM,4BAA4B,aAAa,CAAC;AAUvD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACxC,QAAQ,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAyDlD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,CAAC,qBAAqB,CAAC,GACxC,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,CAoB1C"}

package/dist/factories/clickstack/resources/mongo.js

@@ -0,0 +1,122 @@
+/**
+ * ClickStack Internal MongoDB Resources
+ *
+ * HyperDX has a HARD MongoDB dependency for app state (dashboards, alerts,
+ * users, saved sources — MongoDB is SSPL at runtime). The official chart's
+ * bundled MongoDB is a `MongoDBCommunity` CRD owned by the separate
+ * `clickstack-operators` prerequisite chart, which this family deliberately
+ * does NOT install (its ClickHouse operator CRDs would collide with the
+ * Altinity operator; see types.ts). Internal mode therefore provisions a
+ * minimal typekro-native StatefulSet + Service instead — NO operator, NO CRDs.
+ *
+ * ⚠️ LOUD CAVEATS — read before pointing production at this:
+ * - APP METADATA ONLY: observability data lives in ClickHouse; Mongo holds
+ *   HyperDX dashboards/alerts/users. Losing it loses UI state, not telemetry.
+ * - SINGLE REPLICA, NO AUTH: one `mongo:7` pod with a PVC, reachable only
+ *   inside the cluster via its ClusterIP Service. Dev-first sizing — use
+ *   `mongo: { mode: 'external', uri }` for anything with an SLA.
+ */
+import { Cel } from '../../../core/references/cel.js';
+import { service } from '../../kubernetes/networking/service.js';
+import { statefulSet, } from '../../kubernetes/workloads/stateful-set.js';
+/** Pinned major-version Mongo image for the internal app-state store. */
+export const DEFAULT_CLICKSTACK_MONGO_IMAGE = 'mongo:7';
+/** MongoDB port. */
+export const CLICKSTACK_MONGO_PORT = 27017;
+/** Default PVC size for the internal Mongo. */
+export const DEFAULT_CLICKSTACK_MONGO_STORAGE_SIZE = '5Gi';
+/** Suffix appended to the ClickStack instance name for Mongo resources. */
+export const CLICKSTACK_MONGO_NAME_SUFFIX = '-mongodb';
+function mongoLabels(instanceName) {
+    return {
+        'app.kubernetes.io/name': 'clickstack-mongodb',
+        'app.kubernetes.io/instance': instanceName,
+        'app.kubernetes.io/managed-by': 'typekro',
+    };
+}
+/**
+ * Create the single-replica internal Mongo StatefulSet (`<name>-mongodb`).
+ */
+export function clickstackMongoStatefulSet(config) {
+    const resourceName = Cel.template('%s%s', config.name, CLICKSTACK_MONGO_NAME_SUFFIX);
+    const labels = mongoLabels(config.name);
+    return statefulSet({
+        metadata: {
+            name: resourceName,
+            namespace: config.namespace,
+            labels,
+        },
+        spec: {
+            // SINGLE REPLICA by design (see module doc) — not configurable.
+            replicas: 1,
+            serviceName: resourceName,
+            selector: { matchLabels: labels },
+            template: {
+                metadata: { labels },
+                spec: {
+                    containers: [
+                        {
+                            name: 'mongodb',
+                            image: config.image ?? DEFAULT_CLICKSTACK_MONGO_IMAGE,
+                            ports: [{ name: 'mongodb', containerPort: CLICKSTACK_MONGO_PORT }],
+                            volumeMounts: [{ name: 'data', mountPath: '/data/db' }],
+                            readinessProbe: {
+                                tcpSocket: { port: CLICKSTACK_MONGO_PORT },
+                                initialDelaySeconds: 5,
+                                periodSeconds: 10,
+                            },
+                            livenessProbe: {
+                                tcpSocket: { port: CLICKSTACK_MONGO_PORT },
+                                initialDelaySeconds: 30,
+                                periodSeconds: 20,
+                            },
+                        },
+                    ],
+                },
+            },
+            volumeClaimTemplates: [
+                {
+                    metadata: { name: 'data' },
+                    spec: {
+                        accessModes: ['ReadWriteOnce'],
+                        resources: {
+                            requests: {
+                                storage: config.storageSize ?? DEFAULT_CLICKSTACK_MONGO_STORAGE_SIZE,
+                            },
+                        },
+                        ...(config.storageClassName !== undefined && {
+                            storageClassName: config.storageClassName,
+                        }),
+                    },
+                },
+            ],
+        },
+        ...(config.statefulSetId && { id: config.statefulSetId }),
+    });
+}
+/**
+ * Create the ClusterIP Service (`<name>-mongodb`) fronting the internal Mongo.
+ * `hyperdx.config.MONGO_URI` points at this Service's DNS name.
+ */
+export function clickstackMongoService(config) {
+    return service({
+        metadata: {
+            name: Cel.template('%s%s', config.name, CLICKSTACK_MONGO_NAME_SUFFIX),
+            namespace: config.namespace,
+            labels: mongoLabels(config.name),
+        },
+        spec: {
+            type: 'ClusterIP',
+            selector: mongoLabels(config.name),
+            ports: [
+                {
+                    name: 'mongodb',
+                    port: CLICKSTACK_MONGO_PORT,
+                    targetPort: CLICKSTACK_MONGO_PORT,
+                },
+            ],
+        },
+        ...(config.serviceId && { id: config.serviceId }),
+    });
+}
+//# sourceMappingURL=mongo.js.map

package/dist/factories/clickstack/resources/mongo.js.map

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