@fractaal/pi-telemetry 0.86.9 → 1.6.0

package/dist/metrics.d.ts

@@ -0,0 +1,78 @@
+import type { ExactTelemetryAttributes, InferRequiredAndOptionalAttributes, SpanAttributes, TelemetryContext, TelemetrySchemaDefinition, TelemetryStartAttributeDefinition } from "./index.ts";
+export interface InstrumentOptions {
+    description?: string;
+    unit?: string;
+}
+export interface HistogramOptions extends InstrumentOptions {
+    /** Bucket hints; callers supply finite, strictly increasing values. */
+    boundaries?: readonly number[];
+}
+export interface TelemetryCounter {
+    add(value: number, attributes?: SpanAttributes): void;
+}
+export interface TelemetryUpDownCounter {
+    add(value: number, attributes?: SpanAttributes): void;
+}
+export interface TelemetryHistogram {
+    record(value: number, attributes?: SpanAttributes, context?: TelemetryContext): void;
+}
+/**
+ * Optional adapter capability with synchronous factories and recording methods.
+ * Typed inputs are trusted; callers supply finite measurements and nonnegative counter increments.
+ * Malformed input behavior is unspecified.
+ */
+export interface TelemetryMetrics {
+    counter(name: string, options?: InstrumentOptions): TelemetryCounter;
+    upDownCounter(name: string, options?: InstrumentOptions): TelemetryUpDownCounter;
+    histogram(name: string, options?: HistogramOptions): TelemetryHistogram;
+}
+export type TelemetryMetricAttributeDefinition = TelemetryStartAttributeDefinition & {
+    cardinality?: "low";
+};
+export type TelemetryMetricDefinition = {
+    description: string;
+    unit?: string;
+    attributes: Record<string, TelemetryMetricAttributeDefinition>;
+} & ({
+    kind: "counter" | "upDownCounter";
+    boundaries?: never;
+} | {
+    kind: "histogram";
+    boundaries?: readonly number[];
+});
+type MetricKind = TelemetryMetricDefinition["kind"];
+type MetricSchemas = readonly [TelemetrySchemaDefinition, ...TelemetrySchemaDefinition[]];
+type MetricsOf<Schema extends TelemetrySchemaDefinition> = Schema extends {
+    metrics: infer Metrics extends Record<string, TelemetryMetricDefinition>;
+} ? Metrics : Record<never, never>;
+type MetricNames<Schema extends TelemetrySchemaDefinition, Kind extends MetricKind> = Schema extends TelemetrySchemaDefinition ? {
+    [Name in keyof MetricsOf<Schema>]: MetricsOf<Schema>[Name] extends {
+        kind: Kind;
+    } ? Name : never;
+}[keyof MetricsOf<Schema>] & string : never;
+type MetricByName<Schema extends TelemetrySchemaDefinition, Name extends string> = Schema extends TelemetrySchemaDefinition ? Name extends keyof MetricsOf<Schema> ? MetricsOf<Schema>[Name] : never : never;
+type DuplicateMetricNames<Schemas extends readonly TelemetrySchemaDefinition[], Seen extends string = never> = Schemas extends readonly [
+    infer Schema extends TelemetrySchemaDefinition,
+    ...infer Rest extends readonly TelemetrySchemaDefinition[]
+] ? Extract<keyof MetricsOf<Schema>, Seen> | DuplicateMetricNames<Rest, Seen | (keyof MetricsOf<Schema> & string)> : never;
+type MetricAttributes<Definition extends TelemetryMetricDefinition> = InferRequiredAndOptionalAttributes<Definition["attributes"]>;
+type MeasurementArguments<Definition extends TelemetryMetricDefinition, Attributes extends MetricAttributes<Definition>> = {
+    [Name in keyof Definition["attributes"]]: Definition["attributes"][Name]["required"] extends true ? Name : never;
+}[keyof Definition["attributes"]] extends never ? [attributes?: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>] : [attributes: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>];
+export type SchemaTelemetryCounter<Definition extends TelemetryMetricDefinition> = {
+    add<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(value: number, ...args: MeasurementArguments<Definition, Attributes>): void;
+};
+export type SchemaTelemetryHistogram<Definition extends TelemetryMetricDefinition> = {
+    record<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(value: number, ...args: [...MeasurementArguments<Definition, Attributes>, context?: TelemetryContext]): void;
+};
+export interface TypedTelemetryMetrics<Schemas extends MetricSchemas> {
+    counter<Name extends MetricNames<Schemas[number], "counter">>(name: Name): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;
+    upDownCounter<Name extends MetricNames<Schemas[number], "upDownCounter">>(name: Name): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;
+    histogram<Name extends MetricNames<Schemas[number], "histogram">>(name: Name): SchemaTelemetryHistogram<MetricByName<Schemas[number], Name>>;
+}
+/** Bind instrument names, kinds, metadata, and exact measurement attributes to one or more schemas. */
+export declare function createTypedMetrics<const Schemas extends MetricSchemas>(metrics: TelemetryMetrics, schemas: Schemas & ([DuplicateMetricNames<Schemas>] extends [never] ? unknown : {
+    readonly "duplicate telemetry metric names": DuplicateMetricNames<Schemas>;
+})): TypedTelemetryMetrics<Schemas>;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

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

package/dist/metrics.js

@@ -0,0 +1,14 @@
+/** Bind instrument names, kinds, metadata, and exact measurement attributes to one or more schemas. */
+export function createTypedMetrics(metrics, schemas) {
+    const definitions = new Map();
+    for (const schema of schemas) {
+        for (const [name, definition] of Object.entries(schema.metrics ?? {}))
+            definitions.set(name, definition);
+    }
+    return {
+        counter: (name) => metrics.counter(name, definitions.get(name)),
+        upDownCounter: (name) => metrics.upDownCounter(name, definitions.get(name)),
+        histogram: (name) => metrics.histogram(name, definitions.get(name)),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AA+HA,uGAAuG;AACvG,MAAM,UAAU,kBAAkB,CACjC,OAAyB,EACzB,OAGmF;IAEnF,MAAM,WAAW,GAAG,IAAI,GAAG,EAAqC,CAAC;IACjE,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;YAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC1G,CAAC;IACD,OAAO;QACN,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACvE,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnF,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;KAC9B,CAAC;AAChD,CAAC","sourcesContent":["import type {\n\tExactTelemetryAttributes,\n\tInferRequiredAndOptionalAttributes,\n\tSpanAttributes,\n\tTelemetryContext,\n\tTelemetrySchemaDefinition,\n\tTelemetryStartAttributeDefinition,\n} from \"./index.ts\";\n\nexport interface InstrumentOptions {\n\tdescription?: string;\n\tunit?: string;\n}\n\nexport interface HistogramOptions extends InstrumentOptions {\n\t/** Bucket hints; callers supply finite, strictly increasing values. */\n\tboundaries?: readonly number[];\n}\n\nexport interface TelemetryCounter {\n\tadd(value: number, attributes?: SpanAttributes): void;\n}\n\nexport interface TelemetryUpDownCounter {\n\tadd(value: number, attributes?: SpanAttributes): void;\n}\n\nexport interface TelemetryHistogram {\n\trecord(value: number, attributes?: SpanAttributes, context?: TelemetryContext): void;\n}\n\n/**\n * Optional adapter capability with synchronous factories and recording methods.\n * Typed inputs are trusted; callers supply finite measurements and nonnegative counter increments.\n * Malformed input behavior is unspecified.\n */\nexport interface TelemetryMetrics {\n\tcounter(name: string, options?: InstrumentOptions): TelemetryCounter;\n\tupDownCounter(name: string, options?: InstrumentOptions): TelemetryUpDownCounter;\n\thistogram(name: string, options?: HistogramOptions): TelemetryHistogram;\n}\n\nexport type TelemetryMetricAttributeDefinition = TelemetryStartAttributeDefinition & { cardinality?: \"low\" };\n\nexport type TelemetryMetricDefinition = {\n\tdescription: string;\n\tunit?: string;\n\tattributes: Record<string, TelemetryMetricAttributeDefinition>;\n} & ({ kind: \"counter\" | \"upDownCounter\"; boundaries?: never } | { kind: \"histogram\"; boundaries?: readonly number[] });\n\ntype MetricKind = TelemetryMetricDefinition[\"kind\"];\ntype MetricSchemas = readonly [TelemetrySchemaDefinition, ...TelemetrySchemaDefinition[]];\n\ntype MetricsOf<Schema extends TelemetrySchemaDefinition> = Schema extends {\n\tmetrics: infer Metrics extends Record<string, TelemetryMetricDefinition>;\n}\n\t? Metrics\n\t: Record<never, never>;\n\ntype MetricNames<\n\tSchema extends TelemetrySchemaDefinition,\n\tKind extends MetricKind,\n> = Schema extends TelemetrySchemaDefinition\n\t? {\n\t\t\t[Name in keyof MetricsOf<Schema>]: MetricsOf<Schema>[Name] extends { kind: Kind } ? Name : never;\n\t\t}[keyof MetricsOf<Schema>] &\n\t\t\tstring\n\t: never;\n\ntype MetricByName<\n\tSchema extends TelemetrySchemaDefinition,\n\tName extends string,\n> = Schema extends TelemetrySchemaDefinition\n\t? Name extends keyof MetricsOf<Schema>\n\t\t? MetricsOf<Schema>[Name]\n\t\t: never\n\t: never;\n\ntype DuplicateMetricNames<\n\tSchemas extends readonly TelemetrySchemaDefinition[],\n\tSeen extends string = never,\n> = Schemas extends readonly [\n\tinfer Schema extends TelemetrySchemaDefinition,\n\t...infer Rest extends readonly TelemetrySchemaDefinition[],\n]\n\t? Extract<keyof MetricsOf<Schema>, Seen> | DuplicateMetricNames<Rest, Seen | (keyof MetricsOf<Schema> & string)>\n\t: never;\n\ntype MetricAttributes<Definition extends TelemetryMetricDefinition> = InferRequiredAndOptionalAttributes<\n\tDefinition[\"attributes\"]\n>;\n\ntype MeasurementArguments<\n\tDefinition extends TelemetryMetricDefinition,\n\tAttributes extends MetricAttributes<Definition>,\n> = {\n\t[Name in keyof Definition[\"attributes\"]]: Definition[\"attributes\"][Name][\"required\"] extends true ? Name : never;\n}[keyof Definition[\"attributes\"]] extends never\n\t? [attributes?: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>]\n\t: [attributes: ExactTelemetryAttributes<MetricAttributes<Definition>, Attributes>];\n\nexport type SchemaTelemetryCounter<Definition extends TelemetryMetricDefinition> = {\n\tadd<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(\n\t\tvalue: number,\n\t\t...args: MeasurementArguments<Definition, Attributes>\n\t): void;\n};\n\nexport type SchemaTelemetryHistogram<Definition extends TelemetryMetricDefinition> = {\n\trecord<const Attributes extends MetricAttributes<Definition> = MetricAttributes<Definition>>(\n\t\tvalue: number,\n\t\t...args: [...MeasurementArguments<Definition, Attributes>, context?: TelemetryContext]\n\t): void;\n};\n\nexport interface TypedTelemetryMetrics<Schemas extends MetricSchemas> {\n\tcounter<Name extends MetricNames<Schemas[number], \"counter\">>(\n\t\tname: Name,\n\t): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;\n\tupDownCounter<Name extends MetricNames<Schemas[number], \"upDownCounter\">>(\n\t\tname: Name,\n\t): SchemaTelemetryCounter<MetricByName<Schemas[number], Name>>;\n\thistogram<Name extends MetricNames<Schemas[number], \"histogram\">>(\n\t\tname: Name,\n\t): SchemaTelemetryHistogram<MetricByName<Schemas[number], Name>>;\n}\n\n/** Bind instrument names, kinds, metadata, and exact measurement attributes to one or more schemas. */\nexport function createTypedMetrics<const Schemas extends MetricSchemas>(\n\tmetrics: TelemetryMetrics,\n\tschemas: Schemas &\n\t\t([DuplicateMetricNames<Schemas>] extends [never]\n\t\t\t? unknown\n\t\t\t: { readonly \"duplicate telemetry metric names\": DuplicateMetricNames<Schemas> }),\n): TypedTelemetryMetrics<Schemas> {\n\tconst definitions = new Map<string, TelemetryMetricDefinition>();\n\tfor (const schema of schemas) {\n\t\tfor (const [name, definition] of Object.entries(schema.metrics ?? {})) definitions.set(name, definition);\n\t}\n\treturn {\n\t\tcounter: (name: string) => metrics.counter(name, definitions.get(name)),\n\t\tupDownCounter: (name: string) => metrics.upDownCounter(name, definitions.get(name)),\n\t\thistogram: (name: string) => metrics.histogram(name, definitions.get(name)),\n\t} as unknown as TypedTelemetryMetrics<Schemas>;\n}\n"]}

package/dist/noop.d.ts

@@ -1,4 +1,9 @@
-import type { TelemetryContext } from "./index.ts";
+import type { TelemetryPropagation, TelemetrySpan } from "./index.ts";
+import type { TelemetryMetrics } from "./metrics.ts";
+/** Shared instruments that never inspect or retain metadata, measurements, or contexts. */
+export declare const NOOP_TELEMETRY_METRICS: TelemetryMetrics;
+/** Shared propagation capability that neither inspects nor retains its inputs. */
+export declare const NOOP_TELEMETRY_PROPAGATION: TelemetryPropagation;
 /** Shared telemetry context used when an application does not provide one. */
-export declare const NOOP_TELEMETRY_CONTEXT: TelemetryContext;
+export declare const NOOP_TELEMETRY_CONTEXT: TelemetrySpan;
 //# sourceMappingURL=noop.d.ts.map

package/dist/noop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,gBAAgB,EAAiB,MAAM,YAAY,CAAC;AAkB/E,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,gBAAoC,CAAC"}
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,oBAAoB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAwC,gBAAgB,EAA0B,MAAM,cAAc,CAAC;AAUnH,2FAA2F;AAC3F,eAAO,MAAM,sBAAsB,EAAE,gBAInC,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,EAAE,oBAGvC,CAAC;AAaH,8EAA8E;AAC9E,eAAO,MAAM,sBAAsB,EAAE,aAAiC,CAAC"}

package/dist/noop.js

@@ -1,13 +1,25 @@
-function startNoopSpan(_options, callback) {
-    try {
-        return Promise.resolve(callback(noopTelemetrySpan));
-    }
-    catch (error) {
-        return Promise.reject(error);
-    }
+async function startNoopSpan(_options, callback) {
+    return callback(noopTelemetrySpan);
 }
+const noopCounter = Object.freeze({ add: () => { } });
+const noopUpDownCounter = Object.freeze({ add: () => { } });
+const noopHistogram = Object.freeze({ record: () => { } });
+/** Shared instruments that never inspect or retain metadata, measurements, or contexts. */
+export const NOOP_TELEMETRY_METRICS = Object.freeze({
+    counter: () => noopCounter,
+    upDownCounter: () => noopUpDownCounter,
+    histogram: () => noopHistogram,
+});
+/** Shared propagation capability that neither inspects nor retains its inputs. */
+export const NOOP_TELEMETRY_PROPAGATION = Object.freeze({
+    inject: () => undefined,
+    extract: () => NOOP_TELEMETRY_CONTEXT,
+});
 const noopTelemetrySpan = {
+    metrics: NOOP_TELEMETRY_METRICS,
+    propagation: NOOP_TELEMETRY_PROPAGATION,
     startSpan: startNoopSpan,
+    addLink: () => { },
     addEvent: () => { },
     setAttributes: () => { },
     setStatus: () => { },

package/dist/noop.js.map

@@ -1 +1 @@
-{"version":3,"file":"noop.js","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAEA,SAAS,aAAa,CAAI,QAAqB,EAAE,QAAiD;IACjG,IAAI,CAAC;QACJ,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;AACF,CAAC;AAED,MAAM,iBAAiB,GAAkB;IACxC,SAAS,EAAE,aAAa;IACxB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;CACnB,CAAC;AACF,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEjC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAqB,iBAAiB,CAAC","sourcesContent":["import type { SpanOptions, TelemetryContext, TelemetrySpan } from \"./index.ts\";\n\nfunction startNoopSpan<T>(_options: SpanOptions, callback: (span: TelemetrySpan) => T | Promise<T>): Promise<T> {\n\ttry {\n\t\treturn Promise.resolve(callback(noopTelemetrySpan));\n\t} catch (error) {\n\t\treturn Promise.reject(error);\n\t}\n}\n\nconst noopTelemetrySpan: TelemetrySpan = {\n\tstartSpan: startNoopSpan,\n\taddEvent: () => {},\n\tsetAttributes: () => {},\n\tsetStatus: () => {},\n};\nObject.freeze(noopTelemetrySpan);\n\n/** Shared telemetry context used when an application does not provide one. */\nexport const NOOP_TELEMETRY_CONTEXT: TelemetryContext = noopTelemetrySpan;\n"]}
+{"version":3,"file":"noop.js","sourceRoot":"","sources":["../src/noop.ts"],"names":[],"mappings":"AAGA,KAAK,UAAU,aAAa,CAAI,QAAqB,EAAE,QAAiD;IACvG,OAAO,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,WAAW,GAAqB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AACvE,MAAM,iBAAiB,GAA2B,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AACnF,MAAM,aAAa,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;AAE9E,2FAA2F;AAC3F,MAAM,CAAC,MAAM,sBAAsB,GAAqB,MAAM,CAAC,MAAM,CAAC;IACrE,OAAO,EAAE,GAAG,EAAE,CAAC,WAAW;IAC1B,aAAa,EAAE,GAAG,EAAE,CAAC,iBAAiB;IACtC,SAAS,EAAE,GAAG,EAAE,CAAC,aAAa;CAC9B,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,0BAA0B,GAAyB,MAAM,CAAC,MAAM,CAAC;IAC7E,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS;IACvB,OAAO,EAAE,GAAG,EAAE,CAAC,sBAAsB;CACrC,CAAC,CAAC;AAEH,MAAM,iBAAiB,GAAkB;IACxC,OAAO,EAAE,sBAAsB;IAC/B,WAAW,EAAE,0BAA0B;IACvC,SAAS,EAAE,aAAa;IACxB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;IACjB,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;IAClB,aAAa,EAAE,GAAG,EAAE,GAAE,CAAC;IACvB,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;CACnB,CAAC;AACF,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEjC,8EAA8E;AAC9E,MAAM,CAAC,MAAM,sBAAsB,GAAkB,iBAAiB,CAAC","sourcesContent":["import type { SpanOptions, TelemetryPropagation, TelemetrySpan } from \"./index.ts\";\nimport type { TelemetryCounter, TelemetryHistogram, TelemetryMetrics, TelemetryUpDownCounter } from \"./metrics.ts\";\n\nasync function startNoopSpan<T>(_options: SpanOptions, callback: (span: TelemetrySpan) => T | Promise<T>): Promise<T> {\n\treturn callback(noopTelemetrySpan);\n}\n\nconst noopCounter: TelemetryCounter = Object.freeze({ add: () => {} });\nconst noopUpDownCounter: TelemetryUpDownCounter = Object.freeze({ add: () => {} });\nconst noopHistogram: TelemetryHistogram = Object.freeze({ record: () => {} });\n\n/** Shared instruments that never inspect or retain metadata, measurements, or contexts. */\nexport const NOOP_TELEMETRY_METRICS: TelemetryMetrics = Object.freeze({\n\tcounter: () => noopCounter,\n\tupDownCounter: () => noopUpDownCounter,\n\thistogram: () => noopHistogram,\n});\n\n/** Shared propagation capability that neither inspects nor retains its inputs. */\nexport const NOOP_TELEMETRY_PROPAGATION: TelemetryPropagation = Object.freeze({\n\tinject: () => undefined,\n\textract: () => NOOP_TELEMETRY_CONTEXT,\n});\n\nconst noopTelemetrySpan: TelemetrySpan = {\n\tmetrics: NOOP_TELEMETRY_METRICS,\n\tpropagation: NOOP_TELEMETRY_PROPAGATION,\n\tstartSpan: startNoopSpan,\n\taddLink: () => {},\n\taddEvent: () => {},\n\tsetAttributes: () => {},\n\tsetStatus: () => {},\n};\nObject.freeze(noopTelemetrySpan);\n\n/** Shared telemetry context used when an application does not provide one. */\nexport const NOOP_TELEMETRY_CONTEXT: TelemetrySpan = noopTelemetrySpan;\n"]}

package/dist/render.d.ts

@@ -0,0 +1,8 @@
+import type { StoredSpan } from "./index.ts";
+/**
+ * Render stored spans as a chronological forest, treating absent parents as roots. Lengths of time are milliseconds to
+ * the microsecond. Control characters in ids, names, attribute keys and error messages are escaped (attribute values
+ * are JSON).
+ */
+export declare function renderTrace(spans: readonly StoredSpan[]): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,UAAU,EAAE,MAAM,YAAY,CAAC;AAsB7D;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CA4ChE"}

package/dist/render.js

@@ -0,0 +1,65 @@
+// C0 and C1 control characters and DEL: a stored id, name or message may come from another process (a carrier), so
+// none reaches a terminal or a viewer raw.
+const CONTROL = /[\u0000-\u001f\u007f-\u009f]/g;
+/** `text` with every control character written as a `\uXXXX` escape. */
+function escaped(text) {
+    return text.replace(CONTROL, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`);
+}
+/** `ms` rounded to the microsecond, as the adapters record span times. */
+function microseconds(ms) {
+    return Math.round(ms * 1000) / 1000;
+}
+function formatAttributes(attributes = {}) {
+    return Object.entries(attributes)
+        .map(([key, value]) => ` ${escaped(key)}=${JSON.stringify(value)}`)
+        .join("");
+}
+/**
+ * Render stored spans as a chronological forest, treating absent parents as roots. Lengths of time are milliseconds to
+ * the microsecond. Control characters in ids, names, attribute keys and error messages are escaped (attribute values
+ * are JSON).
+ */
+export function renderTrace(spans) {
+    const byId = new Map(spans.map((span) => [span.id, span]));
+    const roots = [];
+    const children = new Map();
+    for (const span of [...byId.values()].sort((left, right) => left.startedMs - right.startedMs)) {
+        if (span.parentId === undefined || !byId.has(span.parentId)) {
+            roots.push(span);
+        }
+        else {
+            const siblings = children.get(span.parentId);
+            if (siblings === undefined)
+                children.set(span.parentId, [span]);
+            else
+                siblings.push(span);
+        }
+    }
+    const lines = [];
+    const pending = roots.reverse().map((span) => ({ span, depth: 0 }));
+    while (pending.length > 0) {
+        const { span, depth } = pending.pop();
+        const indent = "  ".repeat(depth);
+        let error = "";
+        if (span.status.status === "error") {
+            error = " error";
+            if (span.status.error !== undefined) {
+                error += ` ${escaped(span.status.error.name)}: ${escaped(span.status.error.message)}`;
+            }
+        }
+        lines.push(`${indent}${escaped(span.name)}${formatAttributes(span.attributes)} (${microseconds(span.endedMs - span.startedMs)}ms)${error}`);
+        for (const event of span.events) {
+            lines.push(`${indent}  · ${escaped(event.name)}${formatAttributes(event.attributes)} (+${microseconds(event.timeMs)}ms)`);
+        }
+        for (const link of span.links) {
+            const ids = `trace ${escaped(link.traceId)} span ${escaped(link.spanId)}`;
+            lines.push(`${indent}  → link ${ids}${formatAttributes(link.attributes)}`);
+        }
+        const descendants = children.get(span.id) ?? [];
+        for (let index = descendants.length - 1; index >= 0; index--) {
+            pending.push({ span: descendants[index], depth: depth + 1 });
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAEA,mHAAmH;AACnH,2CAA2C;AAC3C,MAAM,OAAO,GAAG,+BAA+B,CAAC;AAEhD,wEAAwE;AACxE,SAAS,OAAO,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;AAClG,CAAC;AAED,0EAA0E;AAC1E,SAAS,YAAY,CAAC,EAAU;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC;AAED,SAAS,gBAAgB,CAAC,UAAU,GAA6B,EAAE;IAClE,OAAO,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SAClE,IAAI,CAAC,EAAE,CAAC,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAA4B;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/F,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,CAAC;YACP,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,IAAI,QAAQ,KAAK,SAAS;gBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;;gBAC3D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC,GAAG,EAAG,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,KAAK,GAAG,EAAE,CAAC;QACf,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YACpC,KAAK,GAAG,QAAQ,CAAC;YACjB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACrC,KAAK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACvF,CAAC;QACF,CAAC;QACD,KAAK,CAAC,IAAI,CACT,GAAG,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,YAAY,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,EAAE,CAC/H,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CACT,GAAG,MAAM,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAC7G,CAAC;QACH,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,SAAS,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1E,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,YAAY,GAAG,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAChD,KAAK,IAAI,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC9D,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,KAAK,CAAE,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/D,CAAC;IACF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC","sourcesContent":["import type { SpanAttributes, StoredSpan } from \"./index.ts\";\n\n// C0 and C1 control characters and DEL: a stored id, name or message may come from another process (a carrier), so\n// none reaches a terminal or a viewer raw.\nconst CONTROL = /[\\u0000-\\u001f\\u007f-\\u009f]/g;\n\n/** `text` with every control character written as a `\\uXXXX` escape. */\nfunction escaped(text: string): string {\n\treturn text.replace(CONTROL, (char) => `\\\\u${char.charCodeAt(0).toString(16).padStart(4, \"0\")}`);\n}\n\n/** `ms` rounded to the microsecond, as the adapters record span times. */\nfunction microseconds(ms: number): number {\n\treturn Math.round(ms * 1000) / 1000;\n}\n\nfunction formatAttributes(attributes: Readonly<SpanAttributes> = {}): string {\n\treturn Object.entries(attributes)\n\t\t.map(([key, value]) => ` ${escaped(key)}=${JSON.stringify(value)}`)\n\t\t.join(\"\");\n}\n\n/**\n * Render stored spans as a chronological forest, treating absent parents as roots. Lengths of time are milliseconds to\n * the microsecond. Control characters in ids, names, attribute keys and error messages are escaped (attribute values\n * are JSON).\n */\nexport function renderTrace(spans: readonly StoredSpan[]): string {\n\tconst byId = new Map(spans.map((span) => [span.id, span]));\n\tconst roots: StoredSpan[] = [];\n\tconst children = new Map<string, StoredSpan[]>();\n\tfor (const span of [...byId.values()].sort((left, right) => left.startedMs - right.startedMs)) {\n\t\tif (span.parentId === undefined || !byId.has(span.parentId)) {\n\t\t\troots.push(span);\n\t\t} else {\n\t\t\tconst siblings = children.get(span.parentId);\n\t\t\tif (siblings === undefined) children.set(span.parentId, [span]);\n\t\t\telse siblings.push(span);\n\t\t}\n\t}\n\n\tconst lines: string[] = [];\n\tconst pending = roots.reverse().map((span) => ({ span, depth: 0 }));\n\twhile (pending.length > 0) {\n\t\tconst { span, depth } = pending.pop()!;\n\t\tconst indent = \"  \".repeat(depth);\n\t\tlet error = \"\";\n\t\tif (span.status.status === \"error\") {\n\t\t\terror = \" error\";\n\t\t\tif (span.status.error !== undefined) {\n\t\t\t\terror += ` ${escaped(span.status.error.name)}: ${escaped(span.status.error.message)}`;\n\t\t\t}\n\t\t}\n\t\tlines.push(\n\t\t\t`${indent}${escaped(span.name)}${formatAttributes(span.attributes)} (${microseconds(span.endedMs - span.startedMs)}ms)${error}`,\n\t\t);\n\t\tfor (const event of span.events) {\n\t\t\tlines.push(\n\t\t\t\t`${indent}  · ${escaped(event.name)}${formatAttributes(event.attributes)} (+${microseconds(event.timeMs)}ms)`,\n\t\t\t);\n\t\t}\n\t\tfor (const link of span.links) {\n\t\t\tconst ids = `trace ${escaped(link.traceId)} span ${escaped(link.spanId)}`;\n\t\t\tlines.push(`${indent}  → link ${ids}${formatAttributes(link.attributes)}`);\n\t\t}\n\t\tconst descendants = children.get(span.id) ?? [];\n\t\tfor (let index = descendants.length - 1; index >= 0; index--) {\n\t\t\tpending.push({ span: descendants[index]!, depth: depth + 1 });\n\t\t}\n\t}\n\treturn lines.join(\"\\n\");\n}\n"]}

package/dist/testing/conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,+BAA+B,EAE/B,8BAA8B,EAC9B,MAAM,YAAY,CAAC;AAoDpB,oFAAoF;AACpF,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,8BAA8B,GACrC,SAAS,+BAA+B,EAAE,CA4P5C"}
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../../src/testing/conformance.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,+BAA+B,EAE/B,8BAA8B,EAC9B,MAAM,YAAY,CAAC;AAmCpB,oFAAoF;AACpF,wBAAgB,iCAAiC,CAChD,OAAO,EAAE,8BAA8B,GACrC,SAAS,+BAA+B,EAAE,CAoV5C"}

package/dist/testing/conformance.js

@@ -50,7 +50,8 @@ var __disposeResources = (this && this.__disposeResources) || (function (Suppres
     var e = new Error(message);
     return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
 });
-import { deepStrictEqual, doesNotThrow, fail, ok, strictEqual } from "node:assert/strict";
+import { deepStrictEqual, fail, ok, strictEqual } from "node:assert/strict";
+import { NOOP_TELEMETRY_CONTEXT } from "../index.js";
 function createCase(factory, group, name, test) {
     return {
         group,
@@ -87,25 +88,174 @@ async function rejectsWithSameValue(operation, expected) {
         strictEqual(error, expected);
     }
 }
-function unreadable(value) {
-    return new Proxy(value, {
-        get: () => {
-            throw new Error("read");
-        },
-        getOwnPropertyDescriptor: () => {
-            throw new Error("inspect");
-        },
-        getPrototypeOf: () => {
-            throw new Error("prototype");
-        },
-        ownKeys: () => {
-            throw new Error("enumerate");
-        },
-    });
-}
 /** Creates runner-independent cases for the callback telemetry adapter contract. */
 export function createTelemetryAdapterConformance(factory) {
     return [
+        createCase(factory, "capabilities", "carries adapter capabilities through contexts and spans", async (fixture) => {
+            const metrics = fixture.metrics ?? fixture.context.metrics;
+            const propagation = fixture.propagation ?? fixture.context.propagation;
+            const assertCapabilities = (context) => {
+                strictEqual(context.metrics, metrics);
+                strictEqual(context.propagation, propagation);
+            };
+            assertCapabilities(fixture.context);
+            let settled;
+            await fixture.context.startSpan({ name: "capabilities" }, async (span) => {
+                settled = span;
+                assertCapabilities(span);
+                await span.startSpan({ name: "capabilities.child" }, assertCapabilities);
+                if (propagation) {
+                    const parent = propagation.extract(propagation.inject(span));
+                    assertCapabilities(parent);
+                    await parent.startSpan({ name: "capabilities.extracted" }, assertCapabilities);
+                }
+            });
+            ok(settled);
+            await settled.startSpan({ name: "capabilities.inert" }, assertCapabilities);
+        }),
+        createCase(factory, "metrics", "records ordered measurements and optional histogram exemplars", async (fixture) => {
+            if (!fixture.metrics)
+                return;
+            ok(fixture.getMetrics, "Metrics fixtures require a normalized measurement reader");
+            fixture.metrics
+                .counter("bytes", { description: "Encoded bytes", unit: "By" })
+                .add(12, { direction: "out" });
+            const active = fixture.metrics.upDownCounter("active");
+            active.add(1);
+            active.add(-1);
+            const histogram = fixture.metrics.histogram("duration", { unit: "ms", boundaries: [1, 10] });
+            await fixture.context.startSpan({ name: "measured" }, (span) => histogram.record(5, { method: "read" }, span));
+            const measurements = await fixture.getMetrics();
+            deepStrictEqual(measurements.map((measurement) => [measurement.kind, measurement.name, measurement.value]), [
+                ["counter", "bytes", 12],
+                ["upDownCounter", "active", 1],
+                ["upDownCounter", "active", -1],
+                ["histogram", "duration", 5],
+            ]);
+            deepStrictEqual(measurements[0]?.attributes, { direction: "out" });
+            strictEqual(measurements[0]?.description, "Encoded bytes");
+            strictEqual(measurements[0]?.unit, "By");
+            deepStrictEqual(measurements[3]?.boundaries, [1, 10]);
+            deepStrictEqual(measurements[3]?.context, findSpan(await fixture.getSpans(), "measured").context);
+        }),
+        createCase(factory, "metrics", "copies instrument metadata and measurement attributes", async (fixture) => {
+            if (!fixture.metrics)
+                return;
+            ok(fixture.getMetrics, "Metrics fixtures require a normalized measurement reader");
+            const boundaries = [1, 10];
+            const options = { description: "Original", boundaries };
+            const histogram = fixture.metrics.histogram("snapshot", options);
+            boundaries.push(100);
+            options.description = "Changed";
+            const attributes = { tags: ["original"] };
+            histogram.record(-1, attributes);
+            attributes.tags.push("changed");
+            const measurements = await fixture.getMetrics();
+            strictEqual(measurements.length, 1);
+            deepStrictEqual(measurements[0]?.attributes, { tags: ["original"] });
+            deepStrictEqual(measurements[0]?.boundaries, [1, 10]);
+            strictEqual(measurements[0]?.description, "Original");
+            strictEqual(measurements[0]?.context, null);
+        }),
+        createCase(factory, "links", "records initial and late links without changing parents", async (fixture) => {
+            let target;
+            await fixture.context.startSpan({ name: "target" }, (span) => {
+                target = span;
+            });
+            if (!target)
+                throw new Error("Expected target span");
+            const targetSpan = target;
+            const attributes = { reason: ["initial"] };
+            await fixture.context.startSpan({ name: "linked", links: [{ context: target, attributes }] }, (span) => {
+                attributes.reason.push("mutated");
+                span.addLink({ context: targetSpan, attributes: { reason: "late" } });
+                span.addLink({ context: NOOP_TELEMETRY_CONTEXT });
+            });
+            const spans = await fixture.getSpans();
+            const linked = findSpan(spans, "linked");
+            strictEqual(linked.parentId, null);
+            strictEqual(linked.parentContext, null);
+            deepStrictEqual(linked.links, [
+                { context: findSpan(spans, "target").context, attributes: { reason: ["initial"] } },
+                { context: findSpan(spans, "target").context, attributes: { reason: "late" } },
+            ]);
+        }),
+        createCase(factory, "links", "ignores links added after source settlement", async (fixture) => {
+            let source;
+            await fixture.context.startSpan({ name: "link-source" }, (span) => {
+                source = span;
+            });
+            if (!source)
+                throw new Error("Expected source span");
+            source.addLink({ context: source });
+            deepStrictEqual(findSpan(await fixture.getSpans(), "link-source").links, []);
+        }),
+        createCase(factory, "propagation", "roundtrips parent identity through JSON without retaining the carrier", async (fixture) => {
+            if (!fixture.propagation)
+                return;
+            const propagation = fixture.propagation;
+            await fixture.context.startSpan({ name: "sender" }, async (span) => {
+                const carrier = propagation.inject(span);
+                ok(carrier);
+                const wire = JSON.parse(JSON.stringify(carrier));
+                const parent = propagation.extract(wire);
+                for (const key of Object.keys(wire))
+                    wire[key] = "mutated";
+                await parent.startSpan({ name: "receiver" }, () => 42);
+                deepStrictEqual(propagation.inject(span), carrier);
+            });
+            const spans = await fixture.getSpans();
+            deepStrictEqual(findSpan(spans, "receiver").parentContext, findSpan(spans, "sender").context);
+        }),
+        createCase(factory, "propagation", "absent and unknown carriers produce recorded roots", async (fixture) => {
+            if (!fixture.propagation)
+                return;
+            strictEqual(fixture.propagation.inject(NOOP_TELEMETRY_CONTEXT), undefined);
+            const carriers = [undefined, {}, { unknown: "format" }];
+            for (const [index, carrier] of carriers.entries()) {
+                const context = fixture.propagation.extract(carrier);
+                strictEqual(await context.startSpan({ name: `fallback-${index}` }, () => 42), 42);
+            }
+            for (const span of await fixture.getSpans())
+                strictEqual(span.parentContext, null);
+        }),
+        createCase(factory, "propagation", "propagates across fresh adapters and multiple hops", async (fixture) => {
+            const env_2 = { stack: [], error: void 0, hasError: false };
+            try {
+                if (!fixture.propagation)
+                    return;
+                const receiver = __addDisposableResource(env_2, await factory(), true);
+                const worker = __addDisposableResource(env_2, await factory(), true);
+                if (!receiver.propagation || !worker.propagation)
+                    throw new Error("Expected propagation on each fixture");
+                let senderCarrier;
+                await fixture.context.startSpan({ name: "sender" }, (span) => {
+                    senderCarrier = fixture.propagation?.inject(span);
+                });
+                ok(senderCarrier);
+                let receiverCarrier;
+                await receiver.propagation
+                    .extract(JSON.parse(JSON.stringify(senderCarrier)))
+                    .startSpan({ name: "receiver" }, (span) => {
+                    receiverCarrier = receiver.propagation?.inject(span);
+                });
+                ok(receiverCarrier);
+                await worker.propagation
+                    .extract(JSON.parse(JSON.stringify(receiverCarrier)))
+                    .startSpan({ name: "worker" }, () => { });
+                deepStrictEqual(findSpan(await receiver.getSpans(), "receiver").parentContext, senderCarrier);
+                deepStrictEqual(findSpan(await worker.getSpans(), "worker").parentContext, receiverCarrier);
+            }
+            catch (e_2) {
+                env_2.error = e_2;
+                env_2.hasError = true;
+            }
+            finally {
+                const result_2 = __disposeResources(env_2);
+                if (result_2)
+                    await result_2;
+            }
+        }),
         createCase(factory, "callback lifecycle", "admits once synchronously and preserves the result", async (fixture) => {
             let admitted = false;
             let calls = 0;
@@ -131,20 +281,8 @@ export function createTelemetryAdapterConformance(factory) {
                 throw asyncError;
             }), asyncError);
             await rejectsWithSameValue(fixture.context.startSpan({ name: "undefined-error" }, () => Promise.reject(undefined)), undefined);
-            const unreadableError = unreadable({ kind: "unreadable" });
-            await rejectsWithSameValue(fixture.context.startSpan({ name: "unreadable-error" }, () => {
-                throw unreadableError;
-            }), unreadableError);
-            const asyncUnreadableError = unreadable({ kind: "async-unreadable" });
-            await rejectsWithSameValue(fixture.context.startSpan({ name: "async-unreadable-error" }, () => Promise.reject(asyncUnreadableError)), asyncUnreadableError);
             const spans = await fixture.getSpans();
-            for (const name of [
-                "sync-error",
-                "async-error",
-                "undefined-error",
-                "unreadable-error",
-                "async-unreadable-error",
-            ]) {
+            for (const name of ["sync-error", "async-error", "undefined-error"]) {
                 strictEqual(findSpan(spans, name).status.status, "error");
             }
         }),
@@ -196,18 +334,6 @@ export function createTelemetryAdapterConformance(factory) {
                 { name: "second", attributes: { index: 2 } },
             ]);
         }),
-        createCase(factory, "recording", "ignores failed attribute calls atomically", async (fixture) => {
-            await fixture.context.startSpan({ name: "atomic-attributes", attributes: { retained: "value" } }, (span) => {
-                const attributes = {
-                    partial: "must not survive",
-                    unreadable: unreadable(["value"]),
-                };
-                doesNotThrow(() => span.setAttributes(attributes));
-            });
-            deepStrictEqual(findSpan(await fixture.getSpans(), "atomic-attributes").attributes, {
-                retained: "value",
-            });
-        }),
         createCase(factory, "recording", "makes calls after settlement inert", async (fixture) => {
             let settledSpan;
             await fixture.context.startSpan({ name: "settled", attributes: { value: "initial" } }, (span) => {
@@ -216,9 +342,9 @@ export function createTelemetryAdapterConformance(factory) {
             const capturedSpan = settledSpan;
             if (!capturedSpan)
                 throw new Error("Expected callback span");
-            doesNotThrow(() => capturedSpan.setAttributes({ value: "late" }));
-            doesNotThrow(() => capturedSpan.addEvent("late", { value: true }));
-            doesNotThrow(() => capturedSpan.setStatus({ status: "error" }));
+            capturedSpan.setAttributes({ value: "late" });
+            capturedSpan.addEvent("late", { value: true });
+            capturedSpan.setStatus({ status: "error" });
             let childAdmitted = false;
             const childResult = capturedSpan.startSpan({ name: "late-child" }, () => {
                 childAdmitted = true;
@@ -257,38 +383,6 @@ export function createTelemetryAdapterConformance(factory) {
             ok(second.endSequence < first.endSequence);
             ok(first.endSequence < parent.endSequence);
         }),
-        createCase(factory, "passivity", "suppresses unreadable telemetry payload failures", async (fixture) => {
-            let calls = 0;
-            const options = unreadable({ name: "unreadable-options", attributes: { secret: "value" } });
-            const result = fixture.context.startSpan(options, () => {
-                calls++;
-                return 9;
-            });
-            strictEqual(calls, 1);
-            strictEqual(await result, 9);
-            deepStrictEqual(await fixture.getSpans(), []);
-            await fixture.context.startSpan({ name: "unreadable-recording" }, (span) => {
-                const attributes = unreadable({ secret: "value" });
-                const status = unreadable({ status: "ok" });
-                doesNotThrow(() => span.setAttributes(attributes));
-                doesNotThrow(() => span.addEvent("unreadable-event", attributes));
-                doesNotThrow(() => span.setStatus(status));
-            });
-            const recorded = await fixture.getSpans();
-            strictEqual(recorded.length, 1);
-            deepStrictEqual(recorded[0]?.attributes, {});
-            deepStrictEqual(recorded[0]?.events, []);
-            deepStrictEqual(recorded[0]?.status, { status: "ok" });
-        }),
-        createCase(factory, "passivity", "ignores failed status calls atomically", async (fixture) => {
-            const rejection = new Error("rejected after unreadable status");
-            await rejectsWithSameValue(fixture.context.startSpan({ name: "unreadable-status" }, (span) => {
-                const status = unreadable({ status: "ok" });
-                doesNotThrow(() => span.setStatus(status));
-                return Promise.reject(rejection);
-            }), rejection);
-            strictEqual(findSpan(await fixture.getSpans(), "unreadable-status").status.status, "error");
-        }),
     ];
 }
 //# sourceMappingURL=conformance.js.map