@smthrs/observability 0.35.0 → 1.0.0-rc.13

package/dist/cjs/Resource.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Explicit, validated OpenTelemetry resource metadata for Smithers.
+ *
+ * @since 0.1.0
+ */
+import * as OtelResource from "@effect/opentelemetry/Resource";
+import type { Attributes as OtelAttributes } from "@opentelemetry/api";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Schema from "effect/Schema";
+/**
+ * Largest service-name or service-version field accepted by a resource.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumIdentityLength = 1024;
+/**
+ * Largest attribute key accepted by a resource.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumAttributeKeyLength = 1024;
+/**
+ * Largest string value accepted by one resource attribute.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumAttributeStringLength = 65536;
+/**
+ * Largest number of elements accepted in one array attribute value.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumAttributeArrayLength = 256;
+/**
+ * Largest number of attributes accepted by one resource.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumAttributes = 256;
+/**
+ * Largest OTLP/JSON encoding accepted for one whole resource, in UTF-8 bytes.
+ *
+ * The measure is the OTLP `Resource` message the exporters place in every
+ * request, `{"attributes":[{"key":…,"value":{…}}],"droppedAttributesCount":0}`
+ * with service identity and SDK-added `telemetry.sdk.name`,
+ * `telemetry.sdk.language` and `telemetry.sdk.version` included, after JSON
+ * escaping and UTF-8 encoding. The SDK's own values are reserved even for the
+ * default Effect exporter, whose values are shorter. A caller attribute that
+ * replaces an SDK field, or that service identity overwrites, is counted
+ * beside it. It is the bound the per-field limits cannot express: 256
+ * attributes at the string ceiling would encode to 16 MiB, and the resource
+ * rides in every export request, so the default transport, which discards a
+ * request over 1 MiB, would deliver nothing at all. 128 KiB admits one
+ * ASCII attribute at the string ceiling and leaves that transport 888 KiB of every
+ * request for the signal batch; see `Otlp.reservedBatchBytes`.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumResourceBytes = 131072;
+/**
+ * Runtime schema for one OpenTelemetry resource attribute value.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const AttributeValue: Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.$Array<Schema.String>, Schema.$Array<Schema.Number>, Schema.$Array<Schema.Boolean>]>;
+/**
+ * Runtime schema for OpenTelemetry resource attributes.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const Attributes: Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.$Array<Schema.String>, Schema.$Array<Schema.Number>, Schema.$Array<Schema.Boolean>]>>;
+/**
+ * Runtime schema for the service identity attached to exported telemetry.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const Configuration: Schema.Struct<{
+    readonly serviceName: Schema.NonEmptyString;
+    readonly serviceVersion: Schema.optional<Schema.NonEmptyString>;
+    readonly attributes: Schema.optional<Schema.$Record<Schema.String, Schema.Union<readonly [Schema.String, Schema.Number, Schema.Boolean, Schema.$Array<Schema.String>, Schema.$Array<Schema.Number>, Schema.$Array<Schema.Boolean>]>>>;
+}>;
+/**
+ * Configuration used to identify the service emitting telemetry.
+ *
+ * @category models
+ * @since 1.0.0-rc.0
+ */
+export type Configuration = typeof Configuration.Type;
+declare const InvalidResourceConfiguration_base: Schema.Class<InvalidResourceConfiguration, Schema.TaggedStruct<"@smthrs/observability/InvalidResourceConfiguration", {
+    readonly code: Schema.Literal<"invalid_resource_configuration">;
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Stable resource-configuration refusal shared by every OTEL layer.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export declare class InvalidResourceConfiguration extends InvalidResourceConfiguration_base {
+}
+/**
+ * Decodes one resource configuration without retaining rejected values.
+ *
+ * @category decoding
+ * @since 1.0.0-rc.0
+ */
+export declare const decode: (configuration: unknown) => Effect.Effect<Configuration, InvalidResourceConfiguration>;
+/**
+ * Decodes one resource configuration for the package's pure projection API.
+ *
+ * @category decoding
+ * @since 1.0.0-rc.0
+ */
+export declare const decodeSync: (configuration: unknown) => Configuration;
+/**
+ * Projects a decoded resource into the exact optional-property shape expected
+ * by the OpenTelemetry SDK.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export declare const toOpenTelemetryConfiguration: (configuration: Configuration) => {
+    readonly serviceName: string;
+    readonly serviceVersion?: string;
+    readonly attributes?: OtelAttributes;
+};
+/**
+ * Converts explicit service metadata into OpenTelemetry resource attributes.
+ *
+ * No environment variables are read. Invalid metadata throws the same typed
+ * {@link InvalidResourceConfiguration} every layer returns during acquisition.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export declare const configToAttributes: (configuration: Configuration) => OtelAttributes;
+/**
+ * Provides an explicitly validated OpenTelemetry resource.
+ *
+ * @category layers
+ * @since 1.0.0-rc.0
+ */
+export declare const layer: (configuration: Configuration) => Layer.Layer<OtelResource.Resource, InvalidResourceConfiguration>;
+/**
+ * The OpenTelemetry resource service.
+ *
+ * @category services
+ * @since 1.0.0-rc.0
+ */
+export declare const Resource: typeof OtelResource.Resource;
+export {};
+//# sourceMappingURL=Resource.d.ts.map

package/dist/cjs/Resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Resource.d.ts","sourceRoot":"","sources":["../../src/Resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,YAAY,MAAM,gCAAgC,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACtE,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAGvC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAQ,CAAA;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,OAAQ,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,QAAS,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAA;AAEpC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,SAAU,CAAA;AAqB3C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,kKAgB1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,iMAYtB,CAAA;AA0CD;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;EAqBzB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAA;;;;;;AAErD;;;;;GAKG;AACH,qBAAa,4BAA6B,SAAQ,iCAOjD;CAAG;AAWJ;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GACjB,eAAe,OAAO,KACrB,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,4BAA4B,CAC6B,CAAA;AAEzF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,eAAe,OAAO,KAAG,aAMnD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,GACvC,eAAe,aAAa,KAC3B;IACD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAA;CAcpC,CAAA;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,eAAe,aAAa,KAAG,cACwB,CAAA;AAE1F;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAChB,eAAe,aAAa,KAC3B,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,4BAA4B,CAG/D,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,8BAAwB,CAAA"}

package/dist/cjs/Resource.js

@@ -0,0 +1,186 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Resource_exports = {};
+__export(Resource_exports, {
+  AttributeValue: () => AttributeValue,
+  Attributes: () => Attributes,
+  Configuration: () => Configuration,
+  InvalidResourceConfiguration: () => InvalidResourceConfiguration,
+  Resource: () => Resource,
+  configToAttributes: () => configToAttributes,
+  decode: () => decode,
+  decodeSync: () => decodeSync,
+  layer: () => layer,
+  maximumAttributeArrayLength: () => maximumAttributeArrayLength,
+  maximumAttributeKeyLength: () => maximumAttributeKeyLength,
+  maximumAttributeStringLength: () => maximumAttributeStringLength,
+  maximumAttributes: () => maximumAttributes,
+  maximumIdentityLength: () => maximumIdentityLength,
+  maximumResourceBytes: () => maximumResourceBytes,
+  toOpenTelemetryConfiguration: () => toOpenTelemetryConfiguration
+});
+module.exports = __toCommonJS(Resource_exports);
+var OtelResource = __toESM(require("@effect/opentelemetry/Resource"), 1);
+var Effect = __toESM(require("effect/Effect"), 1);
+var Layer = __toESM(require("effect/Layer"), 1);
+var OtlpResource = __toESM(require("effect/observability/OtlpResource"), 1);
+var Schema = __toESM(require("effect/Schema"), 1);
+var import_schemaIssuePath = require("./internal/schemaIssuePath.js");
+const maximumIdentityLength = 1024;
+const maximumAttributeKeyLength = 1024;
+const maximumAttributeStringLength = 65536;
+const maximumAttributeArrayLength = 256;
+const maximumAttributes = 256;
+const maximumResourceBytes = 131072;
+const loneSurrogate = /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/;
+const embeddedNul = new RegExp(String.fromCharCode(0));
+const isWellFormed = (value) => !loneSurrogate.test(value) && !embeddedNul.test(value);
+const identity = Schema.NonEmptyString.check(
+  Schema.isMaxLength(maximumIdentityLength),
+  Schema.makeFilter((value) => isWellFormed(value), { title: "wellFormedResourceIdentity" })
+);
+const attributeString = Schema.String.check(
+  Schema.isMaxLength(maximumAttributeStringLength),
+  Schema.makeFilter((value) => isWellFormed(value), { title: "wellFormedAttributeString" })
+);
+const attributeNumber = Schema.Number.check(
+  Schema.makeFilter((value) => Number.isFinite(value), { title: "finiteAttributeNumber" })
+);
+const AttributeValue = Schema.Union([
+  attributeString,
+  attributeNumber,
+  Schema.Boolean,
+  Schema.Array(attributeString),
+  Schema.Array(attributeNumber),
+  Schema.Array(Schema.Boolean)
+]).check(
+  Schema.makeFilter(
+    (value) => !Array.isArray(value) || value.length <= maximumAttributeArrayLength || {
+      path: [],
+      issue: `holds ${value.length} elements, over the ${maximumAttributeArrayLength} element limit`
+    },
+    { title: "boundedResourceAttributeArrays" }
+  )
+);
+const Attributes = Schema.Record(Schema.String, AttributeValue).check(
+  Schema.makeFilter(
+    (attributes) => Object.keys(attributes).length <= maximumAttributes,
+    { title: "boundedResourceAttributes" }
+  ),
+  Schema.makeFilter(
+    (attributes) => Object.keys(attributes).every(
+      (key) => key.length > 0 && key.length <= maximumAttributeKeyLength && isWellFormed(key)
+    ),
+    { title: "wellFormedResourceAttributeKeys" }
+  )
+);
+const encoder = new TextEncoder();
+const encodedResourceBytes = (configuration) => {
+  const bytes = (value) => encoder.encode(JSON.stringify(value)).byteLength;
+  const identityAttributes = OtelResource.configToAttributes({
+    serviceName: configuration.serviceName,
+    ...configuration.serviceVersion === void 0 ? {} : { serviceVersion: configuration.serviceVersion }
+  });
+  let total = bytes({
+    attributes: OtlpResource.entriesToAttributes(Object.entries(identityAttributes)),
+    droppedAttributesCount: 0
+  });
+  for (const [key, value] of Object.entries(configuration.attributes ?? {})) {
+    total += 1 + bytes({ key, value: Array.isArray(value) ? { arrayValue: { values: [] } } : null });
+    if (Array.isArray(value)) {
+      for (const [index, element] of value.entries()) {
+        total += (index === 0 ? 0 : 1) + bytes(OtlpResource.unknownToAttributeValue(element));
+        if (total > maximumResourceBytes) return total;
+      }
+    } else {
+      total += bytes(OtlpResource.unknownToAttributeValue(value)) - 4;
+    }
+    if (total > maximumResourceBytes) return total;
+  }
+  return total;
+};
+const Configuration = Schema.Struct({
+  serviceName: identity,
+  serviceVersion: Schema.optional(identity),
+  attributes: Schema.optional(Attributes)
+}).check(
+  Schema.makeFilter(
+    (configuration) => {
+      const bytes = encodedResourceBytes(configuration);
+      return bytes <= maximumResourceBytes || {
+        path: ["attributes"],
+        issue: `bring the resource to at least ${bytes} bytes of OTLP JSON, over the ${maximumResourceBytes} byte limit`
+      };
+    },
+    { title: "boundedResourceBytes" }
+  )
+);
+class InvalidResourceConfiguration extends Schema.TaggedError()(
+  "@smthrs/observability/InvalidResourceConfiguration",
+  {
+    code: Schema.Literal("invalid_resource_configuration"),
+    path: Schema.String,
+    message: Schema.String
+  }
+) {
+}
+const invalid = (cause) => {
+  const path = (0, import_schemaIssuePath.schemaIssuePath)(cause, "resource");
+  return new InvalidResourceConfiguration({
+    code: "invalid_resource_configuration",
+    path,
+    message: `OpenTelemetry resource ${path} ${(0, import_schemaIssuePath.schemaIssueMessage)(cause) ?? "is invalid"}`
+  });
+};
+const decode = (configuration) => Schema.decodeUnknownEffect(Configuration)(configuration).pipe(Effect.mapError(invalid));
+const decodeSync = (configuration) => {
+  try {
+    return Schema.decodeUnknownSync(Configuration)(configuration);
+  } catch (cause) {
+    throw invalid(cause);
+  }
+};
+const toOpenTelemetryConfiguration = (configuration) => ({
+  serviceName: configuration.serviceName,
+  ...configuration.serviceVersion === void 0 ? {} : { serviceVersion: configuration.serviceVersion },
+  ...configuration.attributes === void 0 ? {} : {
+    attributes: Object.fromEntries(
+      Object.entries(configuration.attributes).map(([key, value]) => [
+        key,
+        Array.isArray(value) ? [...value] : value
+      ])
+    )
+  }
+});
+const configToAttributes = (configuration) => OtelResource.configToAttributes(toOpenTelemetryConfiguration(decodeSync(configuration)));
+const layer = (configuration) => Layer.unwrap(
+  Effect.map(decode(configuration), (decoded) => OtelResource.layer(toOpenTelemetryConfiguration(decoded)))
+);
+const Resource = OtelResource.Resource;
+//# sourceMappingURL=Resource.js.map

package/dist/cjs/Resource.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/Resource.ts"],
+  "sourcesContent": ["/**\n * Explicit, validated OpenTelemetry resource metadata for Smithers.\n *\n * @since 0.1.0\n */\n\nimport * as OtelResource from \"@effect/opentelemetry/Resource\"\nimport type { Attributes as OtelAttributes } from \"@opentelemetry/api\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport * as OtlpResource from \"effect/observability/OtlpResource\"\nimport * as Schema from \"effect/Schema\"\nimport { schemaIssueMessage, schemaIssuePath } from \"./internal/schemaIssuePath.ts\"\n\n/**\n * Largest service-name or service-version field accepted by a resource.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumIdentityLength = 1_024\n\n/**\n * Largest attribute key accepted by a resource.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumAttributeKeyLength = 1_024\n\n/**\n * Largest string value accepted by one resource attribute.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumAttributeStringLength = 65_536\n\n/**\n * Largest number of elements accepted in one array attribute value.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumAttributeArrayLength = 256\n\n/**\n * Largest number of attributes accepted by one resource.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumAttributes = 256\n\n/**\n * Largest OTLP/JSON encoding accepted for one whole resource, in UTF-8 bytes.\n *\n * The measure is the OTLP `Resource` message the exporters place in every\n * request, `{\"attributes\":[{\"key\":\u2026,\"value\":{\u2026}}],\"droppedAttributesCount\":0}`\n * with service identity and SDK-added `telemetry.sdk.name`,\n * `telemetry.sdk.language` and `telemetry.sdk.version` included, after JSON\n * escaping and UTF-8 encoding. The SDK's own values are reserved even for the\n * default Effect exporter, whose values are shorter. A caller attribute that\n * replaces an SDK field, or that service identity overwrites, is counted\n * beside it. It is the bound the per-field limits cannot express: 256\n * attributes at the string ceiling would encode to 16 MiB, and the resource\n * rides in every export request, so the default transport, which discards a\n * request over 1 MiB, would deliver nothing at all. 128 KiB admits one\n * ASCII attribute at the string ceiling and leaves that transport 888 KiB of every\n * request for the signal batch; see `Otlp.reservedBatchBytes`.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumResourceBytes = 131_072\n\nconst loneSurrogate = /[\\uD800-\\uDBFF](?![\\uDC00-\\uDFFF])|(?<![\\uD800-\\uDBFF])[\\uDC00-\\uDFFF]/\nconst embeddedNul = new RegExp(String.fromCharCode(0))\n\nconst isWellFormed = (value: string): boolean => !loneSurrogate.test(value) && !embeddedNul.test(value)\n\nconst identity = Schema.NonEmptyString.check(\n  Schema.isMaxLength(maximumIdentityLength),\n  Schema.makeFilter((value: string) => isWellFormed(value), { title: \"wellFormedResourceIdentity\" })\n)\n\nconst attributeString = Schema.String.check(\n  Schema.isMaxLength(maximumAttributeStringLength),\n  Schema.makeFilter((value: string) => isWellFormed(value), { title: \"wellFormedAttributeString\" })\n)\n\nconst attributeNumber = Schema.Number.check(\n  Schema.makeFilter((value: number) => Number.isFinite(value), { title: \"finiteAttributeNumber\" })\n)\n\n/**\n * Runtime schema for one OpenTelemetry resource attribute value.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const AttributeValue = Schema.Union([\n  attributeString,\n  attributeNumber,\n  Schema.Boolean,\n  Schema.Array(attributeString),\n  Schema.Array(attributeNumber),\n  Schema.Array(Schema.Boolean)\n]).check(\n  Schema.makeFilter(\n    (value) =>\n      !Array.isArray(value) || value.length <= maximumAttributeArrayLength || {\n        path: [],\n        issue: `holds ${value.length} elements, over the ${maximumAttributeArrayLength} element limit`\n      },\n    { title: \"boundedResourceAttributeArrays\" }\n  )\n)\n\n/**\n * Runtime schema for OpenTelemetry resource attributes.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const Attributes = Schema.Record(Schema.String, AttributeValue).check(\n  Schema.makeFilter(\n    (attributes: Readonly<Record<string, unknown>>) => Object.keys(attributes).length <= maximumAttributes,\n    { title: \"boundedResourceAttributes\" }\n  ),\n  Schema.makeFilter(\n    (attributes: Readonly<Record<string, unknown>>) =>\n      Object.keys(attributes).every(\n        (key) => key.length > 0 && key.length <= maximumAttributeKeyLength && isWellFormed(key)\n      ),\n    { title: \"wellFormedResourceAttributeKeys\" }\n  )\n)\n\nconst encoder = new TextEncoder()\n\n/**\n * Counts OTLP JSON fragments, including keys, wrappers, escaping and UTF-8.\n * Stops at the first fragment over budget: the refusal reports a lower bound.\n * A configuration may reuse one large string in thousands of array slots, so\n * serializing the whole resource before checking could allocate gigabytes.\n */\nconst encodedResourceBytes = (configuration: {\n  readonly serviceName: string\n  readonly serviceVersion?: string | undefined\n  readonly attributes?: Record<string, unknown> | undefined\n}): number => {\n  const bytes = (value: unknown) => encoder.encode(JSON.stringify(value)).byteLength\n  const identityAttributes = OtelResource.configToAttributes({\n    serviceName: configuration.serviceName,\n    ...(configuration.serviceVersion === undefined ? {} : { serviceVersion: configuration.serviceVersion })\n  })\n  // Use the pinned SDK projection so its added metadata cannot escape the\n  // complete-resource ceiling. Both exporters use these OTLP AnyValue shapes.\n  let total = bytes({\n    attributes: OtlpResource.entriesToAttributes(Object.entries(identityAttributes)),\n    droppedAttributesCount: 0\n  })\n  for (const [key, value] of Object.entries(configuration.attributes ?? {})) {\n    // An identity attribute is always present, so every addition needs a comma.\n    total += 1 + bytes({ key, value: Array.isArray(value) ? { arrayValue: { values: [] } } : null })\n    if (Array.isArray(value)) {\n      for (const [index, element] of value.entries()) {\n        total += (index === 0 ? 0 : 1) + bytes(OtlpResource.unknownToAttributeValue(element))\n        if (total > maximumResourceBytes) return total\n      }\n    } else {\n      total += bytes(OtlpResource.unknownToAttributeValue(value)) - 4 // replace JSON null\n    }\n    if (total > maximumResourceBytes) return total\n  }\n  return total\n}\n\n/**\n * Runtime schema for the service identity attached to exported telemetry.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const Configuration = Schema.Struct({\n  serviceName: identity,\n  serviceVersion: Schema.optional(identity),\n  attributes: Schema.optional(Attributes)\n}).check(\n  Schema.makeFilter(\n    (configuration: {\n      readonly serviceName: string\n      readonly serviceVersion?: string | undefined\n      readonly attributes?: Record<string, unknown> | undefined\n    }) => {\n      const bytes = encodedResourceBytes(configuration)\n      // Only attributes can carry a resource past the budget: the two identity\n      // fields encode to at most 6 KiB each, so the refusal points there.\n      return bytes <= maximumResourceBytes || {\n        path: [\"attributes\"],\n        issue: `bring the resource to at least ${bytes} bytes of OTLP JSON, over the ${maximumResourceBytes} byte limit`\n      }\n    },\n    { title: \"boundedResourceBytes\" }\n  )\n)\n\n/**\n * Configuration used to identify the service emitting telemetry.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type Configuration = typeof Configuration.Type\n\n/**\n * Stable resource-configuration refusal shared by every OTEL layer.\n *\n * @category errors\n * @since 1.0.0-rc.0\n */\nexport class InvalidResourceConfiguration extends Schema.TaggedError<InvalidResourceConfiguration>()(\n  \"@smthrs/observability/InvalidResourceConfiguration\",\n  {\n    code: Schema.Literal(\"invalid_resource_configuration\"),\n    path: Schema.String,\n    message: Schema.String\n  }\n) {}\n\nconst invalid = (cause: unknown): InvalidResourceConfiguration => {\n  const path = schemaIssuePath(cause, \"resource\")\n  return new InvalidResourceConfiguration({\n    code: \"invalid_resource_configuration\",\n    path,\n    message: `OpenTelemetry resource ${path} ${schemaIssueMessage(cause) ?? \"is invalid\"}`\n  })\n}\n\n/**\n * Decodes one resource configuration without retaining rejected values.\n *\n * @category decoding\n * @since 1.0.0-rc.0\n */\nexport const decode = (\n  configuration: unknown\n): Effect.Effect<Configuration, InvalidResourceConfiguration> =>\n  Schema.decodeUnknownEffect(Configuration)(configuration).pipe(Effect.mapError(invalid))\n\n/**\n * Decodes one resource configuration for the package's pure projection API.\n *\n * @category decoding\n * @since 1.0.0-rc.0\n */\nexport const decodeSync = (configuration: unknown): Configuration => {\n  try {\n    return Schema.decodeUnknownSync(Configuration)(configuration)\n  } catch (cause) {\n    throw invalid(cause)\n  }\n}\n\n/**\n * Projects a decoded resource into the exact optional-property shape expected\n * by the OpenTelemetry SDK.\n *\n * @category conversions\n * @since 1.0.0-rc.0\n */\nexport const toOpenTelemetryConfiguration = (\n  configuration: Configuration\n): {\n  readonly serviceName: string\n  readonly serviceVersion?: string\n  readonly attributes?: OtelAttributes\n} => ({\n  serviceName: configuration.serviceName,\n  ...(configuration.serviceVersion === undefined ? {} : { serviceVersion: configuration.serviceVersion }),\n  ...(configuration.attributes === undefined\n    ? {}\n    : {\n      attributes: Object.fromEntries(\n        Object.entries(configuration.attributes).map(([key, value]) => [\n          key,\n          Array.isArray(value) ? [...value] : value\n        ])\n      ) as OtelAttributes\n    })\n})\n\n/**\n * Converts explicit service metadata into OpenTelemetry resource attributes.\n *\n * No environment variables are read. Invalid metadata throws the same typed\n * {@link InvalidResourceConfiguration} every layer returns during acquisition.\n *\n * @category conversions\n * @since 1.0.0-rc.0\n */\nexport const configToAttributes = (configuration: Configuration): OtelAttributes =>\n  OtelResource.configToAttributes(toOpenTelemetryConfiguration(decodeSync(configuration)))\n\n/**\n * Provides an explicitly validated OpenTelemetry resource.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layer = (\n  configuration: Configuration\n): Layer.Layer<OtelResource.Resource, InvalidResourceConfiguration> =>\n  Layer.unwrap(\n    Effect.map(decode(configuration), (decoded) => OtelResource.layer(toOpenTelemetryConfiguration(decoded)))\n  )\n\n/**\n * The OpenTelemetry resource service.\n *\n * @category services\n * @since 1.0.0-rc.0\n */\nexport const Resource = OtelResource.Resource\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Observability for flows: the default OTLP export wiring plus the
+ * Effect-native logger, metric, and OpenTelemetry resource layers.
+ *
+ * The store packages define and update their own metric handles
+ * (`JournalMetrics`, `RunStoreMetrics`, `CacheStoreMetrics`,
+ * `ArtifactStoreMetrics`, `DatabaseMetrics`) and open spans through Effect's
+ * tracer; this package is the exporter they deliberately leave out. `Otlp`
+ * only composes what `effect` already ships, so it is browser-bundleable. The
+ * remaining modules are the fuller stack folded in from the agent workspace:
+ * a structured `Logger`, a `JournalLogger` that mirrors log events into the
+ * run journal, `Metric` helpers, the `Resource` descriptor, and the `Otel`
+ * layer the OpenTelemetry SDK wiring installs behind.
+ *
+ * `NodeOtel` and `BrowserOtel` are deliberately NOT re-exported here. Each
+ * resolves a host-specific OpenTelemetry SDK. `NodeOtel` reaches Node-only
+ * host modules through `@effect/opentelemetry/NodeSdk` and
+ * `@opentelemetry/sdk-trace-node`, including the bare `async_hooks` specifier
+ * `@opentelemetry/context-async-hooks` imports, so re-exporting it would put a
+ * module a browser bundler cannot resolve in the root entry and break the
+ * browser bundle this package guarantees. Import them by subpath instead:
+ * `@smthrs/observability/NodeOtel`.
+ *
+ * @since 0.1.0
+ */
+/**
+ * @category layers
+ * @since 0.1.0
+ */
+export * as Otlp from "./Otlp.ts";
+/**
+ * @category observability
+ * @since 1.0.0-rc.0
+ */
+export * as Endpoint from "./Endpoint.ts";
+/**
+ * @category observability
+ * @since 0.1.0
+ */
+export * as JournalLogger from "./JournalLogger.ts";
+/**
+ * @category observability
+ * @since 0.1.0
+ */
+export * as Logger from "./Logger.ts";
+/**
+ * @category observability
+ * @since 0.1.0
+ */
+export * as Metric from "./Metric.ts";
+/**
+ * @category observability
+ * @since 0.1.0
+ */
+export * as Otel from "./Otel.ts";
+/**
+ * @category observability
+ * @since 0.1.0
+ */
+export * as Resource from "./Resource.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAEzC;;;GAGG;AACH,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAA;AAEnD;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAErC;;;GAGG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC;;;GAGG;AACH,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,47 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  Endpoint: () => Endpoint,
+  JournalLogger: () => JournalLogger,
+  Logger: () => Logger,
+  Metric: () => Metric,
+  Otel: () => Otel,
+  Otlp: () => Otlp,
+  Resource: () => Resource
+});
+module.exports = __toCommonJS(index_exports);
+var Otlp = __toESM(require("./Otlp.js"), 1);
+var Endpoint = __toESM(require("./Endpoint.js"), 1);
+var JournalLogger = __toESM(require("./JournalLogger.js"), 1);
+var Logger = __toESM(require("./Logger.js"), 1);
+var Metric = __toESM(require("./Metric.js"), 1);
+var Otel = __toESM(require("./Otel.js"), 1);
+var Resource = __toESM(require("./Resource.js"), 1);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "sourcesContent": ["/**\n * Observability for flows: the default OTLP export wiring plus the\n * Effect-native logger, metric, and OpenTelemetry resource layers.\n *\n * The store packages define and update their own metric handles\n * (`JournalMetrics`, `RunStoreMetrics`, `CacheStoreMetrics`,\n * `ArtifactStoreMetrics`, `DatabaseMetrics`) and open spans through Effect's\n * tracer; this package is the exporter they deliberately leave out. `Otlp`\n * only composes what `effect` already ships, so it is browser-bundleable. The\n * remaining modules are the fuller stack folded in from the agent workspace:\n * a structured `Logger`, a `JournalLogger` that mirrors log events into the\n * run journal, `Metric` helpers, the `Resource` descriptor, and the `Otel`\n * layer the OpenTelemetry SDK wiring installs behind.\n *\n * `NodeOtel` and `BrowserOtel` are deliberately NOT re-exported here. Each\n * resolves a host-specific OpenTelemetry SDK. `NodeOtel` reaches Node-only\n * host modules through `@effect/opentelemetry/NodeSdk` and\n * `@opentelemetry/sdk-trace-node`, including the bare `async_hooks` specifier\n * `@opentelemetry/context-async-hooks` imports, so re-exporting it would put a\n * module a browser bundler cannot resolve in the root entry and break the\n * browser bundle this package guarantees. Import them by subpath instead:\n * `@smthrs/observability/NodeOtel`.\n *\n * @since 0.1.0\n */\n\n/**\n * @category layers\n * @since 0.1.0\n */\nexport * as Otlp from \"./Otlp.ts\"\n\n/**\n * @category observability\n * @since 1.0.0-rc.0\n */\nexport * as Endpoint from \"./Endpoint.ts\"\n\n/**\n * @category observability\n * @since 0.1.0\n */\nexport * as JournalLogger from \"./JournalLogger.ts\"\n\n/**\n * @category observability\n * @since 0.1.0\n */\nexport * as Logger from \"./Logger.ts\"\n\n/**\n * @category observability\n * @since 0.1.0\n */\nexport * as Metric from \"./Metric.ts\"\n\n/**\n * @category observability\n * @since 0.1.0\n */\nexport * as Otel from \"./Otel.ts\"\n\n/**\n * @category observability\n * @since 0.1.0\n */\nexport * as Resource from \"./Resource.ts\"\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BA,WAAsB;AAMtB,eAA0B;AAM1B,oBAA+B;AAM/B,aAAwB;AAMxB,aAAwB;AAMxB,WAAsB;AAMtB,eAA0B;",
+  "names": []
+}

package/dist/cjs/internal/schemaIssuePath.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The decoder-issue walk shared by this package's refusals.
+ *
+ * `JournalLogger` and `Resource` both publish the path of the option a decode
+ * rejected, and `Resource` also publishes the measured size a budget filter
+ * attached to its refusal. Effect's issues nest the same way for both, so the
+ * traversal lives once and a decoder change is followed once.
+ *
+ * @private
+ * @since 1.0.0-rc.0
+ */
+/**
+ * Walks a decode failure to the dotted path of the value it refused.
+ *
+ * Returns the caller's domain name when the failure carries no path at all.
+ *
+ * @private
+ * @since 1.0.0-rc.0
+ */
+export declare const schemaIssuePath: (error: unknown, fallback: string) => string;
+/**
+ * Reads the message a filter attached to the value a decode refused, when the
+ * filter attached one. None of the Effect checks this package composes attach
+ * one, so a refusal only ever carries text this package wrote, never the
+ * rejected value.
+ *
+ * @private
+ * @since 1.0.0-rc.0
+ */
+export declare const schemaIssueMessage: (error: unknown) => string | undefined;
+//# sourceMappingURL=schemaIssuePath.d.ts.map

package/dist/cjs/internal/schemaIssuePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemaIssuePath.d.ts","sourceRoot":"","sources":["../../../src/internal/schemaIssuePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+BH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,UAAU,MAAM,KAAG,MAAoD,CAAA;AAEvH;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAI5D,CAAA"}

package/dist/cjs/internal/schemaIssuePath.js

@@ -0,0 +1,49 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var schemaIssuePath_exports = {};
+__export(schemaIssuePath_exports, {
+  schemaIssueMessage: () => schemaIssueMessage,
+  schemaIssuePath: () => schemaIssuePath
+});
+module.exports = __toCommonJS(schemaIssuePath_exports);
+const walk = (error) => {
+  let issue = error?.issue;
+  const segments = [];
+  for (let depth = 0; depth < 64 && typeof issue === "object" && issue !== null; depth++) {
+    const node = issue;
+    if (Array.isArray(node.path)) segments.push(...node.path.map(String));
+    if (node.issue !== void 0) {
+      issue = node.issue;
+      continue;
+    }
+    if (Array.isArray(node.issues) && node.issues[0] !== void 0) {
+      issue = node.issues[0];
+      continue;
+    }
+    break;
+  }
+  return { segments, leaf: issue };
+};
+const schemaIssuePath = (error, fallback) => walk(error).segments.join(".") || fallback;
+const schemaIssueMessage = (error) => {
+  const leaf = walk(error).leaf;
+  const message = leaf?.annotations?.message;
+  return typeof message === "string" ? message : void 0;
+};
+//# sourceMappingURL=schemaIssuePath.js.map

package/dist/cjs/internal/schemaIssuePath.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/internal/schemaIssuePath.ts"],
+  "sourcesContent": ["/**\n * The decoder-issue walk shared by this package's refusals.\n *\n * `JournalLogger` and `Resource` both publish the path of the option a decode\n * rejected, and `Resource` also publishes the measured size a budget filter\n * attached to its refusal. Effect's issues nest the same way for both, so the\n * traversal lives once and a decoder change is followed once.\n *\n * @private\n * @since 1.0.0-rc.0\n */\n\ninterface IssueLeaf {\n  readonly segments: ReadonlyArray<string>\n  readonly leaf: unknown\n}\n\n/**\n * Walks a decode failure to its first offending leaf, collecting the path\n * segments passed on the way. The walk is bounded so a self-referential issue\n * tree cannot spin.\n */\nconst walk = (error: unknown): IssueLeaf => {\n  let issue = (error as { readonly issue?: unknown } | null)?.issue\n  const segments: Array<string> = []\n  for (let depth = 0; depth < 64 && typeof issue === \"object\" && issue !== null; depth++) {\n    const node = issue as { readonly path?: unknown; readonly issue?: unknown; readonly issues?: unknown }\n    if (Array.isArray(node.path)) segments.push(...node.path.map(String))\n    if (node.issue !== undefined) {\n      issue = node.issue\n      continue\n    }\n    if (Array.isArray(node.issues) && node.issues[0] !== undefined) {\n      issue = node.issues[0]\n      continue\n    }\n    break\n  }\n  return { segments, leaf: issue }\n}\n\n/**\n * Walks a decode failure to the dotted path of the value it refused.\n *\n * Returns the caller's domain name when the failure carries no path at all.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const schemaIssuePath = (error: unknown, fallback: string): string => walk(error).segments.join(\".\") || fallback\n\n/**\n * Reads the message a filter attached to the value a decode refused, when the\n * filter attached one. None of the Effect checks this package composes attach\n * one, so a refusal only ever carries text this package wrote, never the\n * rejected value.\n *\n * @private\n * @since 1.0.0-rc.0\n */\nexport const schemaIssueMessage = (error: unknown): string | undefined => {\n  const leaf = walk(error).leaf as { readonly annotations?: { readonly message?: unknown } } | null | undefined\n  const message = leaf?.annotations?.message\n  return typeof message === \"string\" ? message : undefined\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAsBA,MAAM,OAAO,CAAC,UAA8B;AAC1C,MAAI,QAAS,OAA+C;AAC5D,QAAM,WAA0B,CAAC;AACjC,WAAS,QAAQ,GAAG,QAAQ,MAAM,OAAO,UAAU,YAAY,UAAU,MAAM,SAAS;AACtF,UAAM,OAAO;AACb,QAAI,MAAM,QAAQ,KAAK,IAAI,EAAG,UAAS,KAAK,GAAG,KAAK,KAAK,IAAI,MAAM,CAAC;AACpE,QAAI,KAAK,UAAU,QAAW;AAC5B,cAAQ,KAAK;AACb;AAAA,IACF;AACA,QAAI,MAAM,QAAQ,KAAK,MAAM,KAAK,KAAK,OAAO,CAAC,MAAM,QAAW;AAC9D,cAAQ,KAAK,OAAO,CAAC;AACrB;AAAA,IACF;AACA;AAAA,EACF;AACA,SAAO,EAAE,UAAU,MAAM,MAAM;AACjC;AAUO,MAAM,kBAAkB,CAAC,OAAgB,aAA6B,KAAK,KAAK,EAAE,SAAS,KAAK,GAAG,KAAK;AAWxG,MAAM,qBAAqB,CAAC,UAAuC;AACxE,QAAM,OAAO,KAAK,KAAK,EAAE;AACzB,QAAM,UAAU,MAAM,aAAa;AACnC,SAAO,OAAO,YAAY,WAAW,UAAU;AACjD;",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/esm/BrowserOtel.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Browser OpenTelemetry setup with explicitly injected providers/readers.
+ *
+ * @since 0.1.0
+ */
+import type { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import type { MetricReader } from "@opentelemetry/sdk-metrics";
+import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import * as Layer from "effect/Layer";
+import * as Resource from "./Resource.ts";
+import type { Configuration as ResourceConfiguration } from "./Resource.ts";
+/**
+ * Browser OTEL layer options. Processors and readers are created by the
+ * caller's factories, which keeps this module free of Node imports and browser
+ * exporter policy. Every factory is owned: it runs once during layer
+ * acquisition, after resource validation, and the layer scope shuts down
+ * everything it returned. An empty array installs nothing for that signal.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export interface Options {
+    readonly resource: ResourceConfiguration;
+    readonly spanProcessor?: (() => SpanProcessor | ReadonlyArray<SpanProcessor>) | undefined;
+    readonly logRecordProcessor?: (() => LogRecordProcessor | ReadonlyArray<LogRecordProcessor>) | undefined;
+    readonly metricReader?: (() => MetricReader | ReadonlyArray<MetricReader>) | undefined;
+    readonly loggerMergeWithExisting?: boolean | undefined;
+}
+/**
+ * Builds a scoped browser OpenTelemetry layer. The web SDK owns every
+ * processor and reader the factories return and shuts them down on release.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export declare const layerOtel: (options: Options) => Layer.Layer<never, Resource.InvalidResourceConfiguration>;
+//# sourceMappingURL=BrowserOtel.d.ts.map