typekro 0.33.9 → 0.34.0

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

@@ -195,6 +195,141 @@ export type ClickStackMongoBuildOptions = {
 } | {
     mode: 'external';
 };
+/**
+ * Per-signal retention for the OTel tables the gateway collector creates.
+ *
+ * Values are duration strings — `'30d'`, `'720h'`, `'90m'` — compiled into
+ * `ALTER TABLE ... MODIFY TTL <timestamp column> + INTERVAL <n> <unit> DELETE`.
+ * Omit a signal to leave its table's TTL alone.
+ *
+ * ⚠️ NOT COMPATIBLE WITH `diskType: 's3_plain_rewritable'`, and the
+ * combination is rejected at construction. That metadata type is immutable:
+ * ClickHouse refuses every `ALTER TABLE` on it except settings and comments
+ * (code 344, `SUPPORT_IS_DISABLED` — LIVE-VERIFIED against 25.7), so the
+ * retention CronJob could never apply a TTL there. Use `diskType: 's3'` for
+ * TypeKro-managed TTL, or keep the TTL the collector's own migrations create.
+ */
+export interface ClickStackRetentionOptions {
+    /** `otel_logs` (and `hyperdx_sessions`, which is a log-kind table). */
+    logs?: string;
+    /** `otel_traces`. */
+    traces?: string;
+    /** `otel_metrics_gauge`, `otel_metrics_sum`, `otel_metrics_histogram`. */
+    metrics?: string;
+}
+/**
+ * OTel gateway collector persistent sending queue.
+ *
+ * WHY: the gateway buffers in memory by default, so a ClickHouse restart —
+ * exactly what an S3-backed node rebuild causes — drops whatever is in flight.
+ * A `file_storage`-backed queue survives it, PROVIDED the directory backing it
+ * outlives the collector Pod. Enabling this therefore renders a standalone
+ * PersistentVolumeClaim owned by the composition and mounts it by
+ * `claimName` — never an `emptyDir` or a generic ephemeral volume, both of
+ * which Kubernetes deletes with the Pod.
+ *
+ * ⚠️ EXACTLY ONE GATEWAY COLLECTOR REPLICA. The queue is a bbolt database and
+ * the `file_storage` extension holds an exclusive file lock on it, so a second
+ * collector opening the same directory blocks on that lock
+ * (opentelemetry-collector-contrib issue #5894). A build-time
+ * `values['otel-collector'].replicaCount` above 1 is REJECTED at construction,
+ * and the rendered values pin `replicaCount: 1`. There is deliberately no
+ * shared-volume escape hatch: `ReadWriteMany` would hand every replica the
+ * same locked database. Per-replica queues would need the chart's
+ * `mode: statefulset` with `volumeClaimTemplates`, which this composition does
+ * not model today.
+ *
+ * ⚠️ THE OVERLAY IS ONE YAML DOCUMENT. This is emitted through the chart's
+ * supported `global.otelCollector.customConfig` merge seam, which the ingest
+ * pipelines use too, and a YAML list in that overlay REPLACES the supervisor's
+ * own list rather than appending to it. That means `extensions` below must
+ * enumerate every extension the collector needs, and `exporterNames` must
+ * match exporters the OpAMP supervisor actually defines. Both are exposed as
+ * options precisely because the correct values depend on the ClickStack
+ * version you deploy — check the rendered collector config before relying on
+ * this in production.
+ *
+ * LIVE FINDING (fixed): the overlay used to be assembled by CONCATENATING the
+ * ingest-pipeline YAML and this queue's YAML, and both open a top-level
+ * `service:` key, so the supervisor rejected the whole file
+ * (`mapping key "service" already defined`) and the agent ran with NEITHER.
+ * Contributions are structured fragments now, deep-merged and serialised once
+ * — see `utils/collector-config.ts`.
+ */
+export interface ClickStackPersistentQueueOptions {
+    /** Enable the file-storage-backed sending queue (default: false). */
+    enabled: boolean;
+    /** Queue directory inside the collector pod. */
+    directory?: string;
+    /**
+     * Size of the queue's PersistentVolumeClaim (default: `'10Gi'`).
+     *
+     * There is deliberately NO ephemeral fallback: enabling the queue always
+     * renders a standalone PVC owned by the composition, because a queue that
+     * does not outlive the collector Pod is not a persistent queue. An
+     * `emptyDir` and a *generic ephemeral volume* are both deleted together with
+     * their owning Pod
+     * (https://kubernetes.io/docs/concepts/storage/ephemeral-volumes/), so
+     * either would make this option a no-op under exactly the restart it exists
+     * to survive.
+     */
+    size?: string;
+    /** StorageClass for the queue PVC (cluster default when omitted). */
+    storageClassName?: string;
+    /**
+     * Exporters whose `sending_queue` is switched to file storage. Must be
+     * non-empty when the queue is enabled; defaults to the single ClickHouse
+     * exporter the ClickStack collector defines.
+     *
+     * ⚠️ NOT VALIDATED AT BUILD TIME, BY DESIGN — a name TypeKro cannot check.
+     * The exporter set lives in the remote configuration the OpAMP supervisor
+     * hands the agent, not in anything this factory renders, so a name the agent
+     * does not define cannot be rejected here. It fails SILENTLY at runtime: the
+     * supervisor merges the overlay, the `exporters` map simply grows an exporter
+     * no pipeline references, and the real exporter keeps its in-memory queue.
+     * The integration suite therefore asserts these names against the agent's own
+     * EFFECTIVE configuration instead of trusting the default.
+     */
+    exporterNames?: readonly string[];
+    /**
+     * The complete `service.extensions` list to emit. It REPLACES the
+     * supervisor's list, so it must name every extension the collector needs.
+     */
+    extensions?: readonly string[];
+}
+/**
+ * BUILD-TIME description of the EXTERNAL ClickHouse's storage, plus the
+ * ClickStack-side knobs that depend on it.
+ *
+ * WHY build-time: `retention` renders a DDL CronJob and `persistentQueue`
+ * renders chart values plus volumes — both decide WHICH resources exist and
+ * what static text they carry, the same class as the Mongo mode.
+ *
+ * NO PER-TABLE DDL IS NEEDED for the storage policy itself: the `clickhouse`
+ * factory sets `merge_tree/storage_policy` as the server DEFAULT, so the
+ * gateway collector's goose migrations create `otel_logs` / `otel_traces` /
+ * `otel_metrics_*` / `hyperdx_sessions` on the S3 policy without any
+ * `SETTINGS storage_policy` clause (see the SCHEMA caveat in
+ * `compositions/clickstack-bootstrap.ts`). These options exist for the two
+ * things the server default cannot express — TTL and the collector queue — and
+ * to surface the mode on the status contract.
+ */
+export interface ClickStackStorageOptions {
+    /** Storage mode of the external ClickHouse (default: 'pvc'). */
+    mode?: 'pvc' | 's3';
+    /** Object-storage disk type, echoed onto the status contract. */
+    diskType?: 's3' | 's3_plain_rewritable';
+    /** The external ClickHouse's default MergeTree policy (default: 's3_main'). */
+    policyName?: string;
+    /** Per-signal TTL, rendered as an idempotent DDL CronJob. */
+    retention?: ClickStackRetentionOptions;
+    /** Cron schedule for the retention DDL CronJob (default: '17 * * * *'). */
+    retentionSchedule?: string;
+    /** Image running `clickhouse-client` for the retention DDL. */
+    retentionImage?: string;
+    /** OTel gateway collector persistent sending queue. */
+    persistentQueue?: ClickStackPersistentQueueOptions;
+}
 /** Shared build-time options for both bootstrap variants. */
 interface ClickStackBuildOptionsBase {
     /**
@@ -214,6 +349,12 @@ interface ClickStackBuildOptionsBase {
     name?: string;
     /** KRO kind override. */
     kind?: string;
+    /**
+     * The external ClickHouse's storage story and the ClickStack-side knobs that
+     * depend on it (TTL retention, collector persistent queue, status contract).
+     * Omit for the PVC default — existing behaviour is unchanged.
+     */
+    storage?: ClickStackStorageOptions;
 }
 /** Build-time options for inline credentials with internal Mongo. */
 export type ClickStackInlineInternalMongoBuildOptions = ClickStackBuildOptionsBase & {
@@ -446,18 +587,29 @@ export type ClickStackBootstrapRuntimeConfig = (ClickStackBootstrapConfig | Clic
  * `fullnameOverride` is set) and the gateway Service is
  * `<name>-otel-collector` (subchart naming off `.Release.Name`).
  *
- * KRO STATUS vs CLIENT-HYDRATED SPLIT: fields anchored on the owned
- * HelmRelease resource serialize as KRO status CEL and appear on the live
- * KRO CR's status (GitOps/KRO consumers can read them): `ready`, `phase`,
+ * EVERY DECLARED FIELD IS OBSERVABLE THROUGH KRO. Fields anchored on the owned
+ * HelmRelease serialize as KRO status CEL directly: `ready`, `phase`,
  * `ui.url`, `gateway.otlpHttpEndpoint`, `gateway.otlpGrpcEndpoint`,
  * `app.host` — natural JS template literals over
  * `clickstackHelmRelease.metadata.name`/`.namespace` (bimodal on typekro
  * >= 0.24.0: status CEL in `factory('kro')`, concrete strings via direct-mode
  * re-execution), never `schema.spec.*` (KRO status CEL cannot reference the
- * instance spec). The BARE build-time constants `app.appPort` (3000) and
- * `app.apiPort` (8000), plus the spec-derived `version`, have no resource
- * anchor and are hydrated CLIENT-SIDE by TypeKro (absent from the KRO CR
- * status); the ports remain KRO-visible inside the URL fields.
+ * instance spec).
+ *
+ * `version` is anchored on that same HelmRelease — its chart pin,
+ * `clickstackHelmRelease.spec.chart.spec.version` — so the reported version is
+ * the one Flux is reconciling rather than an echo of the request.
+ *
+ * The remaining fields — `app.appPort`, `app.apiPort`, and the whole `storage`
+ * block — are CONSTRUCTION-TIME values with no owned resource that already
+ * carries them. Emitted as literals they were dropped by KRO, so the declared
+ * schema promised fields the live CR never carried. The composition instead
+ * writes them into a ConfigMap it OWNS (`<release>-contract`) and projects
+ * them back from that resource, so `kubectl get clickstackbootstraps -o yaml`
+ * shows the whole contract. The ConfigMap's values are strings, so the ports
+ * come back through CEL `int(...)` and `persistentQueue` through an
+ * `== "true"` comparison.
+ *
  * Ports are the chart defaults (`hyperdx.ports`, `otel-collector.ports`);
  * port overrides via build-time raw values are NOT reflected here.
  */
@@ -476,6 +628,17 @@ export declare const ClickStackBootstrapStatusSchema: import("arktype/internal/v
         appPort: number;
         apiPort: number;
     };
+    storage: {
+        mode: "pvc" | "s3";
+        diskType?: "s3" | "s3_plain_rewritable";
+        policyName?: string;
+        retention?: {
+            logs?: string;
+            traces?: string;
+            metrics?: string;
+        };
+        persistentQueue?: boolean;
+    };
     version?: string;
 }, {}>;
 /** Observed status type for ClickStack bootstrap. */
@@ -560,46 +723,62 @@ export declare const ClickStackHelmRepositoryConfigSchema: import("arktype/inter
 }, {}>;
 /** Configuration for the ClickStack HelmRepository wrapper. */
 export type ClickStackHelmRepositoryConfig = typeof ClickStackHelmRepositoryConfigSchema.infer;
-/** Configuration for the ClickStack HelmRelease wrapper. */
-export interface ClickStackHelmReleaseConfig {
+/**
+ * ArkType schema for ClickStackHelmReleaseConfig.
+ *
+ * `values` and `valuesFrom` are validated as `object` / `object[]` and carry
+ * their precise TypeScript types through `.as<>()`. Neither is a shape ArkType
+ * can describe: a values tree is an OPEN chart-values document that may also
+ * be a runtime {@link ValuesMergeExpression}, and `valuesFrom` entries may be
+ * graph-aware {@link TypeKroValue}s. Restating either as a schema shape would
+ * make it a second source of truth for the chart's own values contract; the
+ * cast keeps the config INFERRED whole from this schema instead of needing a
+ * hand-written widening layer on top of `.infer`.
+ */
+export declare const ClickStackHelmReleaseConfigSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     name: string;
     namespace?: string;
     version?: string;
     repositoryName?: string;
     repositoryNamespace?: string;
-    /** Official clickstack chart values (graph-aware trees / runtime merges allowed). */
     values?: ClickStackMappedHelmValues;
-    /** Secret/ConfigMap values overlays resolved by Flux before inline values. */
     valuesFrom?: TypeKroValue<HelmReleaseValuesFromSource>[];
     id?: string;
-}
-/** Configuration for a stock opentelemetry-collector HelmRelease wrapper. */
-export interface OtelCollectorHelmReleaseConfig {
+}, {}>;
+/** Configuration for the ClickStack HelmRelease wrapper. */
+export type ClickStackHelmReleaseConfig = typeof ClickStackHelmReleaseConfigSchema.infer;
+/**
+ * ArkType schema for OtelCollectorHelmReleaseConfig.
+ *
+ * See {@link ClickStackHelmReleaseConfigSchema} for why `values` is an
+ * `object` carrying its precise type through `.as<>()`.
+ */
+export declare const OtelCollectorHelmReleaseConfigSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     name: string;
     namespace?: string;
     version?: string;
     repositoryName?: string;
     repositoryNamespace?: string;
-    /** Stock opentelemetry-collector chart values (graph-aware trees / runtime merges allowed). */
     values?: OtelCollectorMappedHelmValues;
     id?: string;
-}
-/** Configuration for the internal-mode MongoDB StatefulSet/Service pair. */
-export interface ClickStackMongoConfig {
-    /** ClickStack instance name; resources are named `<name>-mongodb`. */
+}, {}>;
+/** Configuration for a stock opentelemetry-collector HelmRelease wrapper. */
+export type OtelCollectorHelmReleaseConfig = typeof OtelCollectorHelmReleaseConfigSchema.infer;
+/**
+ * ArkType schema for ClickStackMongoConfig.
+ *
+ * Configuration for the internal-mode MongoDB StatefulSet/Service pair.
+ */
+export declare const ClickStackMongoConfigSchema: import("arktype/internal/variants/object.ts").ObjectType<{
     name: string;
-    /** Target namespace. */
     namespace: string;
-    /** PVC size (default: '5Gi'). Build-time concrete value. */
     storageSize?: string;
-    /** Optional StorageClass for the PVC. Build-time concrete value. */
     storageClassName?: string;
-    /** Mongo image (default: 'mongo:7'). */
     image?: string;
-    /** Resource id for the StatefulSet. */
     statefulSetId?: string;
-    /** Resource id for the Service. */
     serviceId?: string;
-}
+}, {}>;
+/** Configuration for the internal-mode MongoDB StatefulSet/Service pair. */
+export type ClickStackMongoConfig = typeof ClickStackMongoConfigSchema.infer;
 export {};
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/factories/clickstack/types.js

@@ -203,18 +203,29 @@ export const ClickStackSecretValuesExternalMongoBootstrapConfigSchema = type({
  * `fullnameOverride` is set) and the gateway Service is
  * `<name>-otel-collector` (subchart naming off `.Release.Name`).
  *
- * KRO STATUS vs CLIENT-HYDRATED SPLIT: fields anchored on the owned
- * HelmRelease resource serialize as KRO status CEL and appear on the live
- * KRO CR's status (GitOps/KRO consumers can read them): `ready`, `phase`,
+ * EVERY DECLARED FIELD IS OBSERVABLE THROUGH KRO. Fields anchored on the owned
+ * HelmRelease serialize as KRO status CEL directly: `ready`, `phase`,
  * `ui.url`, `gateway.otlpHttpEndpoint`, `gateway.otlpGrpcEndpoint`,
  * `app.host` — natural JS template literals over
  * `clickstackHelmRelease.metadata.name`/`.namespace` (bimodal on typekro
  * >= 0.24.0: status CEL in `factory('kro')`, concrete strings via direct-mode
  * re-execution), never `schema.spec.*` (KRO status CEL cannot reference the
- * instance spec). The BARE build-time constants `app.appPort` (3000) and
- * `app.apiPort` (8000), plus the spec-derived `version`, have no resource
- * anchor and are hydrated CLIENT-SIDE by TypeKro (absent from the KRO CR
- * status); the ports remain KRO-visible inside the URL fields.
+ * instance spec).
+ *
+ * `version` is anchored on that same HelmRelease — its chart pin,
+ * `clickstackHelmRelease.spec.chart.spec.version` — so the reported version is
+ * the one Flux is reconciling rather than an echo of the request.
+ *
+ * The remaining fields — `app.appPort`, `app.apiPort`, and the whole `storage`
+ * block — are CONSTRUCTION-TIME values with no owned resource that already
+ * carries them. Emitted as literals they were dropped by KRO, so the declared
+ * schema promised fields the live CR never carried. The composition instead
+ * writes them into a ConfigMap it OWNS (`<release>-contract`) and projects
+ * them back from that resource, so `kubectl get clickstackbootstraps -o yaml`
+ * shows the whole contract. The ConfigMap's values are strings, so the ports
+ * come back through CEL `int(...)` and `persistentQueue` through an
+ * `== "true"` comparison.
+ *
  * Ports are the chart defaults (`hyperdx.ports`, `otel-collector.ports`);
  * port overrides via build-time raw values are NOT reflected here.
  */
@@ -223,7 +234,7 @@ export const ClickStackBootstrapStatusSchema = type({
     ready: 'boolean',
     /** Coarse phase from the owned HelmRelease Ready condition. */
     phase: '"Ready" | "Installing" | "Failed"',
-    /** Configured chart version. */
+    /** Chart version pinned on the owned HelmRelease. */
     'version?': 'string',
     /** HyperDX UI. */
     ui: {
@@ -246,6 +257,29 @@ export const ClickStackBootstrapStatusSchema = type({
         /** API port. */
         apiPort: 'number.integer',
     },
+    /**
+     * Storage contract of the external ClickHouse this stack writes to, next to
+     * `gateway.otlpHttpEndpoint` so a consumer reads durability and ingest from
+     * one place. Construction-time values, PROJECTED from the owned
+     * `<release>-contract` ConfigMap so they appear on the live KRO CR status
+     * (same treatment as `app.appPort`/`apiPort` and `version`).
+     */
+    storage: {
+        /** 'pvc' or 's3'. */
+        mode: '"pvc" | "s3"',
+        /** Object-storage disk type of the external ClickHouse. */
+        'diskType?': '"s3" | "s3_plain_rewritable"',
+        /** Default MergeTree storage policy the OTel tables are created on. */
+        'policyName?': 'string',
+        /** Configured per-signal TTL, when a retention CronJob is rendered. */
+        'retention?': {
+            'logs?': 'string',
+            'traces?': 'string',
+            'metrics?': 'string',
+        },
+        /** Whether the gateway collector uses a file-storage sending queue. */
+        'persistentQueue?': 'boolean',
+    },
 });
 /**
  * ArkType schema for ClickStackK8sTelemetryConfig (runtime spec).
@@ -329,4 +363,68 @@ export const ClickStackHelmRepositoryConfigSchema = type({
     'interval?': 'string',
     'id?': 'string',
 });
+/**
+ * ArkType schema for ClickStackHelmReleaseConfig.
+ *
+ * `values` and `valuesFrom` are validated as `object` / `object[]` and carry
+ * their precise TypeScript types through `.as<>()`. Neither is a shape ArkType
+ * can describe: a values tree is an OPEN chart-values document that may also
+ * be a runtime {@link ValuesMergeExpression}, and `valuesFrom` entries may be
+ * graph-aware {@link TypeKroValue}s. Restating either as a schema shape would
+ * make it a second source of truth for the chart's own values contract; the
+ * cast keeps the config INFERRED whole from this schema instead of needing a
+ * hand-written widening layer on top of `.infer`.
+ */
+export const ClickStackHelmReleaseConfigSchema = type({
+    name: 'string',
+    'namespace?': 'string',
+    'version?': 'string',
+    'repositoryName?': 'string',
+    'repositoryNamespace?': 'string',
+    /** Official clickstack chart values (graph-aware trees / runtime merges allowed). */
+    'values?': type('object').as(),
+    /** Secret/ConfigMap values overlays resolved by Flux before inline values. */
+    'valuesFrom?': type('object[]').as(),
+    'id?': 'string',
+});
+/**
+ * ArkType schema for OtelCollectorHelmReleaseConfig.
+ *
+ * See {@link ClickStackHelmReleaseConfigSchema} for why `values` is an
+ * `object` carrying its precise type through `.as<>()`.
+ */
+export const OtelCollectorHelmReleaseConfigSchema = type({
+    name: 'string',
+    'namespace?': 'string',
+    'version?': 'string',
+    'repositoryName?': 'string',
+    'repositoryNamespace?': 'string',
+    /** Stock opentelemetry-collector chart values (graph-aware trees / runtime merges allowed). */
+    'values?': type('object').as(),
+    'id?': 'string',
+});
+// ============================================================================
+// Internal Mongo resources
+// ============================================================================
+/**
+ * ArkType schema for ClickStackMongoConfig.
+ *
+ * Configuration for the internal-mode MongoDB StatefulSet/Service pair.
+ */
+export const ClickStackMongoConfigSchema = type({
+    /** ClickStack instance name; resources are named `<name>-mongodb`. */
+    name: 'string',
+    /** Target namespace. */
+    namespace: 'string',
+    /** PVC size (default: '5Gi'). Build-time concrete value. */
+    'storageSize?': 'string',
+    /** Optional StorageClass for the PVC. Build-time concrete value. */
+    'storageClassName?': 'string',
+    /** Mongo image (default: 'mongo:7'). */
+    'image?': 'string',
+    /** Resource id for the StatefulSet. */
+    'statefulSetId?': 'string',
+    /** Resource id for the Service. */
+    'serviceId?': 'string',
+});
 //# sourceMappingURL=types.js.map

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

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

package/dist/factories/clickstack/utils/collector-config.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Composition of the gateway collector's `custom.config.yaml` overlay.
+ *
+ * The ClickStack chart renders `global.otelCollector.customConfig` verbatim
+ * into a ConfigMap, mounts it at
+ * `/etc/otelcol-contrib/custom/custom.config.yaml`, and the OpAMP supervisor
+ * merges that file into the remote configuration it hands the agent. It is one
+ * YAML DOCUMENT, so every contributor to it has to land in ONE mapping.
+ *
+ * ⚠️ WHY THIS MODULE EXISTS — LIVE FINDING. The overlay used to be assembled by
+ * CONCATENATING two hand-written YAML strings: the ingest pipelines
+ * (`CLICKSTACK_INGEST_PIPELINES_CONFIG` in `helm-values-mapper.ts`) and the
+ * persistent queue's own wiring (`renderPersistentQueueConfig` in
+ * `storage.ts`). Both open a top-level `service:` key, so the concatenated
+ * document declared `service` twice and the supervisor rejected the WHOLE FILE
+ * on every poll:
+ *
+ *   Could not merge local config file: /etc/otelcol-contrib/custom/custom.config.yaml
+ *   yaml: unmarshal errors: line 18: mapping key "service" already defined at line 1
+ *
+ * The agent then ran with NEITHER the ingest pipelines NOR the queue — while
+ * the Pod still reported Ready, because readiness comes from the supervisor's
+ * `health_check` and not from the agent. Enabling the persistent queue was a
+ * silent no-op that also took OTLP ingestion down.
+ *
+ * So fragments are STRUCTURED OBJECTS here, deep-merged into a single document
+ * and serialised exactly once. Duplicate keys are unrepresentable: a colliding
+ * mapping key is either merged (two mappings, two sequences) or a loud
+ * construction-time error (anything else).
+ *
+ * ⚠️ THE MERGE IS A PUBLIC ENTRY POINT, so it treats fragment keys as
+ * UNTRUSTED. Names in a fragment come from caller options
+ * (`storage.persistentQueue.exporterNames`, `.extensions`) and become object
+ * keys, and JavaScript reserves a few of those — see
+ * {@link UNSAFE_MAPPING_KEYS} for the two live failure modes (a mutated
+ * `Object.prototype`, and a key the serialiser drops) and why the fix is a
+ * refusal plus null-prototype dictionaries rather than a filter.
+ */
+/** One structured contribution to the collector overlay. */
+export type CollectorConfigFragment = Record<string, unknown>;
+/**
+ * Reject a mapping key that would mean something to the object model.
+ *
+ * @param key - The candidate mapping key
+ * @param path - Path segments of the key's parent, for the error message
+ * @throws Error when the key is one of {@link UNSAFE_MAPPING_KEYS}
+ */
+export declare function assertSafeCollectorConfigKey(key: string, path?: readonly string[]): void;
+/**
+ * Deep-merge collector overlay fragments into one document.
+ *
+ * EXPLICIT CONFLICT POLICY, because a silent winner here is exactly the class
+ * of bug this module was written to remove:
+ *
+ * - **mapping + mapping** → merged key by key, recursively.
+ * - **sequence + sequence** → concatenated, de-duplicated, order preserved.
+ *   This is what makes `service.extensions` composable: a fragment that needs
+ *   `file_storage/hyperdx` adds it without erasing what another fragment
+ *   contributed. (It does NOT change the fact that the overlay's list REPLACES
+ *   the supervisor's own — that merge happens later, inside the supervisor.)
+ * - **identical scalars** → kept.
+ * - **anything else** → THROWS, naming the path and both values. Two fragments
+ *   disagreeing about a scalar (or about whether a key is a map, a list or a
+ *   scalar) is a construction-time bug, and guessing which one wins would put
+ *   the collector back into the silent-misconfiguration territory above.
+ *
+ * The result is a fresh structure: no fragment is mutated and nothing in the
+ * result aliases one, so a module-level fragment constant can be merged any
+ * number of times — see {@link cloneValue}.
+ *
+ * Every mapping in the result is a NULL-PROTOTYPE dictionary and every key is
+ * checked against {@link UNSAFE_MAPPING_KEYS} before it is used, at every
+ * depth. A fragment carrying `__proto__`, `constructor` or `prototype` as a
+ * mapping key is refused with the path named — it cannot reach
+ * `Object.prototype`, and it cannot be quietly dropped by the serialiser
+ * either.
+ *
+ * @param fragments - Structured overlay fragments, in precedence-free order
+ * @returns One merged configuration object (prototype-less at every level)
+ * @throws Error when two fragments set the same path to incompatible values,
+ *   or when any fragment uses an object-model member as a mapping key
+ */
+export declare function mergeCollectorConfig(fragments: readonly CollectorConfigFragment[]): CollectorConfigFragment;
+/**
+ * Merge overlay fragments and serialise them ONCE.
+ *
+ * The single `yaml.dump` is the point: a rendered overlay can no longer carry
+ * a duplicate top-level key, whatever its fragments contribute.
+ *
+ * ROUND-TRIP NOTE (VERIFIED, and pinned by a test): js-yaml is not the problem
+ * here. On the default schema `dump` EMITS a `__proto__` key and `load` reads
+ * it back as an ORDINARY own property without touching `Object.prototype`, so
+ * the document round-trips faithfully in both directions. The damage was
+ * entirely on this side of the serialiser — see {@link UNSAFE_MAPPING_KEYS} —
+ * and it is fixed there: the key is refused, so a rendered overlay never
+ * contains one to begin with.
+ *
+ * @param fragments - Structured overlay fragments
+ * @returns The `global.otelCollector.customConfig` document
+ * @throws Error when the fragments conflict or use an object-model member as a
+ *   mapping key (see {@link mergeCollectorConfig})
+ */
+export declare function renderCollectorConfig(fragments: readonly CollectorConfigFragment[]): string;
+//# sourceMappingURL=collector-config.d.ts.map

package/dist/factories/clickstack/utils/collector-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector-config.d.ts","sourceRoot":"","sources":["../../../../src/factories/clickstack/utils/collector-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,4DAA4D;AAC5D,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AA8C9D;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,SAAS,MAAM,EAAO,GAAG,IAAI,CAU5F;AAsED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,SAAS,uBAAuB,EAAE,GAC5C,uBAAuB,CAMzB;AAwCD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,GAAG,MAAM,CAY3F"}