effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/unstable/observability/OtlpResource.js

@@ -1,22 +1,40 @@
 /**
- * Helpers and data types for describing the OTLP resource attached to exported
- * logs, metrics, and traces.
+ * OTLP resource metadata for logs, metrics, and traces exported by Effect.
  *
- * A resource identifies the service that produced telemetry and carries
- * process- or deployment-level attributes that should be shared across every
- * signal sent by the Effect OTLP logger, metrics exporter, and tracer. Use this
- * module when building explicit resource metadata, reading the standard OTEL
- * resource environment variables, or converting application metadata into OTLP
- * `KeyValue` / `AnyValue` shapes before serialization.
+ * This module builds the resource object attached to every OTLP signal sent by
+ * the Effect observability exporters. A resource carries service identity such
+ * as `service.name` and `service.version`, plus process, host, deployment, or
+ * application attributes that should be shared by all exported telemetry.
+ *
+ * **Mental model**
+ *
+ * A {@link Resource} is the OTLP envelope for service-level metadata. Use
+ * {@link make} when the service metadata is already known, or use
+ * {@link fromConfig} when explicit options should be merged with standard
+ * OpenTelemetry environment variables before export. Attribute helpers convert
+ * JavaScript values into OTLP {@link KeyValue} and {@link AnyValue} structures
+ * used by JSON and protobuf serialization.
+ *
+ * **Common tasks**
+ *
+ * - Create explicit resource metadata with {@link make}.
+ * - Read `OTEL_RESOURCE_ATTRIBUTES`, `OTEL_SERVICE_NAME`, and
+ *   `OTEL_SERVICE_VERSION` with {@link fromConfig}.
+ * - Convert custom attribute records with {@link entriesToAttributes}.
+ * - Convert individual runtime values with {@link unknownToAttributeValue}.
+ *
+ * **Gotchas**
  *
  * `service.name` is required because the signal exporters also use it as the
- * instrumentation scope name. Explicit resource options take precedence over
- * `OTEL_RESOURCE_ATTRIBUTES`, `OTEL_SERVICE_NAME`, and
- * `OTEL_SERVICE_VERSION`; `service.name` and `service.version` are normalized
- * through the service metadata inputs and re-added as canonical OTLP
- * attributes rather than left in the custom attribute map. Attribute values are
- * converted to OTLP scalar or array values where possible, with unsupported
- * runtime values formatted as strings.
+ * instrumentation scope name. Explicit options take precedence over
+ * environment variables. `service.name` and `service.version` are normalized
+ * into canonical OTLP attributes instead of being left in the custom attribute
+ * map. Unsupported runtime values are formatted as strings.
+ *
+ * **See also**
+ *
+ * {@link Resource}, {@link make}, {@link fromConfig},
+ * {@link unknownToAttributeValue}.
  *
  * @since 4.0.0
  */

package/dist/unstable/observability/OtlpResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"OtlpResource.js","names":["Config","Effect","format","Schema","make","options","resourceAttributes","attributes","entriesToAttributes","Object","entries","push","key","value","stringValue","serviceName","serviceVersion","droppedAttributesCount","fromConfig","fnUntraced","schema","UndefinedOr","Record","String","orDie","serviceNameUnsafe","resource","serviceNameAttribute","find","attr","Error","unknownToAttributeValue","Array","isArray","arrayValue","values","map","intValue","Number","isInteger","doubleValue","boolValue"],"sources":["../../../src/unstable/observability/OtlpResource.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"OtlpResource.js","names":["Config","Effect","format","Schema","make","options","resourceAttributes","attributes","entriesToAttributes","Object","entries","push","key","value","stringValue","serviceName","serviceVersion","droppedAttributesCount","fromConfig","fnUntraced","schema","UndefinedOr","Record","String","orDie","serviceNameUnsafe","resource","serviceNameAttribute","find","attr","Error","unknownToAttributeValue","Array","isArray","arrayValue","values","map","intValue","Number","isInteger","doubleValue","boolValue"],"sources":["../../../src/unstable/observability/OtlpResource.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/unstable/observability/OtlpSerialization.d.ts

@@ -1,20 +1,31 @@
 /**
- * Defines the serialization boundary used by the OTLP observability layers.
- *
- * `OtlpSerialization` converts Effect's in-memory OTLP trace, metric, and log
- * data into `HttpBody` values so exporters can send them to collectors over
- * OTLP/HTTP. Use this module to choose between the JSON encoding that is useful
- * for debugging and collector endpoints that explicitly accept OTLP/HTTP JSON,
- * and the protobuf encoding commonly expected by production OpenTelemetry
- * collectors.
- *
- * The JSON layer writes the telemetry structures directly with
- * `HttpBody.jsonUnsafe`; the protobuf layer encodes the same structures with
- * the internal OTLP protobuf encoder and sets the `application/x-protobuf`
- * content type. Endpoint paths, authentication headers, batching, retries, and
- * shutdown flushing are handled by the OTLP exporter layers that consume this
- * service, while this module focuses only on preserving the wire format chosen
- * for traces, metrics, and logs.
+ * OTLP/HTTP serialization service shared by logs, metrics, and traces.
+ *
+ * This module decides how in-memory OTLP payloads become HTTP request bodies.
+ * The signal exporters build trace, metric, and log data structures, then call
+ * `OtlpSerialization` immediately before posting them to a collector.
+ *
+ * **Mental model**
+ *
+ * `OtlpSerialization` has one encoder per OTLP signal. `layerJson` writes the
+ * structures directly with `HttpBody.jsonUnsafe`, which is useful for debugging
+ * or endpoints that explicitly accept OTLP/HTTP JSON. `layerProtobuf` encodes
+ * the same structures with the internal OTLP protobuf encoder and sets the
+ * `application/x-protobuf` content type expected by many production collectors.
+ *
+ * **Common tasks**
+ *
+ * - Provide `layerProtobuf` for collectors that expect binary OTLP payloads.
+ * - Provide `layerJson` when inspecting payloads or using an OTLP/HTTP JSON
+ *   endpoint.
+ * - Provide a custom `OtlpSerialization` service only when an exporter needs a
+ *   non-standard body format.
+ *
+ * **Gotchas**
+ *
+ * This module only controls the wire format for traces, metrics, and logs.
+ * Endpoint paths, authentication headers, batching, retries, and shutdown
+ * flushing are handled by the OTLP exporter layers that consume the service.
  *
  * @since 4.0.0
  */

package/dist/unstable/observability/OtlpSerialization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OtlpSerialization.d.ts","sourceRoot":"","sources":["../../../src/unstable/observability/OtlpSerialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAE/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;;qBAU7B,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,QAAQ;sBACrC,CAAC,IAAI,EAAE,WAAW,KAAK,QAAQ,CAAC,QAAQ;mBAC3C,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC,QAAQ;;AAVtD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,sBAIO;CAAG;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,8CAIpB,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,8CAgBxB,CAAA"}
+{"version":3,"file":"OtlpSerialization.d.ts","sourceRoot":"","sources":["../../../src/unstable/observability/OtlpSerialization.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAA;AAC3C,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAA;AACvC,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAA;AAE/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;;qBAU7B,CAAC,IAAI,EAAE,SAAS,KAAK,QAAQ,CAAC,QAAQ;sBACrC,CAAC,IAAI,EAAE,WAAW,KAAK,QAAQ,CAAC,QAAQ;mBAC3C,CAAC,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC,QAAQ;;AAVtD;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,sBAIO;CAAG;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,SAAS,8CAIpB,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,8CAgBxB,CAAA"}

package/dist/unstable/observability/OtlpSerialization.js

@@ -1,20 +1,31 @@
 /**
- * Defines the serialization boundary used by the OTLP observability layers.
- *
- * `OtlpSerialization` converts Effect's in-memory OTLP trace, metric, and log
- * data into `HttpBody` values so exporters can send them to collectors over
- * OTLP/HTTP. Use this module to choose between the JSON encoding that is useful
- * for debugging and collector endpoints that explicitly accept OTLP/HTTP JSON,
- * and the protobuf encoding commonly expected by production OpenTelemetry
- * collectors.
- *
- * The JSON layer writes the telemetry structures directly with
- * `HttpBody.jsonUnsafe`; the protobuf layer encodes the same structures with
- * the internal OTLP protobuf encoder and sets the `application/x-protobuf`
- * content type. Endpoint paths, authentication headers, batching, retries, and
- * shutdown flushing are handled by the OTLP exporter layers that consume this
- * service, while this module focuses only on preserving the wire format chosen
- * for traces, metrics, and logs.
+ * OTLP/HTTP serialization service shared by logs, metrics, and traces.
+ *
+ * This module decides how in-memory OTLP payloads become HTTP request bodies.
+ * The signal exporters build trace, metric, and log data structures, then call
+ * `OtlpSerialization` immediately before posting them to a collector.
+ *
+ * **Mental model**
+ *
+ * `OtlpSerialization` has one encoder per OTLP signal. `layerJson` writes the
+ * structures directly with `HttpBody.jsonUnsafe`, which is useful for debugging
+ * or endpoints that explicitly accept OTLP/HTTP JSON. `layerProtobuf` encodes
+ * the same structures with the internal OTLP protobuf encoder and sets the
+ * `application/x-protobuf` content type expected by many production collectors.
+ *
+ * **Common tasks**
+ *
+ * - Provide `layerProtobuf` for collectors that expect binary OTLP payloads.
+ * - Provide `layerJson` when inspecting payloads or using an OTLP/HTTP JSON
+ *   endpoint.
+ * - Provide a custom `OtlpSerialization` service only when an exporter needs a
+ *   non-standard body format.
+ *
+ * **Gotchas**
+ *
+ * This module only controls the wire format for traces, metrics, and logs.
+ * Endpoint paths, authentication headers, batching, retries, and shutdown
+ * flushing are handled by the OTLP exporter layers that consume the service.
  *
  * @since 4.0.0
  */

package/dist/unstable/observability/OtlpSerialization.js.map

@@ -1 +1 @@
-{"version":3,"file":"OtlpSerialization.js","names":["Context","Layer","HttpBody","otlpProtobuf","OtlpSerialization","Service","layerJson","succeed","traces","spans","jsonUnsafe","metrics","logs","layerProtobuf","uint8Array","encodeTracesData","encodeMetricsData","encodeLogsData"],"sources":["../../../src/unstable/observability/OtlpSerialization.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;AAoBA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,QAAQ,MAAM,qBAAqB;AAC/C,OAAO,KAAKC,YAAY,MAAM,4BAA4B;AAK1D;;;;;;;AAOA,OAAM,MAAOC,iBAAkB,sBAAQJ,OAAO,CAACK,OAAO,EAIlD,CAAC,wCAAwC,CAAC;AAE9C;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAGL,KAAK,CAACM,OAAO,CAACH,iBAAiB,EAAE;EACxDI,MAAM,EAAGC,KAAK,IAAKP,QAAQ,CAACQ,UAAU,CAACD,KAAK,CAAC;EAC7CE,OAAO,EAAGA,OAAO,IAAKT,QAAQ,CAACQ,UAAU,CAACC,OAAO,CAAC;EAClDC,IAAI,EAAGA,IAAI,IAAKV,QAAQ,CAACQ,UAAU,CAACE,IAAI;CACzC,CAAC;AAEF;;;;;;;AAOA,OAAO,MAAMC,aAAa,gBAAGZ,KAAK,CAACM,OAAO,CAACH,iBAAiB,EAAE;EAC5DI,MAAM,EAAGC,KAAK,IACZP,QAAQ,CAACY,UAAU,CACjBX,YAAY,CAACY,gBAAgB,CAACN,KAAY,CAAC,EAC3C,wBAAwB,CACzB;EACHE,OAAO,EAAGA,OAAO,IACfT,QAAQ,CAACY,UAAU,CACjBX,YAAY,CAACa,iBAAiB,CAACL,OAAc,CAAC,EAC9C,wBAAwB,CACzB;EACHC,IAAI,EAAGA,IAAI,IACTV,QAAQ,CAACY,UAAU,CACjBX,YAAY,CAACc,cAAc,CAACL,IAAW,CAAC,EACxC,wBAAwB;CAE7B,CAAC","ignoreList":[]}
+{"version":3,"file":"OtlpSerialization.js","names":["Context","Layer","HttpBody","otlpProtobuf","OtlpSerialization","Service","layerJson","succeed","traces","spans","jsonUnsafe","metrics","logs","layerProtobuf","uint8Array","encodeTracesData","encodeMetricsData","encodeLogsData"],"sources":["../../../src/unstable/observability/OtlpSerialization.ts"],"sourcesContent":[null],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BA,OAAO,KAAKA,OAAO,MAAM,kBAAkB;AAC3C,OAAO,KAAKC,KAAK,MAAM,gBAAgB;AACvC,OAAO,KAAKC,QAAQ,MAAM,qBAAqB;AAC/C,OAAO,KAAKC,YAAY,MAAM,4BAA4B;AAK1D;;;;;;;AAOA,OAAM,MAAOC,iBAAkB,sBAAQJ,OAAO,CAACK,OAAO,EAIlD,CAAC,wCAAwC,CAAC;AAE9C;;;;;;AAMA,OAAO,MAAMC,SAAS,gBAAGL,KAAK,CAACM,OAAO,CAACH,iBAAiB,EAAE;EACxDI,MAAM,EAAGC,KAAK,IAAKP,QAAQ,CAACQ,UAAU,CAACD,KAAK,CAAC;EAC7CE,OAAO,EAAGA,OAAO,IAAKT,QAAQ,CAACQ,UAAU,CAACC,OAAO,CAAC;EAClDC,IAAI,EAAGA,IAAI,IAAKV,QAAQ,CAACQ,UAAU,CAACE,IAAI;CACzC,CAAC;AAEF;;;;;;;AAOA,OAAO,MAAMC,aAAa,gBAAGZ,KAAK,CAACM,OAAO,CAACH,iBAAiB,EAAE;EAC5DI,MAAM,EAAGC,KAAK,IACZP,QAAQ,CAACY,UAAU,CACjBX,YAAY,CAACY,gBAAgB,CAACN,KAAY,CAAC,EAC3C,wBAAwB,CACzB;EACHE,OAAO,EAAGA,OAAO,IACfT,QAAQ,CAACY,UAAU,CACjBX,YAAY,CAACa,iBAAiB,CAACL,OAAc,CAAC,EAC9C,wBAAwB,CACzB;EACHC,IAAI,EAAGA,IAAI,IACTV,QAAQ,CAACY,UAAU,CACjBX,YAAY,CAACc,cAAc,CAACL,IAAW,CAAC,EACxC,wBAAwB;CAE7B,CAAC","ignoreList":[]}

package/dist/unstable/observability/PrometheusMetrics.d.ts

@@ -95,7 +95,7 @@ export interface HttpOptions extends FormatOptions {
     readonly path?: HttpRouter.PathInput | undefined;
 }
 /**
- * Format all metrics in the registry to Prometheus exposition format.
+ * Formats all metrics in the registry to Prometheus exposition format.
  *
  * **Example** (Formatting metrics)
  *
@@ -127,11 +127,11 @@ export interface HttpOptions extends FormatOptions {
  */
 export declare const format: (options?: FormatOptions | undefined) => Effect.Effect<string>;
 /**
- * Synchronously format all metrics in the registry to Prometheus exposition format.
+ * Formats all metrics in the registry to Prometheus exposition format synchronously.
  *
  * **When to use**
  *
- * Use this low-level function when you already have access to the context. Most
+ * Use when you use this low-level function when you already have access to the context. Most
  * users should use `format` instead.
  *
  * @category Formatting

package/dist/unstable/observability/PrometheusMetrics.js

@@ -4,7 +4,7 @@ import * as Metric from "../../Metric.js";
 import * as HttpRouter from "../http/HttpRouter.js";
 import * as HttpServerResponse from "../http/HttpServerResponse.js";
 /**
- * Format all metrics in the registry to Prometheus exposition format.
+ * Formats all metrics in the registry to Prometheus exposition format.
  *
  * **Example** (Formatting metrics)
  *
@@ -39,11 +39,11 @@ export const format = /*#__PURE__*/Effect.fnUntraced(function* (options) {
   return formatUnsafe(services, options);
 });
 /**
- * Synchronously format all metrics in the registry to Prometheus exposition format.
+ * Formats all metrics in the registry to Prometheus exposition format synchronously.
  *
  * **When to use**
  *
- * Use this low-level function when you already have access to the context. Most
+ * Use when you use this low-level function when you already have access to the context. Most
  * users should use `format` instead.
  *
  * @category Formatting

package/dist/unstable/observability/index.d.ts

@@ -2,217 +2,34 @@
  * @since 4.0.0
  */
 /**
- * Convenience layers for exporting Effect logs, metrics, and traces over
- * OTLP/HTTP.
- *
- * This module wires the signal-specific OTLP logger, metrics, and tracer
- * exporters together so an application can install full observability with a
- * single layer. It is useful for services that report to an OpenTelemetry
- * Collector, vendor OTLP endpoint, or local collector during development
- * without configuring each signal independently.
- *
- * Pass `baseUrl` as the OTLP/HTTP root URL, such as `http://localhost:4318`;
- * this module appends `/v1/logs`, `/v1/metrics`, and `/v1/traces` itself.
- * Use `layerJson` or `layerProtobuf` when you want the serialization layer
- * provided for you, or use `layer` with a custom `OtlpSerialization`
- * implementation. Configure authentication with `headers`, provide resource
- * metadata explicitly or through the standard OTEL resource environment
- * variables, and tune batch size, export intervals, metric temporality, and
- * shutdown timeout for the target backend so buffered telemetry is accepted
- * and flushed before shutdown.
- *
  * @since 4.0.0
  */
 export * as Otlp from "./Otlp.ts";
 /**
- * Low-level OTLP/HTTP batch exporter used by the observability modules for
- * logs, metrics, and traces.
- *
- * This module owns the scoped transport loop for already-encoded telemetry
- * payloads: callers provide the OTLP endpoint, request headers, a body encoder,
- * and batching settings, then push records that should be delivered to a
- * collector. It is useful when implementing a concrete signal exporter, such
- * as the OTLP logger or tracer, or when wiring a snapshot-based exporter like
- * metrics into the same lifecycle and retry behavior.
- *
- * The exporter sends HTTP POST requests with the provided `HttpClient`, disables
- * tracer propagation for its own traffic, retries transient failures, and
- * honors numeric `retry-after` values on 429 responses. Exports run on
- * `exportInterval`, flush during scope finalization up to `shutdownTimeout`,
- * and can also be triggered early when the buffered item count reaches
- * `maxBatchSize`.
- *
- * Use `maxBatchSize: "disabled"` only for pull-style exporters whose `body`
- * callback builds a fresh payload without relying on drained buffered items,
- * because pushed data is not cleared in that mode. After an unrecovered export
- * failure the exporter drops the buffered batch and disables exporting for 60
- * seconds, so choose intervals, batch sizes, headers, and shutdown timeouts with
- * collector limits and process shutdown behavior in mind.
- *
  * @since 4.0.0
  */
 export * as OtlpExporter from "./OtlpExporter.ts";
 /**
- * Exports Effect log records to an OpenTelemetry Protocol (OTLP) logs endpoint.
- *
- * Use this module to send Effect log messages, annotations, fiber identifiers,
- * causes, and active span identifiers to an OpenTelemetry Collector or OTLP
- * compatible observability backend. `make` is useful for custom logger wiring,
- * while `layer` installs the logger for an application and can merge it with
- * any existing loggers.
- *
- * Records are buffered by the shared OTLP exporter. `exportInterval`,
- * `maxBatchSize`, and `shutdownTimeout` control periodic exports, early batch
- * flushes, and how long scope finalization waits for the final flush. Resource
- * options are attached to every export and override OpenTelemetry resource
- * environment variables, so ensure a `service.name` is available through the
- * options, `OTEL_RESOURCE_ATTRIBUTES`, or `OTEL_SERVICE_NAME`; use `headers`
- * for collector authentication and `excludeLogSpans` when log span duration
- * attributes would be too noisy.
- *
  * @since 4.0.0
  */
 export * as OtlpLogger from "./OtlpLogger.ts";
 /**
- * OTLP/HTTP metrics exporter for Effect's Metric system.
- *
- * This module periodically snapshots the metrics registered in the current
- * Effect context, serializes them as OTLP resource metrics, and posts them to a
- * metrics endpoint such as an OpenTelemetry Collector or vendor OTLP intake.
- * It is typically installed with `layer` in long-running services that already
- * update `Metric` counters, gauges, histograms, frequencies, or summaries and
- * need those values exported without adding instrumentation-specific plumbing
- * to the application code.
- *
- * Pass the concrete `/v1/metrics` endpoint to `make` or `layer`, or use the
- * higher-level `Otlp` module when you want `baseUrl` path construction for all
- * signals. The exporter requires an `HttpClient` and an `OtlpSerialization`
- * implementation, takes resource metadata from explicit options or standard
- * OTEL resource environment variables, and uses the resource `service.name` as
- * the instrumentation scope name. Choose `temporality` for the target backend:
- * cumulative is the default, while delta derives per-export changes from the
- * previous snapshot. Gauges always report their current value, and delta
- * histograms and summaries keep interval counts and sums from previous
- * snapshots, so tune export intervals and shutdown timeouts with backend
- * expectations and process shutdown behavior in mind.
- *
  * @since 4.0.0
  */
 export * as OtlpMetrics from "./OtlpMetrics.ts";
 /**
- * Helpers and data types for describing the OTLP resource attached to exported
- * logs, metrics, and traces.
- *
- * A resource identifies the service that produced telemetry and carries
- * process- or deployment-level attributes that should be shared across every
- * signal sent by the Effect OTLP logger, metrics exporter, and tracer. Use this
- * module when building explicit resource metadata, reading the standard OTEL
- * resource environment variables, or converting application metadata into OTLP
- * `KeyValue` / `AnyValue` shapes before serialization.
- *
- * `service.name` is required because the signal exporters also use it as the
- * instrumentation scope name. Explicit resource options take precedence over
- * `OTEL_RESOURCE_ATTRIBUTES`, `OTEL_SERVICE_NAME`, and
- * `OTEL_SERVICE_VERSION`; `service.name` and `service.version` are normalized
- * through the service metadata inputs and re-added as canonical OTLP
- * attributes rather than left in the custom attribute map. Attribute values are
- * converted to OTLP scalar or array values where possible, with unsupported
- * runtime values formatted as strings.
- *
  * @since 4.0.0
  */
 export * as OtlpResource from "./OtlpResource.ts";
 /**
- * Defines the serialization boundary used by the OTLP observability layers.
- *
- * `OtlpSerialization` converts Effect's in-memory OTLP trace, metric, and log
- * data into `HttpBody` values so exporters can send them to collectors over
- * OTLP/HTTP. Use this module to choose between the JSON encoding that is useful
- * for debugging and collector endpoints that explicitly accept OTLP/HTTP JSON,
- * and the protobuf encoding commonly expected by production OpenTelemetry
- * collectors.
- *
- * The JSON layer writes the telemetry structures directly with
- * `HttpBody.jsonUnsafe`; the protobuf layer encodes the same structures with
- * the internal OTLP protobuf encoder and sets the `application/x-protobuf`
- * content type. Endpoint paths, authentication headers, batching, retries, and
- * shutdown flushing are handled by the OTLP exporter layers that consume this
- * service, while this module focuses only on preserving the wire format chosen
- * for traces, metrics, and logs.
- *
  * @since 4.0.0
  */
 export * as OtlpSerialization from "./OtlpSerialization.ts";
 /**
- * Exports Effect spans to an OpenTelemetry Protocol (OTLP) traces endpoint.
- *
- * This module creates a `Tracer.Tracer` backed by the shared OTLP/HTTP batch
- * exporter, so Effect spans created with tracing APIs can be delivered to an
- * OpenTelemetry Collector, vendor OTLP intake, or local development collector.
- * Use `make` when you need to install the tracer manually, or `layer` when an
- * application should provide it through the Effect environment.
- *
- * Pass a concrete traces endpoint, typically `/v1/traces`, or use the
- * higher-level `Otlp` module when you want `baseUrl` path construction for all
- * observability signals. The tracer exports only ended sampled spans, converts
- * span attributes, events, links, status, parent identifiers, and failure
- * causes into OTLP trace data, and groups every batch under the configured
- * resource. Resource options are resolved through `OtlpResource`, so ensure a
- * stable `service.name` is available through options or standard OTEL resource
- * environment variables because it is also used as the instrumentation scope
- * name. Tune `exportInterval`, `maxBatchSize`, and `shutdownTimeout` for the
- * target backend and process shutdown behavior, provide `headers` for
- * authentication or routing, choose an `OtlpSerialization` layer accepted by
- * the endpoint, and use `context` only when a backend needs custom evaluation
- * around the active span.
- *
  * @since 4.0.0
  */
 export * as OtlpTracer from "./OtlpTracer.ts";
 /**
- * Prometheus metrics exporter for Effect's Metric system.
- *
- * This module snapshots the metrics registered in the current Effect context
- * and renders them in the Prometheus text exposition format. It is intended for
- * services that already record `Metric` counters, gauges, histograms,
- * frequencies, or summaries and need a pull-based `/metrics` endpoint, or for
- * integrations that want the formatted scrape body for a custom HTTP server.
- *
- * Use `format` when you need the current runtime's registry rendered as a
- * string, `formatUnsafe` when you already have the `Context`, and `layerHttp`
- * when an `HttpRouter` should serve `GET /metrics` directly. Formatting happens
- * at scrape time; the module does not push metrics, schedule exports, or start
- * an HTTP server on its own. Make sure the route is installed in the same
- * application context that records the metrics you want to expose.
- *
- * Metric and label names are sanitized for Prometheus, optional prefixes and
- * name mappers are applied before output, and metric attributes become labels.
- * Keep attributes low-cardinality, avoid relying on invalid characters being
- * preserved exactly, and configure Prometheus to scrape the route served by
- * `layerHttp` with the expected `text/plain; version=0.0.4` response.
- *
- * **Example** (Exporting Prometheus metrics)
- *
- * ```ts
- * import { Effect, Metric } from "effect"
- * import { PrometheusMetrics } from "effect/unstable/observability"
- *
- * const program = Effect.gen(function*() {
- *   // Create and update metrics
- *   const counter = Metric.counter("http_requests_total", {
- *     description: "Total HTTP requests"
- *   })
- *   yield* Metric.update(counter, 42)
- *
- *   // Format metrics for Prometheus
- *   const output = yield* PrometheusMetrics.format()
- *   console.log(output)
- *   // # HELP http_requests_total Total HTTP requests
- *   // # TYPE http_requests_total counter
- *   // http_requests_total 42
- * })
- * ```
- *
  * @since 4.0.0
  */
 export * as PrometheusMetrics from "./PrometheusMetrics.ts";

package/dist/unstable/observability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/observability/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/unstable/observability/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;GAEG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAA;AAE/C;;GAEG;AACH,OAAO,KAAK,YAAY,MAAM,mBAAmB,CAAA;AAEjD;;GAEG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA;AAE3D;;GAEG;AACH,OAAO,KAAK,UAAU,MAAM,iBAAiB,CAAA;AAE7C;;GAEG;AACH,OAAO,KAAK,iBAAiB,MAAM,wBAAwB,CAAA"}