autotel 7.1.0 → 7.3.0

package/dist/testing.cjs

@@ -8,6 +8,37 @@ let _opentelemetry_api = require("@opentelemetry/api");
 let node_async_hooks = require("node:async_hooks");
 node_async_hooks = require_rolldown_runtime.__toESM(node_async_hooks, 1);
 
+//#region src/memory-exporter.ts
+function toRecordedSpan(span) {
+	return {
+		name: span.name,
+		traceId: span.spanContext().traceId,
+		spanId: span.spanContext().spanId,
+		parentSpanId: span.parentSpanContext?.spanId,
+		durationMs: span.duration[0] * 1e3 + span.duration[1] / 1e6,
+		attributes: { ...span.attributes },
+		status: span.status
+	};
+}
+function createMemoryExporter() {
+	const collected = [];
+	return {
+		export(spans, resultCallback) {
+			for (const span of spans) collected.push(toRecordedSpan(span));
+			resultCallback({ code: 0 });
+		},
+		async shutdown() {},
+		async forceFlush() {},
+		spans: () => [...collected],
+		findSpan: (name) => collected.find((span) => span.name === name),
+		findSpans: (name) => collected.filter((span) => span.name === name),
+		reset: () => {
+			collected.length = 0;
+		}
+	};
+}
+
+//#endregion
 //#region src/testing.ts
 /**
 * Testing Utilities
@@ -479,6 +510,7 @@ exports.assertTraceDuration = assertTraceDuration;
 exports.assertTraceFailed = assertTraceFailed;
 exports.assertTraceSucceeded = assertTraceSucceeded;
 exports.createEventCollector = require_event_testing.createEventCollector;
+exports.createMemoryExporter = createMemoryExporter;
 exports.createMockLogger = createMockLogger;
 exports.createTraceCollector = createTraceCollector;
 exports.getTraceDuration = getTraceDuration;

package/dist/testing.d.cts

@@ -2,7 +2,32 @@ import { t as UnknownRecord } from "./values-CeMH-mYG.cjs";
 import { s as Logger } from "./logger-S1Fgl0g3.cjs";
 import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CBtnJXE5.cjs";
 import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.cjs";
+import { SpanExporter } from "@opentelemetry/sdk-trace-base";
 import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
+//#region src/memory-exporter.d.ts
+/** One finished span, flattened to the fields an assertion usually wants. */
+interface RecordedSpan {
+  name: string;
+  traceId: string;
+  spanId: string;
+  parentSpanId: string | undefined;
+  /** Wall-clock duration of the span, in milliseconds. */
+  durationMs: number;
+  attributes: Attributes;
+  status: SpanStatus;
+}
+interface MemoryExporter extends SpanExporter {
+  /** Every span exported so far, in the order it finished. */
+  spans(): RecordedSpan[];
+  /** The first span with this name, or undefined. */
+  findSpan(name: string): RecordedSpan | undefined;
+  /** Every span with this name. */
+  findSpans(name: string): RecordedSpan[];
+  /** Discard what has been collected. */
+  reset(): void;
+}
+declare function createMemoryExporter(): MemoryExporter;
+//#endregion
 //#region src/testing.d.ts
 /**
  * Note: OpenTelemetry exporters and processors have moved to dedicated modules
@@ -290,4 +315,4 @@ declare function getTraceDuration(collector: TraceCollector, operationName: stri
  */
 declare function assertTraceDuration(collector: TraceCollector, operationName: string, maxDurationMs: number): void;
 //#endregion
-export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
+export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type MemoryExporter, type RecordedSpan, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMemoryExporter, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };

package/dist/testing.d.ts

@@ -2,7 +2,32 @@ import { t as UnknownRecord } from "./values-CeMH-mYG.js";
 import { s as Logger } from "./logger-S1Fgl0g3.js";
 import { a as EventsValue, c as createEventCollector, i as EventsOutcome, n as EventData, o as assertEventTracked, r as EventsFunnelStep, s as assertOutcomeTracked, t as EventCollector } from "./event-testing-CkPgV3Ii.js";
 import { SerializedSpan, TestSpanCollector, serializeSpan } from "./test-span-collector.js";
+import { SpanExporter } from "@opentelemetry/sdk-trace-base";
 import { Attributes, Link, SpanKind, SpanStatus, SpanStatusCode } from "@opentelemetry/api";
+//#region src/memory-exporter.d.ts
+/** One finished span, flattened to the fields an assertion usually wants. */
+interface RecordedSpan {
+  name: string;
+  traceId: string;
+  spanId: string;
+  parentSpanId: string | undefined;
+  /** Wall-clock duration of the span, in milliseconds. */
+  durationMs: number;
+  attributes: Attributes;
+  status: SpanStatus;
+}
+interface MemoryExporter extends SpanExporter {
+  /** Every span exported so far, in the order it finished. */
+  spans(): RecordedSpan[];
+  /** The first span with this name, or undefined. */
+  findSpan(name: string): RecordedSpan | undefined;
+  /** Every span with this name. */
+  findSpans(name: string): RecordedSpan[];
+  /** Discard what has been collected. */
+  reset(): void;
+}
+declare function createMemoryExporter(): MemoryExporter;
+//#endregion
 //#region src/testing.d.ts
 /**
  * Note: OpenTelemetry exporters and processors have moved to dedicated modules
@@ -290,4 +315,4 @@ declare function getTraceDuration(collector: TraceCollector, operationName: stri
  */
 declare function assertTraceDuration(collector: TraceCollector, operationName: string, maxDurationMs: number): void;
 //#endregion
-export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
+export { type EventCollector, type EventData, type EventsFunnelStep, type EventsOutcome, type EventsValue, LogCollector, LogEntry, type MemoryExporter, type RecordedSpan, type SerializedSpan, SpanMatch, TestSpan, TestSpanCollector, TraceCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMemoryExporter, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };

package/dist/testing.js

@@ -5,6 +5,37 @@ import { TestSpanCollector, serializeSpan } from "./test-span-collector.js";
 import { SpanStatusCode, context, trace } from "@opentelemetry/api";
 import * as nodeAsyncHooks from "node:async_hooks";
 
+//#region src/memory-exporter.ts
+function toRecordedSpan(span) {
+	return {
+		name: span.name,
+		traceId: span.spanContext().traceId,
+		spanId: span.spanContext().spanId,
+		parentSpanId: span.parentSpanContext?.spanId,
+		durationMs: span.duration[0] * 1e3 + span.duration[1] / 1e6,
+		attributes: { ...span.attributes },
+		status: span.status
+	};
+}
+function createMemoryExporter() {
+	const collected = [];
+	return {
+		export(spans, resultCallback) {
+			for (const span of spans) collected.push(toRecordedSpan(span));
+			resultCallback({ code: 0 });
+		},
+		async shutdown() {},
+		async forceFlush() {},
+		spans: () => [...collected],
+		findSpan: (name) => collected.find((span) => span.name === name),
+		findSpans: (name) => collected.filter((span) => span.name === name),
+		reset: () => {
+			collected.length = 0;
+		}
+	};
+}
+
+//#endregion
 //#region src/testing.ts
 /**
 * Testing Utilities
@@ -466,4 +497,4 @@ function assertTraceDuration(collector, operationName, maxDurationMs) {
 }
 
 //#endregion
-export { TestSpanCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };
+export { TestSpanCollector, assertEventTracked, assertNoErrors, assertNoErrorsLogged, assertOutcomeTracked, assertTraceCreated, assertTraceDuration, assertTraceFailed, assertTraceSucceeded, createEventCollector, createMemoryExporter, createMockLogger, createTraceCollector, getTraceDuration, serializeSpan, waitForTrace };

package/dist/webhook.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_structured_error = require('./structured-error--_wXpd_C.cjs');
-const require_functional = require('./functional-BhhP4Er_.cjs');
+const require_functional = require('./functional-DHlD7V0x.cjs');
 const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");
 

package/dist/webhook.js

@@ -1,5 +1,5 @@
 import { r as recordStructuredError } from "./structured-error-YIuka-FE.js";
-import { c as withTracing } from "./functional-Cub1ku-C.js";
+import { c as withTracing } from "./functional-C4js2vTM.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { SpanKind, trace } from "@opentelemetry/api";
 

package/dist/workflow-distributed.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_values = require('./values-DApyq53y.cjs');
-const require_functional = require('./functional-BhhP4Er_.cjs');
+const require_functional = require('./functional-DHlD7V0x.cjs');
 const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 const require_business_baggage = require('./business-baggage.cjs');
 let _opentelemetry_api = require("@opentelemetry/api");

package/dist/workflow-distributed.js

@@ -1,5 +1,5 @@
 import { h as isFunction, x as toError } from "./values-BenyvWKz.js";
-import { c as withTracing } from "./functional-Cub1ku-C.js";
+import { c as withTracing } from "./functional-C4js2vTM.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { createSafeBaggageSchema } from "./business-baggage.js";
 import { SpanKind, context, propagation } from "@opentelemetry/api";

package/dist/workflow.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
 const require_values = require('./values-DApyq53y.cjs');
+const require_functional = require('./functional-DHlD7V0x.cjs');
 const require_trace_helpers = require('./trace-helpers.cjs');
-const require_functional = require('./functional-BhhP4Er_.cjs');
 const require_correlated_events = require('./correlated-events-CcuknWnU.cjs');
 const require_trace_factory_validation = require('./trace-factory-validation-Dc8epn87.cjs');
 let node_async_hooks = require("node:async_hooks");

package/dist/workflow.js

@@ -1,6 +1,6 @@
 import { b as toAttributeValue, g as nonEmptyString, h as isFunction, l as asString, s as asRecord, x as toError } from "./values-BenyvWKz.js";
+import { c as withTracing } from "./functional-C4js2vTM.js";
 import { getActiveSpan } from "./trace-helpers.js";
-import { c as withTracing } from "./functional-Cub1ku-C.js";
 import { t as emitCorrelatedEvent } from "./correlated-events-DwMMbItg.js";
 import { t as assertTraceFactory } from "./trace-factory-validation-BjVAinz6.js";
 import * as nodeAsyncHooks from "node:async_hooks";

package/dist/yaml-config.cjs

@@ -1,250 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.cjs');
-const require_values = require('./values-DApyq53y.cjs');
-const require_sampling = require('./sampling.cjs');
-const require_node_require = require('./node-require-EifOMikz.cjs');
-let node_fs = require("node:fs");
-node_fs = require_rolldown_runtime.__toESM(node_fs, 1);
-let node_path = require("node:path");
-node_path = require_rolldown_runtime.__toESM(node_path, 1);
+const require_init = require('./init-DmM7dprX.cjs');
 
-//#region src/yaml-config.ts
-/**
-* YAML configuration loader for autotel
-*
-* Supports:
-* - Auto-discovery of autotel.yaml in cwd
-* - AUTOTEL_CONFIG_FILE env var override
-* - Environment variable substitution: ${env:VAR} and ${env:VAR:-default}
-*
-* @example Auto-discovery
-* ```yaml
-* # autotel.yaml in project root
-* service:
-*   name: my-service
-* exporter:
-*   endpoint: ${env:OTEL_EXPORTER_OTLP_ENDPOINT:-http://localhost:4318}
-* ```
-*
-* @example Explicit path
-* ```bash
-* AUTOTEL_CONFIG_FILE=./config/otel.yaml tsx --import autotel/auto src/index.ts
-* ```
-*/
-/**
-* Lazy-load yaml parser (optional peer dependency)
-* Only loads when a YAML config file is actually found
-*/
-function loadYamlParser() {
-	try {
-		return require_node_require.requireModule("yaml").parse;
-	} catch {
-		throw new Error("YAML parser not found. Install with: pnpm add yaml");
-	}
-}
-/**
-* Environment variable substitution regex
-* Matches ${env:VAR_NAME} and ${env:VAR_NAME:-default}
-*/
-const ENV_VAR_PATTERN = /\$\{env:([A-Za-z_][A-Za-z0-9_]*)(?::-([^}]*))?\}/g;
-/**
-* Substitute ${env:VAR} and ${env:VAR:-default} in a string
-*
-* @param value - String potentially containing env var references
-* @returns String with env vars substituted
-*
-* @example
-* substituteEnvVars('${env:NODE_ENV:-development}')
-* // Returns 'production' if NODE_ENV=production, else 'development'
-*/
-function substituteEnvVars(value) {
-	return value.replaceAll(ENV_VAR_PATTERN, (_match, varName, defaultValue) => {
-		const envValue = process.env[varName];
-		if (envValue !== void 0) return envValue;
-		if (defaultValue !== void 0) return defaultValue;
-		console.warn(`[autotel] Environment variable ${varName} not set and no default provided`);
-		return "";
-	});
-}
-/**
-* Recursively substitute env vars in an object
-*
-* @param obj - Object to process
-* @returns Object with all string values having env vars substituted
-*/
-function substituteEnvVarsDeep(value) {
-	if (Array.isArray(value)) return value.map(substituteEnvVarsDeep);
-	const mapping = asYamlMapping(value);
-	if (mapping) {
-		const result = {};
-		for (const [key, entry] of Object.entries(mapping)) result[key] = substituteEnvVarsDeep(entry);
-		return result;
-	}
-	const text = require_values.asString(value);
-	return text === void 0 ? value : substituteEnvVars(text);
-}
-/** The mapping a YAML value is, when it is one. */
-function asYamlMapping(value) {
-	return require_values.asRecord(value) === void 0 ? void 0 : value;
-}
-/**
-* A YAML document read into the config shape, with `${env:...}` placeholders
-* resolved.
-*
-* This is the boundary: the file is text until here. Every field of
-* YamlConfig is optional, so any document satisfies it, and
-* `yamlToAutotelConfig` picks out only the fields it understands.
-*/
-function parseYamlConfig(content) {
-	return asYamlMapping(substituteEnvVarsDeep(loadYamlParser()(content))) ?? {};
-}
-/**
-* Find YAML config file path
-*
-* Priority:
-* 1. AUTOTEL_CONFIG_FILE env var (explicit path)
-* 2. autotel.yaml in cwd (convention)
-* 3. autotel.yml in cwd (alternative extension)
-*
-* @returns File path if found, null otherwise
-*/
-function findConfigFile() {
-	const envPath = process.env.AUTOTEL_CONFIG_FILE;
-	if (envPath) {
-		const resolved = node_path.default.resolve(envPath);
-		if (node_fs.existsSync(resolved)) return resolved;
-		console.warn(`[autotel] Config file not found: ${envPath}`);
-		return null;
-	}
-	const conventionPath = node_path.default.resolve(process.cwd(), "autotel.yaml");
-	if (node_fs.existsSync(conventionPath)) return conventionPath;
-	const altPath = node_path.default.resolve(process.cwd(), "autotel.yml");
-	if (node_fs.existsSync(altPath)) return altPath;
-	return null;
-}
-/**
-* Convert YAML config structure to AutotelConfig
-*
-* @param yaml - Parsed and env-substituted YAML config
-* @returns Partial AutotelConfig ready for merging
-*/
-function yamlToAutotelConfig(yaml) {
-	const config = {};
-	if (yaml.service?.name) config.service = yaml.service.name;
-	if (yaml.service?.version) config.version = yaml.service.version;
-	if (yaml.service?.environment) config.environment = yaml.service.environment;
-	if (yaml.exporter?.endpoint) config.endpoint = yaml.exporter.endpoint;
-	if (yaml.exporter?.protocol) config.protocol = yaml.exporter.protocol;
-	if (yaml.exporter?.headers) config.headers = yaml.exporter.headers;
-	if (yaml.exporter?.destinations) config.destinations = yaml.exporter.destinations;
-	if (yaml.resource) config.resourceAttributes = yaml.resource;
-	if (yaml.autoInstrumentations) config.autoInstrumentations = yaml.autoInstrumentations;
-	if (yaml.policies) config.policies = yaml.policies;
-	if (yaml.debug !== void 0) config.debug = yaml.debug;
-	if (yaml.sampling?.preset) {
-		warnOnIgnoredPresetOverrides(yaml.sampling);
-		config.sampling = yaml.sampling.preset;
-	} else {
-		const sampler = createSamplerFromYaml(yaml.sampling);
-		if (sampler) config.sampler = sampler;
-	}
-	return config;
-}
-function createSamplerFromYaml(sampling) {
-	if (!sampling) return void 0;
-	if (sampling.preset) return void 0;
-	const type = sampling.type ?? "adaptive";
-	try {
-		switch (type) {
-			case "adaptive": return new require_sampling.AdaptiveSampler({
-				baselineSampleRate: sampling.baseline_rate,
-				alwaysSampleErrors: sampling.always_sample_errors,
-				alwaysSampleSlow: sampling.always_sample_slow,
-				slowThresholdMs: sampling.slow_threshold_ms
-			});
-			case "always_on": return new require_sampling.AlwaysSampler();
-			case "always_off": return new require_sampling.NeverSampler();
-			case "ratio":
-				if (sampling.ratio === void 0) {
-					console.warn("[autotel] sampling.ratio missing in YAML sampling config. Falling back to adaptive sampler.");
-					return new require_sampling.AdaptiveSampler();
-				}
-				return new require_sampling.RandomSampler(sampling.ratio);
-			default:
-				console.warn(`[autotel] Unknown sampling type "${type}" in YAML config. Falling back to defaults.`);
-				return;
-		}
-	} catch (error) {
-		console.warn(`[autotel] Failed to configure sampling from YAML: ${error instanceof Error ? error.message : String(error)}`);
-		return;
-	}
-}
-function warnOnIgnoredPresetOverrides(sampling) {
-	const ignoredFields = [
-		"type",
-		"ratio",
-		"baseline_rate",
-		"always_sample_errors",
-		"always_sample_slow",
-		"slow_threshold_ms"
-	].filter((field) => sampling[field] !== void 0);
-	if (ignoredFields.length === 0) return;
-	console.warn(`[autotel] sampling.preset="${sampling.preset}" ignores these YAML fields: ${ignoredFields.join(", ")}. Use the programmatic API with sampler or samplingPresets.*(...) for tuned presets.`);
-}
-/**
-* Load and parse YAML config file (auto-discovery)
-*
-* Automatically finds and loads autotel.yaml or uses AUTOTEL_CONFIG_FILE.
-* Returns null if no config file found (not an error - YAML config is optional).
-*
-* @returns Partial AutotelConfig or null if no config file found
-*
-* @example
-* const yamlConfig = loadYamlConfig();
-* if (yamlConfig) {
-*   init({ ...yamlConfig, debug: true });
-* }
-*/
-function loadYamlConfig() {
-	const filePath = findConfigFile();
-	if (!filePath) return null;
-	try {
-		return yamlToAutotelConfig(parseYamlConfig(node_fs.readFileSync(filePath, "utf8")));
-	} catch (error) {
-		console.error(`[autotel] Failed to load YAML config from ${filePath}:`, error);
-		return null;
-	}
-}
-/**
-* Load YAML config from a specific file path
-*
-* Unlike loadYamlConfig(), this throws if the file cannot be read.
-*
-* @param filePath - Path to YAML config file
-* @returns Partial AutotelConfig
-* @throws Error if file cannot be read or parsed
-*
-* @example
-* import { loadYamlConfigFromFile } from 'autotel/yaml';
-* import { init } from 'autotel';
-*
-* const config = loadYamlConfigFromFile('./config/otel.yaml');
-* init({ ...config, debug: true });
-*/
-function loadYamlConfigFromFile(filePath) {
-	const resolved = node_path.default.resolve(filePath);
-	return yamlToAutotelConfig(parseYamlConfig(node_fs.readFileSync(resolved, "utf8")));
-}
-/**
-* Check if a YAML config file exists (without loading it)
-*
-* @returns true if a config file would be found by loadYamlConfig()
-*/
-function hasYamlConfig() {
-	return findConfigFile() !== null;
-}
-
-//#endregion
-exports.hasYamlConfig = hasYamlConfig;
-exports.loadYamlConfig = loadYamlConfig;
-exports.loadYamlConfigFromFile = loadYamlConfigFromFile;
+exports.hasYamlConfig = require_init.hasYamlConfig;
+exports.loadYamlConfig = require_init.loadYamlConfig;
+exports.loadYamlConfigFromFile = require_init.loadYamlConfigFromFile;

package/dist/yaml-config.d.cts

@@ -1,5 +1,5 @@
-import { h as SamplingPreset } from "./sampling-CmRdnXUi.cjs";
-import { a as AutotelConfig, o as OtlpSignal } from "./init-DrlL1eis.cjs";
+import { g as SamplingPreset } from "./sampling-Er217Mge.cjs";
+import { a as AutotelConfig, o as OtlpSignal } from "./init-8GSy2bza.cjs";
 //#region src/yaml-config.d.ts
 /** A value as a YAML document carries it: scalars, sequences, mappings. */
 type YamlValue = string | number | boolean | null | YamlValue[] | YamlMapping;

package/dist/yaml-config.d.ts

@@ -1,5 +1,5 @@
-import { h as SamplingPreset } from "./sampling-CM5S2Lp3.js";
-import { a as AutotelConfig, o as OtlpSignal } from "./init-BgnYi2sm.js";
+import { g as SamplingPreset } from "./sampling-DBng4Foa.js";
+import { a as AutotelConfig, o as OtlpSignal } from "./init-UnKrXhpq.js";
 //#region src/yaml-config.d.ts
 /** A value as a YAML document carries it: scalars, sequences, mappings. */
 type YamlValue = string | number | boolean | null | YamlValue[] | YamlMapping;