autotel-schema 0.1.0

package/dist/processor-D93TAXvZ.cjs

@@ -0,0 +1,366 @@
+
+//#region src/contract.ts
+const ATTRIBUTE_TYPES = [
+	"string",
+	"number",
+	"boolean",
+	"string[]",
+	"number[]",
+	"boolean[]"
+];
+const STABILITIES = [
+	"stable",
+	"experimental",
+	"deprecated"
+];
+const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[\w.]+)?$/;
+function assert(condition, message) {
+	if (!condition) throw new Error(`autotel-schema: ${message}`);
+}
+function validateAttribute(scope, key, spec) {
+	assert(ATTRIBUTE_TYPES.includes(spec.type), `${scope} attribute "${key}" has invalid type "${spec.type}"`);
+	if (spec.stability) assert(STABILITIES.includes(spec.stability), `${scope} attribute "${key}" has invalid stability "${spec.stability}"`);
+	if (spec.stability === "deprecated") assert(spec.replacedBy !== void 0 || spec.deprecatedReason !== void 0, `${scope} attribute "${key}" is deprecated but has no replacedBy or deprecatedReason`);
+	if (spec.enum) assert(spec.enum.length > 0, `${scope} attribute "${key}" declares an empty enum`);
+}
+/**
+* Validate and freeze a telemetry contract. Throws on structural mistakes
+* (bad semver, unknown attribute type, deprecation with no replacement) so the
+* contract fails loudly at module load, not silently at runtime.
+*
+* @example
+* ```ts
+* export const contract = defineContract({
+*   service: 'checkout',
+*   version: '1.2.0',
+*   commonAttributes: {
+*     'user.id': { type: 'string', highCardinality: true, description: 'Authenticated user' },
+*   },
+*   spans: {
+*     'checkout.charge': {
+*       description: 'Charge a payment method',
+*       attributes: {
+*         'payment.provider': { type: 'string', required: true, enum: ['stripe', 'paypal'] },
+*         'payment.amount_cents': { type: 'number', required: true },
+*       },
+*     },
+*   },
+* });
+* ```
+*/
+function defineContract(contract) {
+	assert(typeof contract.service === "string" && contract.service.length > 0, "contract.service must be a non-empty string");
+	assert(SEMVER_RE.test(contract.version), `contract.version "${contract.version}" is not valid semver (e.g. "1.2.0")`);
+	assert(contract.spans && typeof contract.spans === "object", "contract.spans must be an object");
+	for (const [spanName, spanSpec] of Object.entries(contract.spans)) {
+		if (spanSpec.stability) assert(STABILITIES.includes(spanSpec.stability), `span "${spanName}" has invalid stability "${spanSpec.stability}"`);
+		for (const [key, spec] of Object.entries(spanSpec.attributes ?? {})) validateAttribute(`span "${spanName}"`, key, spec);
+	}
+	for (const [key, spec] of Object.entries(contract.commonAttributes ?? {})) validateAttribute("common", key, spec);
+	return Object.freeze(contract);
+}
+/**
+* Resolve the effective attribute spec for `key` on `spanName`: span-specific
+* attributes win over common attributes. Returns `undefined` when the key is
+* declared nowhere.
+*/
+function resolveAttributeSpec(contract, spanName, key) {
+	return contract.spans[spanName]?.attributes?.[key] ?? contract.commonAttributes?.[key];
+}
+/** Whether attributes outside the declared set are tolerated for a span. */
+function allowsAdditionalAttributes(contract, spanName) {
+	return contract.spans[spanName]?.additionalAttributes ?? contract.additionalAttributes ?? false;
+}
+
+//#endregion
+//#region src/validate.ts
+/**
+* Pure span-vs-contract validation. No SDK, no side effects — the same engine
+* the runtime processor ({@link ./processor}) and any test harness can call.
+*/
+/** `'empty[]'` is a distinct marker: an empty array satisfies any array type. */
+function actualType(value) {
+	if (typeof value === "string") return "string";
+	if (typeof value === "number") return "number";
+	if (typeof value === "boolean") return "boolean";
+	if (Array.isArray(value)) {
+		const first = value.find((v) => v !== null && v !== void 0);
+		if (first === void 0) return "empty[]";
+		if (typeof first === "string") return "string[]";
+		if (typeof first === "number") return "number[]";
+		if (typeof first === "boolean") return "boolean[]";
+	}
+	return "unknown";
+}
+function typeMatches(expected, value) {
+	const actual = actualType(value);
+	if (actual === "unknown") return false;
+	if (actual === "empty[]") return expected.endsWith("[]");
+	return actual === expected;
+}
+/** Levenshtein distance — small, allocation-light, good enough for key typos. */
+function editDistance(a, b) {
+	const m = a.length;
+	const n = b.length;
+	if (m === 0) return n;
+	if (n === 0) return m;
+	let prev = Array.from({ length: n + 1 }, (_, i) => i);
+	let curr = Array.from({ length: n + 1 });
+	for (let i = 1; i <= m; i++) {
+		curr[0] = i;
+		for (let j = 1; j <= n; j++) {
+			const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+			curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+		}
+		[prev, curr] = [curr, prev];
+	}
+	return prev[n];
+}
+/**
+* Closest declared key to `key`, when one is within a small edit distance.
+* Turns "you emitted an attribute I don't know" into "did you mean `user.id`?".
+*/
+function nearestKey(key, candidates) {
+	let best;
+	let bestDistance = Infinity;
+	const threshold = Math.max(1, Math.floor(key.length / 4) + 1);
+	for (const candidate of candidates) {
+		const d = editDistance(key, candidate);
+		if (d < bestDistance && d <= threshold) {
+			best = candidate;
+			bestDistance = d;
+		}
+	}
+	return best;
+}
+function declaredKeysFor(contract, spanName) {
+	return [...Object.keys(contract.spans[spanName]?.attributes ?? {}), ...Object.keys(contract.commonAttributes ?? {})];
+}
+function checkValue(spanName, key, value, spec, out) {
+	if (!typeMatches(spec.type, value)) {
+		out.push({
+			code: "type_mismatch",
+			severity: "error",
+			spanName,
+			attribute: key,
+			message: `attribute "${key}" should be ${spec.type} but got ${actualType(value)}`
+		});
+		return;
+	}
+	if (spec.enum && (typeof value === "string" || typeof value === "number") && !spec.enum.includes(value)) out.push({
+		code: "enum_violation",
+		severity: "error",
+		spanName,
+		attribute: key,
+		message: `attribute "${key}" value ${JSON.stringify(value)} is not one of ${JSON.stringify(spec.enum)}`
+	});
+	if (spec.stability === "deprecated") {
+		const hint = spec.replacedBy ? ` — use "${spec.replacedBy}" instead` : spec.deprecatedReason ? ` — ${spec.deprecatedReason}` : "";
+		out.push({
+			code: "deprecated_attribute",
+			severity: "warning",
+			spanName,
+			attribute: key,
+			message: `attribute "${key}" is deprecated${hint}`,
+			suggestion: spec.replacedBy
+		});
+	}
+}
+/**
+* Validate one emitted span against the contract, returning every discrepancy.
+* Order is deterministic: required-but-missing first, then per-attribute checks
+* in attribute insertion order.
+*/
+function validateSpan(span, contract, options = {}) {
+	const out = [];
+	const spanSpec = contract.spans[span.name];
+	if (!spanSpec) {
+		if (options.strictSpanNames) out.push({
+			code: "unknown_span",
+			severity: "warning",
+			spanName: span.name,
+			message: `span "${span.name}" is not declared in the contract`
+		});
+		return out;
+	}
+	const required = [...Object.entries(spanSpec.attributes ?? {}), ...Object.entries(contract.commonAttributes ?? {})].filter(([, spec]) => spec.required);
+	for (const [key] of required) if (!(key in span.attributes)) out.push({
+		code: "missing_required",
+		severity: "error",
+		spanName: span.name,
+		attribute: key,
+		message: `required attribute "${key}" is missing`
+	});
+	const allowExtra = allowsAdditionalAttributes(contract, span.name);
+	const declared = allowExtra ? [] : declaredKeysFor(contract, span.name);
+	for (const [key, value] of Object.entries(span.attributes)) {
+		if (value === null || value === void 0) continue;
+		const spec = resolveAttributeSpec(contract, span.name, key);
+		if (!spec) {
+			if (!allowExtra) out.push({
+				code: "unknown_attribute",
+				severity: "warning",
+				spanName: span.name,
+				attribute: key,
+				message: `attribute "${key}" is not declared on span "${span.name}"`,
+				suggestion: nearestKey(key, declared)
+			});
+			continue;
+		}
+		checkValue(span.name, key, value, spec, out);
+	}
+	return out;
+}
+/** `true` when any violation is `error` severity. */
+function hasErrors(violations) {
+	return violations.some((v) => v.severity === "error");
+}
+/** One-line human/agent-readable rendering of a violation. */
+function formatViolation(v) {
+	const where = v.attribute ? `${v.spanName}.${v.attribute}` : v.spanName;
+	const suffix = v.suggestion ? ` (did you mean "${v.suggestion}"?)` : "";
+	return `[${v.severity}] ${v.code} @ ${where}: ${v.message}${suffix}`;
+}
+
+//#endregion
+//#region src/processor.ts
+/**
+* Runtime contract enforcement as an OpenTelemetry SpanProcessor.
+*
+* Wire it into `init({ spanProcessors: [...] })` and every span your service
+* emits is validated against the contract as it ends. In development a typo'd
+* or undeclared attribute surfaces immediately instead of silently drifting
+* the public telemetry API out from under the agents reading it.
+*
+* Fail-open by construction: a bug in validation must never break the app or
+* lose a span. Off in production by default (validation belongs in CI and dev),
+* but `enabledInProduction` is there if you want a sampled canary in prod.
+*/
+const DEFAULT_WARN_INTERVAL_MS = 6e4;
+function isProduction() {
+	return process.env.NODE_ENV === "production";
+}
+/**
+* Validates each ending span against a {@link TelemetryContract}. Bounded,
+* deduplicated warnings; fail-open on any internal error.
+*/
+var SchemaValidationSpanProcessor = class {
+	opts;
+	enabled;
+	warnIntervalMs;
+	lastWarnAt = /* @__PURE__ */ new Map();
+	violationCount = 0;
+	constructor(opts) {
+		this.opts = opts;
+		this.enabled = opts.enabledInProduction === true || !isProduction();
+		this.warnIntervalMs = opts.warnIntervalMs ?? DEFAULT_WARN_INTERVAL_MS;
+	}
+	/** Number of violations seen since startup (across all spans). */
+	get totalViolations() {
+		return this.violationCount;
+	}
+	onStart(_span, _parentContext) {}
+	onEnd(span) {
+		if (!this.enabled) return;
+		let violations;
+		try {
+			violations = validateSpan({
+				name: span.name,
+				attributes: span.attributes
+			}, this.opts.contract, { strictSpanNames: this.opts.strictSpanNames });
+		} catch {
+			return;
+		}
+		for (const violation of violations) {
+			this.violationCount++;
+			this.opts.onViolation?.(violation, span);
+			this.handle(violation);
+		}
+	}
+	handle(violation) {
+		const mode = this.opts.mode ?? "warn";
+		if (mode === "silent") return;
+		if (mode === "throw" && violation.severity === "error") throw new Error(`autotel-schema: contract violation (${violation.code}) on span "${violation.spanName}": ${violation.message}`);
+		this.maybeWarn(violation);
+	}
+	maybeWarn(violation) {
+		const key = `${violation.code}:${violation.spanName}:${violation.attribute ?? ""}`;
+		const now = Date.now();
+		if (now - (this.lastWarnAt.get(key) ?? 0) < this.warnIntervalMs) return;
+		this.lastWarnAt.set(key, now);
+		const suffix = violation.suggestion ? ` (did you mean "${violation.suggestion}"?)` : "";
+		const message = `autotel-schema [${violation.severity}] ${violation.code} on "${violation.spanName}"${violation.attribute ? `.${violation.attribute}` : ""}: ${violation.message}${suffix}`;
+		if (this.opts.onWarn) this.opts.onWarn(message);
+		else console.warn(message);
+	}
+	async forceFlush() {}
+	async shutdown() {
+		this.lastWarnAt.clear();
+	}
+};
+function createSchemaValidationProcessor(opts) {
+	return new SchemaValidationSpanProcessor(opts);
+}
+
+//#endregion
+Object.defineProperty(exports, 'ATTRIBUTE_TYPES', {
+  enumerable: true,
+  get: function () {
+    return ATTRIBUTE_TYPES;
+  }
+});
+Object.defineProperty(exports, 'STABILITIES', {
+  enumerable: true,
+  get: function () {
+    return STABILITIES;
+  }
+});
+Object.defineProperty(exports, 'SchemaValidationSpanProcessor', {
+  enumerable: true,
+  get: function () {
+    return SchemaValidationSpanProcessor;
+  }
+});
+Object.defineProperty(exports, 'allowsAdditionalAttributes', {
+  enumerable: true,
+  get: function () {
+    return allowsAdditionalAttributes;
+  }
+});
+Object.defineProperty(exports, 'createSchemaValidationProcessor', {
+  enumerable: true,
+  get: function () {
+    return createSchemaValidationProcessor;
+  }
+});
+Object.defineProperty(exports, 'defineContract', {
+  enumerable: true,
+  get: function () {
+    return defineContract;
+  }
+});
+Object.defineProperty(exports, 'formatViolation', {
+  enumerable: true,
+  get: function () {
+    return formatViolation;
+  }
+});
+Object.defineProperty(exports, 'hasErrors', {
+  enumerable: true,
+  get: function () {
+    return hasErrors;
+  }
+});
+Object.defineProperty(exports, 'resolveAttributeSpec', {
+  enumerable: true,
+  get: function () {
+    return resolveAttributeSpec;
+  }
+});
+Object.defineProperty(exports, 'validateSpan', {
+  enumerable: true,
+  get: function () {
+    return validateSpan;
+  }
+});
+//# sourceMappingURL=processor-D93TAXvZ.cjs.map

package/dist/processor-D93TAXvZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor-D93TAXvZ.cjs","names":[],"sources":["../src/contract.ts","../src/validate.ts","../src/processor.ts"],"sourcesContent":["/**\n * Telemetry contract model.\n *\n * The premise: when the primary reader of your telemetry is an agent, your\n * span names and attribute keys are a **public API**. Renaming `fast_path_hit`\n * to `fast_path_taken` in a refactor PR silently breaks every prompt that\n * mentions it — there is no compiler to catch it, because to the compiler these\n * are just strings in a JSON blob.\n *\n * `defineContract()` makes that surface explicit, typed, and versionable: you\n * declare which spans your service emits and which attributes live on them,\n * then validate live spans against it ({@link ./validate}) and diff it across\n * commits to catch breaking changes before they ship ({@link ./diff}).\n *\n * This module is dependency-free and side-effect-free by design — safe to\n * import anywhere (browser, edge, CLI) without pulling in the OpenTelemetry SDK.\n */\n\n/** Scalar and array attribute types permitted on a span (OTLP value shapes). */\nexport type AttributeType =\n  | 'string'\n  | 'number'\n  | 'boolean'\n  | 'string[]'\n  | 'number[]'\n  | 'boolean[]';\n\nexport const ATTRIBUTE_TYPES: readonly AttributeType[] = [\n  'string',\n  'number',\n  'boolean',\n  'string[]',\n  'number[]',\n  'boolean[]',\n];\n\n/**\n * Lifecycle of a span or attribute, mirroring how the OpenTelemetry semantic\n * conventions stage their own surface. `stable` is a promise to agent readers\n * that the name will not change without a major contract bump.\n */\nexport type Stability = 'stable' | 'experimental' | 'deprecated';\n\nexport const STABILITIES: readonly Stability[] = [\n  'stable',\n  'experimental',\n  'deprecated',\n];\n\n/** Declaration for a single attribute key on a span. */\nexport interface AttributeSpec {\n  /** OTLP value shape. Validated at runtime against the emitted value. */\n  type: AttributeType;\n  /** Lifecycle stage. Defaults to `stable`. */\n  stability?: Stability;\n  /** When `true`, the attribute must be present on every matching span. */\n  required?: boolean;\n  /** Human/agent-facing description of what the attribute means. */\n  description?: string;\n  /**\n   * Marks an attribute as intentionally high-cardinality (user id, sender\n   * domain, request id). For an agent reader these are the single most useful\n   * fields on a trace, so {@link ./redaction.highCardinalityKeys} surfaces them\n   * as a *protect* list — telling redactors/normalizers NOT to strip them.\n   */\n  highCardinality?: boolean;\n  /** Closed set of permitted values. Reported as `enum_violation` if exceeded. */\n  enum?: readonly (string | number)[];\n  /** Set when `stability: 'deprecated'`; explains what to use instead. */\n  replacedBy?: string;\n  /** Free-text note shown alongside deprecation warnings. */\n  deprecatedReason?: string;\n}\n\n/** Declaration for a single span name your service emits. */\nexport interface SpanSpec {\n  /** Human/agent-facing description of when this span is produced. */\n  description?: string;\n  /** Lifecycle stage. Defaults to `stable`. */\n  stability?: Stability;\n  /** Attributes specific to this span, keyed by attribute name. */\n  attributes?: Record<string, AttributeSpec>;\n  /**\n   * When `true`, attributes not declared here are allowed without an\n   * `unknown_attribute` violation. Defaults to the contract-level setting.\n   */\n  additionalAttributes?: boolean;\n}\n\n/** The full telemetry contract for one service. */\nexport interface TelemetryContract {\n  /** `service.name` this contract describes. */\n  service: string;\n  /**\n   * Semver of the *contract itself* (not the app). Bumped when the trace\n   * surface changes; surfaced to readers as the `telemetry.schema.version`\n   * resource attribute via {@link ./attrs.SCHEMA_ATTRS}.\n   */\n  version: string;\n  /** Spans this service emits, keyed by span name. */\n  spans: Record<string, SpanSpec>;\n  /** Attributes permitted on *any* span (e.g. `user.id`, `tenant.id`). */\n  commonAttributes?: Record<string, AttributeSpec>;\n  /**\n   * Default for `SpanSpec.additionalAttributes` when a span does not set it.\n   * Defaults to `false` (declared-only — the stricter, agent-friendlier mode).\n   */\n  additionalAttributes?: boolean;\n}\n\nconst SEMVER_RE = /^\\d+\\.\\d+\\.\\d+(?:-[\\w.]+)?$/;\n\nfunction assert(condition: unknown, message: string): asserts condition {\n  if (!condition) {\n    throw new Error(`autotel-schema: ${message}`);\n  }\n}\n\nfunction validateAttribute(\n  scope: string,\n  key: string,\n  spec: AttributeSpec,\n): void {\n  assert(\n    ATTRIBUTE_TYPES.includes(spec.type),\n    `${scope} attribute \"${key}\" has invalid type \"${spec.type}\"`,\n  );\n  if (spec.stability) {\n    assert(\n      STABILITIES.includes(spec.stability),\n      `${scope} attribute \"${key}\" has invalid stability \"${spec.stability}\"`,\n    );\n  }\n  if (spec.stability === 'deprecated') {\n    assert(\n      spec.replacedBy !== undefined || spec.deprecatedReason !== undefined,\n      `${scope} attribute \"${key}\" is deprecated but has no replacedBy or deprecatedReason`,\n    );\n  }\n  if (spec.enum) {\n    assert(\n      spec.enum.length > 0,\n      `${scope} attribute \"${key}\" declares an empty enum`,\n    );\n  }\n}\n\n/**\n * Validate and freeze a telemetry contract. Throws on structural mistakes\n * (bad semver, unknown attribute type, deprecation with no replacement) so the\n * contract fails loudly at module load, not silently at runtime.\n *\n * @example\n * ```ts\n * export const contract = defineContract({\n *   service: 'checkout',\n *   version: '1.2.0',\n *   commonAttributes: {\n *     'user.id': { type: 'string', highCardinality: true, description: 'Authenticated user' },\n *   },\n *   spans: {\n *     'checkout.charge': {\n *       description: 'Charge a payment method',\n *       attributes: {\n *         'payment.provider': { type: 'string', required: true, enum: ['stripe', 'paypal'] },\n *         'payment.amount_cents': { type: 'number', required: true },\n *       },\n *     },\n *   },\n * });\n * ```\n */\nexport function defineContract(contract: TelemetryContract): TelemetryContract {\n  assert(\n    typeof contract.service === 'string' && contract.service.length > 0,\n    'contract.service must be a non-empty string',\n  );\n  assert(\n    SEMVER_RE.test(contract.version),\n    `contract.version \"${contract.version}\" is not valid semver (e.g. \"1.2.0\")`,\n  );\n  assert(\n    contract.spans && typeof contract.spans === 'object',\n    'contract.spans must be an object',\n  );\n\n  for (const [spanName, spanSpec] of Object.entries(contract.spans)) {\n    if (spanSpec.stability) {\n      assert(\n        STABILITIES.includes(spanSpec.stability),\n        `span \"${spanName}\" has invalid stability \"${spanSpec.stability}\"`,\n      );\n    }\n    for (const [key, spec] of Object.entries(spanSpec.attributes ?? {})) {\n      validateAttribute(`span \"${spanName}\"`, key, spec);\n    }\n  }\n  for (const [key, spec] of Object.entries(contract.commonAttributes ?? {})) {\n    validateAttribute('common', key, spec);\n  }\n\n  return Object.freeze(contract);\n}\n\n/**\n * Resolve the effective attribute spec for `key` on `spanName`: span-specific\n * attributes win over common attributes. Returns `undefined` when the key is\n * declared nowhere.\n */\nexport function resolveAttributeSpec(\n  contract: TelemetryContract,\n  spanName: string,\n  key: string,\n): AttributeSpec | undefined {\n  return (\n    contract.spans[spanName]?.attributes?.[key] ??\n    contract.commonAttributes?.[key]\n  );\n}\n\n/** Whether attributes outside the declared set are tolerated for a span. */\nexport function allowsAdditionalAttributes(\n  contract: TelemetryContract,\n  spanName: string,\n): boolean {\n  return (\n    contract.spans[spanName]?.additionalAttributes ??\n    contract.additionalAttributes ??\n    false\n  );\n}\n","/**\n * Pure span-vs-contract validation. No SDK, no side effects — the same engine\n * the runtime processor ({@link ./processor}) and any test harness can call.\n */\n\nimport {\n  allowsAdditionalAttributes,\n  resolveAttributeSpec,\n  type AttributeSpec,\n  type AttributeType,\n  type TelemetryContract,\n} from './contract.js';\n\n/** Severity of a contract violation. `error` = a breaking-shaped problem. */\nexport type ViolationSeverity = 'error' | 'warning';\n\nexport type ViolationCode =\n  | 'unknown_span'\n  | 'unknown_attribute'\n  | 'type_mismatch'\n  | 'missing_required'\n  | 'deprecated_attribute'\n  | 'enum_violation';\n\n/** A single discrepancy between an emitted span and the contract. */\nexport interface SchemaViolation {\n  code: ViolationCode;\n  severity: ViolationSeverity;\n  spanName: string;\n  /** Attribute key involved, when the violation is attribute-scoped. */\n  attribute?: string;\n  message: string;\n  /** Nearest declared key, for likely typos (`unknown_attribute` only). */\n  suggestion?: string;\n}\n\n/** Minimal emitted-span shape — avoids a hard dependency on the OTel SDK. */\nexport interface SpanShape {\n  name: string;\n  attributes: Record<string, unknown>;\n}\n\nexport interface ValidateOptions {\n  /** Report `unknown_span` for span names not in the contract. Default `false`. */\n  strictSpanNames?: boolean;\n}\n\n/** `'empty[]'` is a distinct marker: an empty array satisfies any array type. */\nfunction actualType(value: unknown): AttributeType | 'empty[]' | 'unknown' {\n  if (typeof value === 'string') return 'string';\n  if (typeof value === 'number') return 'number';\n  if (typeof value === 'boolean') return 'boolean';\n  if (Array.isArray(value)) {\n    const first = value.find((v) => v !== null && v !== undefined);\n    if (first === undefined) return 'empty[]';\n    if (typeof first === 'string') return 'string[]';\n    if (typeof first === 'number') return 'number[]';\n    if (typeof first === 'boolean') return 'boolean[]';\n  }\n  return 'unknown';\n}\n\nfunction typeMatches(expected: AttributeType, value: unknown): boolean {\n  const actual = actualType(value);\n  if (actual === 'unknown') return false;\n  if (actual === 'empty[]') return expected.endsWith('[]');\n  return actual === expected;\n}\n\n/** Levenshtein distance — small, allocation-light, good enough for key typos. */\nfunction editDistance(a: string, b: string): number {\n  const m = a.length;\n  const n = b.length;\n  if (m === 0) return n;\n  if (n === 0) return m;\n  let prev = Array.from({ length: n + 1 }, (_, i) => i);\n  let curr = Array.from<number>({ length: n + 1 });\n  for (let i = 1; i <= m; i++) {\n    curr[0] = i;\n    for (let j = 1; j <= n; j++) {\n      const cost = a[i - 1] === b[j - 1] ? 0 : 1;\n      curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);\n    }\n    [prev, curr] = [curr, prev];\n  }\n  return prev[n];\n}\n\n/**\n * Closest declared key to `key`, when one is within a small edit distance.\n * Turns \"you emitted an attribute I don't know\" into \"did you mean `user.id`?\".\n */\nfunction nearestKey(key: string, candidates: string[]): string | undefined {\n  let best: string | undefined;\n  let bestDistance = Infinity;\n  const threshold = Math.max(1, Math.floor(key.length / 4) + 1);\n  for (const candidate of candidates) {\n    const d = editDistance(key, candidate);\n    if (d < bestDistance && d <= threshold) {\n      best = candidate;\n      bestDistance = d;\n    }\n  }\n  return best;\n}\n\nfunction declaredKeysFor(\n  contract: TelemetryContract,\n  spanName: string,\n): string[] {\n  return [\n    ...Object.keys(contract.spans[spanName]?.attributes ?? {}),\n    ...Object.keys(contract.commonAttributes ?? {}),\n  ];\n}\n\nfunction checkValue(\n  spanName: string,\n  key: string,\n  value: unknown,\n  spec: AttributeSpec,\n  out: SchemaViolation[],\n): void {\n  if (!typeMatches(spec.type, value)) {\n    out.push({\n      code: 'type_mismatch',\n      severity: 'error',\n      spanName,\n      attribute: key,\n      message: `attribute \"${key}\" should be ${spec.type} but got ${actualType(value)}`,\n    });\n    return; // a wrong type makes enum/deprecation checks noise\n  }\n  if (spec.enum && (typeof value === 'string' || typeof value === 'number') && !spec.enum.includes(value)) {\n      out.push({\n        code: 'enum_violation',\n        severity: 'error',\n        spanName,\n        attribute: key,\n        message: `attribute \"${key}\" value ${JSON.stringify(value)} is not one of ${JSON.stringify(spec.enum)}`,\n      });\n    }\n  if (spec.stability === 'deprecated') {\n    const hint = spec.replacedBy\n      ? ` — use \"${spec.replacedBy}\" instead`\n      : spec.deprecatedReason\n        ? ` — ${spec.deprecatedReason}`\n        : '';\n    out.push({\n      code: 'deprecated_attribute',\n      severity: 'warning',\n      spanName,\n      attribute: key,\n      message: `attribute \"${key}\" is deprecated${hint}`,\n      suggestion: spec.replacedBy,\n    });\n  }\n}\n\n/**\n * Validate one emitted span against the contract, returning every discrepancy.\n * Order is deterministic: required-but-missing first, then per-attribute checks\n * in attribute insertion order.\n */\nexport function validateSpan(\n  span: SpanShape,\n  contract: TelemetryContract,\n  options: ValidateOptions = {},\n): SchemaViolation[] {\n  const out: SchemaViolation[] = [];\n  const spanSpec = contract.spans[span.name];\n\n  if (!spanSpec) {\n    if (options.strictSpanNames) {\n      out.push({\n        code: 'unknown_span',\n        severity: 'warning',\n        spanName: span.name,\n        message: `span \"${span.name}\" is not declared in the contract`,\n      });\n    }\n    return out; // unknown span → no attribute contract to check against\n  }\n\n  // Required attributes that never showed up.\n  const required = [\n    ...Object.entries(spanSpec.attributes ?? {}),\n    ...Object.entries(contract.commonAttributes ?? {}),\n  ].filter(([, spec]) => spec.required);\n  for (const [key] of required) {\n    if (!(key in span.attributes)) {\n      out.push({\n        code: 'missing_required',\n        severity: 'error',\n        spanName: span.name,\n        attribute: key,\n        message: `required attribute \"${key}\" is missing`,\n      });\n    }\n  }\n\n  const allowExtra = allowsAdditionalAttributes(contract, span.name);\n  const declared = allowExtra ? [] : declaredKeysFor(contract, span.name);\n\n  for (const [key, value] of Object.entries(span.attributes)) {\n    if (value === null || value === undefined) continue;\n    const spec = resolveAttributeSpec(contract, span.name, key);\n    if (!spec) {\n      if (!allowExtra) {\n        out.push({\n          code: 'unknown_attribute',\n          severity: 'warning',\n          spanName: span.name,\n          attribute: key,\n          message: `attribute \"${key}\" is not declared on span \"${span.name}\"`,\n          suggestion: nearestKey(key, declared),\n        });\n      }\n      continue;\n    }\n    checkValue(span.name, key, value, spec, out);\n  }\n\n  return out;\n}\n\n/** `true` when any violation is `error` severity. */\nexport function hasErrors(violations: SchemaViolation[]): boolean {\n  return violations.some((v) => v.severity === 'error');\n}\n\n/** One-line human/agent-readable rendering of a violation. */\nexport function formatViolation(v: SchemaViolation): string {\n  const where = v.attribute ? `${v.spanName}.${v.attribute}` : v.spanName;\n  const suffix = v.suggestion ? ` (did you mean \"${v.suggestion}\"?)` : '';\n  return `[${v.severity}] ${v.code} @ ${where}: ${v.message}${suffix}`;\n}\n","/**\n * Runtime contract enforcement as an OpenTelemetry SpanProcessor.\n *\n * Wire it into `init({ spanProcessors: [...] })` and every span your service\n * emits is validated against the contract as it ends. In development a typo'd\n * or undeclared attribute surfaces immediately instead of silently drifting\n * the public telemetry API out from under the agents reading it.\n *\n * Fail-open by construction: a bug in validation must never break the app or\n * lose a span. Off in production by default (validation belongs in CI and dev),\n * but `enabledInProduction` is there if you want a sampled canary in prod.\n */\n\nimport { validateSpan, type SchemaViolation, type ValidateOptions } from './validate.js';\nimport type { TelemetryContract } from './contract.js';\n\n/** Minimal ReadableSpan shape — matches OTel without a hard SDK dependency. */\nexport interface ReadableSpanLike {\n  name: string;\n  attributes: Record<string, unknown>;\n}\n\nexport interface SpanLike {\n  spanContext(): { traceId: string; spanId: string };\n}\n\n/** Opaque parent context — matches OTel SpanProcessor without importing it. */\nexport type OtelContext = unknown;\n\nexport interface SpanProcessorLike {\n  onStart(span: SpanLike, parentContext: OtelContext): void;\n  onEnd(span: ReadableSpanLike): void;\n  shutdown(): Promise<void>;\n  forceFlush(): Promise<void>;\n}\n\n/** How the processor reacts to a contract violation. */\nexport type SchemaProcessorMode = 'warn' | 'throw' | 'silent';\n\nexport interface SchemaValidationProcessorOptions extends ValidateOptions {\n  contract: TelemetryContract;\n  /**\n   * `warn` (default): log each distinct violation once per interval.\n   * `throw`: throw on the first error-severity violation — for tests/CI only.\n   * `silent`: collect via `onViolation` without logging.\n   */\n  mode?: SchemaProcessorMode;\n  /** Called for every violation, before mode handling. */\n  onViolation?: (violation: SchemaViolation, span: ReadableSpanLike) => void;\n  /** Override the warn sink (defaults to `console.warn`). */\n  onWarn?: (message: string) => void;\n  /** Run even when `NODE_ENV === 'production'`. Default `false`. */\n  enabledInProduction?: boolean;\n  /** Throttle window for repeated identical warnings (ms). Default 60s. */\n  warnIntervalMs?: number;\n}\n\nconst DEFAULT_WARN_INTERVAL_MS = 60_000;\n\nfunction isProduction(): boolean {\n  return process.env.NODE_ENV === 'production';\n}\n\n/**\n * Validates each ending span against a {@link TelemetryContract}. Bounded,\n * deduplicated warnings; fail-open on any internal error.\n */\nexport class SchemaValidationSpanProcessor implements SpanProcessorLike {\n  private readonly opts: SchemaValidationProcessorOptions;\n  private readonly enabled: boolean;\n  private readonly warnIntervalMs: number;\n  private readonly lastWarnAt = new Map<string, number>();\n  private violationCount = 0;\n\n  constructor(opts: SchemaValidationProcessorOptions) {\n    this.opts = opts;\n    this.enabled = opts.enabledInProduction === true || !isProduction();\n    this.warnIntervalMs = opts.warnIntervalMs ?? DEFAULT_WARN_INTERVAL_MS;\n  }\n\n  /** Number of violations seen since startup (across all spans). */\n  get totalViolations(): number {\n    return this.violationCount;\n  }\n\n  onStart(_span: SpanLike, _parentContext: OtelContext): void {\n    // no-op — validation happens once the span is complete\n  }\n\n  onEnd(span: ReadableSpanLike): void {\n    if (!this.enabled) return;\n    let violations: SchemaViolation[];\n    try {\n      // Validation itself is fail-open: a bug here must never break export.\n      violations = validateSpan(\n        { name: span.name, attributes: span.attributes },\n        this.opts.contract,\n        { strictSpanNames: this.opts.strictSpanNames },\n      );\n    } catch {\n      return;\n    }\n    // Mode handling runs outside the fail-open guard so `throw` mode propagates.\n    for (const violation of violations) {\n      this.violationCount++;\n      this.opts.onViolation?.(violation, span);\n      this.handle(violation);\n    }\n  }\n\n  private handle(violation: SchemaViolation): void {\n    const mode = this.opts.mode ?? 'warn';\n    if (mode === 'silent') return;\n    if (mode === 'throw' && violation.severity === 'error') {\n      throw new Error(\n        `autotel-schema: contract violation (${violation.code}) on span \"${violation.spanName}\": ${violation.message}`,\n      );\n    }\n    this.maybeWarn(violation);\n  }\n\n  private maybeWarn(violation: SchemaViolation): void {\n    const key = `${violation.code}:${violation.spanName}:${violation.attribute ?? ''}`;\n    const now = Date.now();\n    const last = this.lastWarnAt.get(key) ?? 0;\n    if (now - last < this.warnIntervalMs) return;\n    this.lastWarnAt.set(key, now);\n    const suffix = violation.suggestion\n      ? ` (did you mean \"${violation.suggestion}\"?)`\n      : '';\n    const message = `autotel-schema [${violation.severity}] ${violation.code} on \"${violation.spanName}\"${violation.attribute ? `.${violation.attribute}` : ''}: ${violation.message}${suffix}`;\n    if (this.opts.onWarn) {\n      this.opts.onWarn(message);\n    } else {\n      console.warn(message);\n    }\n  }\n\n  async forceFlush(): Promise<void> {\n    // nothing buffered — validation is synchronous in onEnd\n  }\n\n  async shutdown(): Promise<void> {\n    this.lastWarnAt.clear();\n  }\n}\n\nexport function createSchemaValidationProcessor(\n  opts: SchemaValidationProcessorOptions,\n): SchemaValidationSpanProcessor {\n  return new SchemaValidationSpanProcessor(opts);\n}\n"],"mappings":"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"}