@smthrs/observability 0.35.0 → 1.0.0-rc.4

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 Schema from \"effect/Schema\"\nimport * as OtlpResource from \"effect/unstable/observability/OtlpResource\"\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` and\n * `telemetry.sdk.language` included, after JSON escaping and UTF-8 encoding.\n * These SDK fields are conservatively reserved even for the default Effect\n * exporter. Caller attributes overwritten by SDK identity or metadata are\n * still counted. 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

package/dist/esm/BrowserOtel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOtel.d.ts","sourceRoot":"","sources":["../../src/BrowserOtel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAElE,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AACzC,OAAO,KAAK,EAAE,aAAa,IAAI,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAE3E;;;;;;;;;GASG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,SAAS,CAAA;IACzF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,kBAAkB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC,GAAG,SAAS,CAAA;IACxG,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,GAAG,SAAS,CAAA;IACtF,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,OAAO,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,4BAA4B,CAUlG,CAAA"}

package/dist/esm/BrowserOtel.js

@@ -0,0 +1,24 @@
+/**
+ * Browser OpenTelemetry setup with explicitly injected providers/readers.
+ *
+ * @since 0.1.0
+ */
+import * as WebSdk from "@effect/opentelemetry/WebSdk";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Resource from "./Resource.js";
+/**
+ * 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 const layerOtel = (options) => Layer.unwrap(Effect.map(Resource.decode(options.resource), (decoded) => WebSdk.layer(() => ({
+    resource: Resource.toOpenTelemetryConfiguration(decoded),
+    spanProcessor: options.spanProcessor?.(),
+    logRecordProcessor: options.logRecordProcessor?.(),
+    metricReader: options.metricReader?.(),
+    loggerMergeWithExisting: options.loggerMergeWithExisting
+}))));
+//# sourceMappingURL=BrowserOtel.js.map

package/dist/esm/BrowserOtel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserOtel.js","sourceRoot":"","sources":["../../src/BrowserOtel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,8BAA8B,CAAA;AAItD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAA;AAqBzC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAAgB,EAA6D,EAAE,CACvG,KAAK,CAAC,MAAM,CACV,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,CACxD,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC,4BAA4B,CAAC,OAAO,CAAC;IACxD,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,EAAE;IACxC,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,EAAE,EAAE;IAClD,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE;IACtC,uBAAuB,EAAE,OAAO,CAAC,uBAAuB;CACzD,CAAC,CAAC,CAAC,CACP,CAAA"}

package/dist/esm/Endpoint.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Validated collector endpoints for the OTLP exporters.
+ *
+ * The endpoint is the field an operator most often gets wrong, and a wrong one
+ * is invisible: Effect's exporter absorbs export failure by design, so a layer
+ * built against `""` or `"localhost:4318"` looks identical to a working one and
+ * simply never delivers. Every builder therefore decodes its endpoint during
+ * layer acquisition, the same posture `Resource` already takes.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+/**
+ * Largest collector endpoint accepted by a builder.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export declare const maximumEndpointLength = 2048;
+/**
+ * Runtime schema for an absolute `http:` or `https:` collector endpoint that
+ * carries no credentials, query, fragment, backslashes, spaces, or controls.
+ * A base path is allowed; authentication belongs in exporter headers.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export declare const Endpoint: Schema.String;
+declare const InvalidExporterEndpoint_base: Schema.Class<InvalidExporterEndpoint, Schema.TaggedStruct<"@smthrs/observability/InvalidExporterEndpoint", {
+    readonly code: Schema.Literal<"invalid_exporter_endpoint">;
+    readonly path: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * Stable exporter-endpoint refusal shared by every OTLP builder.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export declare class InvalidExporterEndpoint extends InvalidExporterEndpoint_base {
+}
+/**
+ * Removes the repeated trailing separators that would otherwise produce a
+ * double slash in a signal URL.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export declare const normalize: (endpoint: string) => string;
+/**
+ * Decodes one collector endpoint into its normalized form without retaining
+ * the rejected value.
+ *
+ * `path` names the option the endpoint arrived on, so the refusal points at the
+ * caller's own field rather than at a shared internal name.
+ *
+ * @category decoding
+ * @since 1.0.0-rc.0
+ */
+export declare const decode: (endpoint: unknown, path: string) => Effect.Effect<string, InvalidExporterEndpoint>;
+/**
+ * Builds the OTLP/HTTP URL one signal is posted to below a decoded endpoint.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export declare const signalUrl: (endpoint: string, signal: "traces" | "metrics" | "logs") => string;
+export {};
+//# sourceMappingURL=Endpoint.d.ts.map

package/dist/esm/Endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Endpoint.d.ts","sourceRoot":"","sources":["../../src/Endpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAEvC;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,OAAQ,CAAA;AAuC1C;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,eAGpB,CAAA;;;;;;AAED;;;;;GAKG;AACH,qBAAa,uBAAwB,SAAQ,4BAO5C;CAAG;AAEJ;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,KAAG,MAAsC,CAAA;AAEnF;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GACjB,UAAU,OAAO,EACjB,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAW7C,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,QAAQ,QAAQ,GAAG,SAAS,GAAG,MAAM,KAAG,MAC7C,CAAA"}

package/dist/esm/Endpoint.js

@@ -0,0 +1,110 @@
+/**
+ * Validated collector endpoints for the OTLP exporters.
+ *
+ * The endpoint is the field an operator most often gets wrong, and a wrong one
+ * is invisible: Effect's exporter absorbs export failure by design, so a layer
+ * built against `""` or `"localhost:4318"` looks identical to a working one and
+ * simply never delivers. Every builder therefore decodes its endpoint during
+ * layer acquisition, the same posture `Resource` already takes.
+ *
+ * @since 1.0.0-rc.0
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+/**
+ * Largest collector endpoint accepted by a builder.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const maximumEndpointLength = 2_048;
+/** The largest code unit the WHATWG URL parser repairs away: the space. */
+const largestRepairedCodeUnit = 0x20;
+/**
+ * Reports whether the URL parser would repair the value rather than parse it
+ * as written. It strips leading and trailing C0 controls and spaces and
+ * removes tab, newline, and carriage return from anywhere in its input, and
+ * every one of those sits at or below {@link largestRepairedCodeUnit}.
+ */
+const repairedByUrlParser = (value) => {
+    for (let index = 0; index < value.length; index++) {
+        if (value.charCodeAt(index) <= largestRepairedCodeUnit)
+            return true;
+    }
+    return false;
+};
+const isAbsoluteHttpUrl = (value) => {
+    // `new URL` alone is not a validator here. It strips padding and inline
+    // control characters before parsing, so it reports a copy-pasted
+    // `"http://collector:4318\n"` as well formed while the untrimmed original is
+    // what a builder would hand its exporter: either an unusable URL or a
+    // request to a host nobody typed. No legal collector endpoint carries one of
+    // these, so refusing them costs nothing and closes the silent case.
+    if (repairedByUrlParser(value))
+        return false;
+    // Exporters append /v1/<signal> to this base. A query or fragment would
+    // swallow that suffix instead of changing the request path. Also refuse
+    // missing authority separators and backslashes that WHATWG silently repairs.
+    if (!/^https?:\/\/[^/]/i.test(value) || /[?#\\]/.test(value))
+        return false;
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    return url.username === "" && url.password === "";
+};
+/**
+ * Runtime schema for an absolute `http:` or `https:` collector endpoint that
+ * carries no credentials, query, fragment, backslashes, spaces, or controls.
+ * A base path is allowed; authentication belongs in exporter headers.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const Endpoint = Schema.String.check(Schema.isMaxLength(maximumEndpointLength), Schema.makeFilter((value) => isAbsoluteHttpUrl(value), { title: "absoluteCollectorEndpoint" }));
+/**
+ * Stable exporter-endpoint refusal shared by every OTLP builder.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export class InvalidExporterEndpoint extends Schema.TaggedError()("@smthrs/observability/InvalidExporterEndpoint", {
+    code: Schema.Literal("invalid_exporter_endpoint"),
+    path: Schema.String,
+    message: Schema.String
+}) {
+}
+/**
+ * Removes the repeated trailing separators that would otherwise produce a
+ * double slash in a signal URL.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export const normalize = (endpoint) => endpoint.replace(/\/+$/, "");
+/**
+ * Decodes one collector endpoint into its normalized form without retaining
+ * the rejected value.
+ *
+ * `path` names the option the endpoint arrived on, so the refusal points at the
+ * caller's own field rather than at a shared internal name.
+ *
+ * @category decoding
+ * @since 1.0.0-rc.0
+ */
+export const decode = (endpoint, path) => Schema.decodeUnknownEffect(Endpoint)(endpoint).pipe(Effect.map(normalize), Effect.mapError(() => new InvalidExporterEndpoint({
+    code: "invalid_exporter_endpoint",
+    path,
+    message: `OTLP collector ${path} must be an absolute http:// or https:// base URL without credentials, query, fragment, backslashes, spaces, or control characters`
+})));
+/**
+ * Builds the OTLP/HTTP URL one signal is posted to below a decoded endpoint.
+ *
+ * @category conversions
+ * @since 1.0.0-rc.0
+ */
+export const signalUrl = (endpoint, signal) => `${normalize(endpoint)}/v1/${signal}`;
+//# sourceMappingURL=Endpoint.js.map

package/dist/esm/Endpoint.js.map

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