@smthrs/observability 0.35.0 → 1.0.0-rc.4

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

@@ -0,0 +1 @@
+{"version":3,"file":"JournalLogger.d.ts","sourceRoot":"","sources":["../../src/JournalLogger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,OAAO,MAAM,yBAAyB,CAAA;AAClD,OAAO,KAAK,YAAY,MAAM,8BAA8B,CAAA;AAE5D,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAGrC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAErC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAKhD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AAKvC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,CAAA;AAErC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,QAAc,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAA;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,KAAK,CAAA;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,gBAAgB,CAAA;AAE5C;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAA;IAClC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxD;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjD;;;;;;AAED;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,gCAOhD;CAAG;AAEJ;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;EAGxB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;EAGvB,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB;;;EAG7B,CAAA;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;IAAkE,CAAA;AAEnG;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,oBAAoB,CAAC,IAAI,CAAA;AAEnE;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;EAGzB,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAA;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;EAUvB,CAAA;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,YAAY,CAAC,IAAI,CAAA;AAuSnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,OAAO,KACf,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,2BAA2B,EAAE,OAAO,CAAC,OAAO,CAsE/D,CAAA"}

package/dist/cjs/JournalLogger.js

@@ -0,0 +1,388 @@
+"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 JournalLogger_exports = {};
+__export(JournalLogger_exports, {
+  InvalidJournalLoggerOptions: () => InvalidJournalLoggerOptions,
+  TelemetryCause: () => TelemetryCause,
+  TelemetryCauseReason: () => TelemetryCauseReason,
+  TelemetryDie: () => TelemetryDie,
+  TelemetryFail: () => TelemetryFail,
+  TelemetryInterrupt: () => TelemetryInterrupt,
+  TelemetryLog: () => TelemetryLog,
+  layerJournalForwarding: () => layerJournalForwarding,
+  maximumCapacity: () => maximumCapacity,
+  maximumSnapshotBytes: () => maximumSnapshotBytes,
+  maximumSnapshotDepth: () => maximumSnapshotDepth,
+  maximumSnapshotMembers: () => maximumSnapshotMembers,
+  truncatedMarker: () => truncatedMarker,
+  unrenderableMarker: () => unrenderableMarker
+});
+module.exports = __toCommonJS(JournalLogger_exports);
+var Journal = __toESM(require("@smthrs/journal/Journal"), 1);
+var JournalEvent = __toESM(require("@smthrs/journal/JournalEvent"), 1);
+var Redaction = __toESM(require("@smthrs/journal/Redaction"), 1);
+var Cause = __toESM(require("effect/Cause"), 1);
+var Context = __toESM(require("effect/Context"), 1);
+var Effect = __toESM(require("effect/Effect"), 1);
+var Layer = __toESM(require("effect/Layer"), 1);
+var Logger = __toESM(require("effect/Logger"), 1);
+var EffectMetric = __toESM(require("effect/Metric"), 1);
+var Option = __toESM(require("effect/Option"), 1);
+var Queue = __toESM(require("effect/Queue"), 1);
+var References = __toESM(require("effect/References"), 1);
+var Schema = __toESM(require("effect/Schema"), 1);
+var Tracer = __toESM(require("effect/Tracer"), 1);
+var import_schemaIssuePath = require("./internal/schemaIssuePath.js");
+var import_Metric = require("./Metric.js");
+const maximumCapacity = 65536;
+const maximumSnapshotBytes = 1024 * 1024;
+const maximumSnapshotMembers = 4096;
+const maximumSnapshotDepth = 64;
+const unrenderableMarker = "[Unrenderable]";
+const truncatedMarker = "[Truncated]";
+class InvalidJournalLoggerOptions extends Schema.TaggedError()(
+  "@smthrs/observability/InvalidJournalLoggerOptions",
+  {
+    code: Schema.Literal("invalid_journal_logger_options"),
+    path: Schema.String,
+    message: Schema.String
+  }
+) {
+}
+const TelemetryFail = Schema.Struct({
+  _tag: Schema.Literal("Fail"),
+  error: Schema.Unknown
+});
+const TelemetryDie = Schema.Struct({
+  _tag: Schema.Literal("Die"),
+  defect: Schema.Unknown
+});
+const TelemetryInterrupt = Schema.Struct({
+  _tag: Schema.Literal("Interrupt"),
+  fiberId: Schema.NullOr(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))
+});
+const TelemetryCauseReason = Schema.Union([TelemetryFail, TelemetryDie, TelemetryInterrupt]);
+const TelemetryCause = Schema.Struct({
+  version: Schema.Literal(1),
+  reasons: Schema.Array(TelemetryCauseReason)
+});
+const TelemetryLog = Schema.Struct({
+  version: Schema.Literal(1),
+  level: Schema.Literals(["All", "Fatal", "Error", "Warn", "Info", "Debug", "Trace", "None"]),
+  message: Schema.Unknown,
+  annotations: Schema.Record(Schema.String, Schema.Unknown),
+  cause: TelemetryCause,
+  fiberId: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),
+  traceId: Schema.optionalKey(Schema.String),
+  spanId: Schema.optionalKey(Schema.String),
+  timestamp: Schema.String
+});
+const sourceId = "flows/observability/logger";
+const encoder = new TextEncoder();
+const OptionsSchema = Schema.Struct({
+  runId: JournalEvent.RunId,
+  capacity: Schema.optional(
+    Schema.Int.check(
+      Schema.isGreaterThanOrEqualTo(1),
+      Schema.isLessThanOrEqualTo(maximumCapacity)
+    )
+  ),
+  minimumLogLevel: Schema.optional(
+    Schema.Literals(["All", "Fatal", "Error", "Warn", "Info", "Debug", "Trace", "None"])
+  ),
+  mergeWithExisting: Schema.optional(Schema.Boolean)
+});
+const validateOptions = (options) => Schema.decodeUnknownEffect(OptionsSchema)(options).pipe(
+  Effect.mapError((cause) => {
+    const path = (0, import_schemaIssuePath.schemaIssuePath)(cause, "options");
+    return new InvalidJournalLoggerOptions({
+      code: "invalid_journal_logger_options",
+      path,
+      message: `journal logger ${path} is invalid`
+    });
+  })
+);
+const reserve = (budget, bytes) => {
+  if (bytes > budget.bytes) return false;
+  budget.bytes -= bytes;
+  return true;
+};
+const textBytes = (value) => encoder.encode(JSON.stringify(value)).byteLength;
+const quoteBytes = 2;
+const shortEscapes = /* @__PURE__ */ new Set([8, 9, 10, 12, 13]);
+const unitBytes = (code) => {
+  if (code === 34 || code === 92) return 2;
+  if (code < 32) return shortEscapes.has(code) ? 2 : 6;
+  if (code < 128) return 1;
+  if (code < 2048) return 2;
+  return 3;
+};
+const isLowSurrogate = (code) => code >= 56320 && code <= 57343;
+const boundedPrefix = (value, limit) => {
+  let bytes = 0;
+  let index = 0;
+  while (index < value.length) {
+    const code = value.charCodeAt(index);
+    let width = 1;
+    let cost;
+    if (code >= 55296 && code <= 56319 && isLowSurrogate(value.charCodeAt(index + 1))) {
+      width = 2;
+      cost = 4;
+    } else if (code >= 55296 && code <= 57343) {
+      cost = 6;
+    } else {
+      cost = unitBytes(code);
+    }
+    if (bytes + cost > limit) break;
+    bytes += cost;
+    index += width;
+  }
+  return { text: value.slice(0, index), bytes };
+};
+const boundedText = (value, budget) => {
+  if (value.length <= maximumSnapshotBytes && reserve(budget, textBytes(value))) return value;
+  const markerBytes = textBytes(truncatedMarker);
+  const prefix = boundedPrefix(value, Math.max(0, budget.bytes - markerBytes - quoteBytes));
+  budget.bytes = Math.max(0, budget.bytes - (prefix.bytes + quoteBytes) - markerBytes);
+  return `${prefix.text}${truncatedMarker}`;
+};
+const standardErrorKeys = ["name", "message", "stack", "cause"];
+const snapshotValue = (value, budget, ancestors, depth = 0) => {
+  if (budget.bytes <= 0) return truncatedMarker;
+  if (depth > maximumSnapshotDepth) return Redaction.depthMarker;
+  if (typeof value === "string") return boundedText(value, budget);
+  if (typeof value === "number") {
+    const projected = Number.isFinite(value) ? value : String(value);
+    reserve(budget, String(projected).length);
+    return projected;
+  }
+  if (typeof value === "boolean" || value === null) {
+    reserve(budget, value === null ? 4 : value ? 4 : 5);
+    return value;
+  }
+  if (typeof value === "bigint") return boundedText(`${value}n`, budget);
+  if (value === void 0) return boundedText("[Undefined]", budget);
+  if (typeof value === "function") return boundedText(Redaction.functionMarker, budget);
+  if (typeof value === "symbol") return boundedText(Redaction.symbolMarker, budget);
+  try {
+    if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer) {
+      return boundedText(Redaction.binaryMarker, budget);
+    }
+  } catch {
+    return boundedText(unrenderableMarker, budget);
+  }
+  if (ancestors.has(value)) return boundedText("[Circular]", budget);
+  ancestors.add(value);
+  try {
+    if (value instanceof Date) {
+      try {
+        return boundedText(value.toISOString(), budget);
+      } catch {
+        return boundedText(unrenderableMarker, budget);
+      }
+    }
+    if (value instanceof Error) {
+      const record2 = /* @__PURE__ */ Object.create(null);
+      for (const key of standardErrorKeys.slice(0, budget.members)) {
+        budget.members--;
+        try {
+          record2[key] = snapshotValue(value[key], budget, ancestors, depth + 1);
+        } catch {
+          record2[key] = unrenderableMarker;
+        }
+      }
+      let names2;
+      try {
+        names2 = Object.getOwnPropertyNames(value).filter(
+          (key) => !standardErrorKeys.includes(key)
+        );
+      } catch {
+        return record2;
+      }
+      let projected = 0;
+      let collided = false;
+      for (; projected < names2.length && budget.members > 0; projected++) {
+        budget.members--;
+        const key = names2[projected];
+        const boundedKey = boundedText(key, budget);
+        if (Object.hasOwn(record2, boundedKey)) {
+          collided = true;
+          continue;
+        }
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        record2[boundedKey] = descriptor !== void 0 && "value" in descriptor ? snapshotValue(descriptor.value, budget, ancestors, depth + 1) : unrenderableMarker;
+      }
+      if (collided || projected < names2.length) record2[truncatedMarker] = truncatedMarker;
+      return record2;
+    }
+    if (Array.isArray(value)) {
+      const output = [];
+      const length = value.length;
+      for (let index = 0; index < length && budget.members > 0; index++) {
+        budget.members--;
+        const descriptor = Object.getOwnPropertyDescriptor(value, String(index));
+        output.push(
+          descriptor === void 0 || !("value" in descriptor) ? unrenderableMarker : snapshotValue(descriptor.value, budget, ancestors, depth + 1)
+        );
+      }
+      if (output.length < length) output.push(truncatedMarker);
+      return output;
+    }
+    const record = /* @__PURE__ */ Object.create(null);
+    const names = Object.getOwnPropertyNames(value);
+    for (let index = 0; index < names.length && budget.members > 0; index++) {
+      budget.members--;
+      const key = names[index];
+      const descriptor = Object.getOwnPropertyDescriptor(value, key);
+      const boundedKey = boundedText(key, budget);
+      if (Object.hasOwn(record, boundedKey)) continue;
+      record[boundedKey] = descriptor !== void 0 && "value" in descriptor ? snapshotValue(descriptor.value, budget, ancestors, depth + 1) : unrenderableMarker;
+    }
+    if (Object.keys(record).length < names.length) record[truncatedMarker] = truncatedMarker;
+    return record;
+  } catch {
+    return boundedText(unrenderableMarker, budget);
+  } finally {
+    ancestors.delete(value);
+  }
+};
+const snapshotCause = (cause, budget) => ({
+  version: 1,
+  reasons: cause.reasons.slice(0, maximumSnapshotMembers).map((reason) => {
+    switch (reason._tag) {
+      case "Fail":
+        return { _tag: "Fail", error: snapshotValue(reason.error, budget, /* @__PURE__ */ new WeakSet()) };
+      case "Die":
+        return { _tag: "Die", defect: snapshotValue(reason.defect, budget, /* @__PURE__ */ new WeakSet()) };
+      case "Interrupt":
+        return { _tag: "Interrupt", fiberId: reason.fiberId ?? null };
+    }
+  })
+});
+const isTelemetryLog = Schema.is(TelemetryLog);
+const snapshotAnnotations = (value, budget) => {
+  const snapshot = snapshotValue(value, budget, /* @__PURE__ */ new WeakSet());
+  return typeof snapshot === "object" && snapshot !== null && !Array.isArray(snapshot) ? snapshot : { [truncatedMarker]: truncatedMarker };
+};
+const snapshotLog = (options) => {
+  const budget = {
+    bytes: maximumSnapshotBytes,
+    members: maximumSnapshotMembers
+  };
+  try {
+    const span = Option.getOrUndefined(Context.getOption(options.fiber.context, Tracer.ParentSpan));
+    const candidate = {
+      version: 1,
+      level: options.logLevel,
+      message: snapshotValue(options.message, budget, /* @__PURE__ */ new WeakSet()),
+      annotations: snapshotAnnotations(options.fiber.getRef(References.CurrentLogAnnotations), budget),
+      cause: snapshotCause(options.cause, budget),
+      fiberId: options.fiber.id,
+      ...span === void 0 ? {} : { traceId: span.traceId, spanId: span.spanId },
+      timestamp: options.date.toISOString()
+    };
+    const redacted = Redaction.redact(candidate, { onTooDeep: "name" });
+    return encoder.encode(JSON.stringify(redacted)).byteLength <= maximumSnapshotBytes && isTelemetryLog(redacted) ? redacted : { ...candidate, message: truncatedMarker, annotations: {}, cause: { version: 1, reasons: [] } };
+  } catch {
+    return {
+      version: 1,
+      level: options.logLevel,
+      message: unrenderableMarker,
+      annotations: {},
+      cause: { version: 1, reasons: [] },
+      fiberId: options.fiber.id,
+      timestamp: options.date.toISOString()
+    };
+  }
+};
+const makeLog = (options, runId) => new JournalEvent.Input({
+  runId,
+  sourceId,
+  // The journal owns the durable per-run/source allocation. A local counter
+  // starts over when a layer is rebuilt and makes distinct records collide.
+  eventType: "telemetry.log",
+  payload: snapshotLog(options),
+  meta: {
+    version: 1,
+    source: "/observability"
+  }
+});
+const layerJournalForwarding = (options) => Layer.unwrap(
+  Effect.map(validateOptions(options), (configured) => Layer.merge(
+    Layer.effect(
+      Logger.CurrentLoggers,
+      Effect.gen(function* () {
+        const journal = yield* Journal.Journal;
+        const queue = yield* Queue.bounded(configured.capacity ?? 256);
+        const dropped = EffectMetric.update(import_Metric.droppedLogRecords, 1);
+        const forward = Effect.fn("JournalLogger.forward")(
+          (input) => journal.emitLossy(input).pipe(
+            Effect.tap((receipt) => receipt._tag === "Dropped" ? dropped : Effect.void),
+            Effect.catch(
+              () => dropped.pipe(
+                Effect.andThen(
+                  Effect.annotateLogs(Effect.logWarning("A telemetry log record could not be forwarded"), {
+                    runId: configured.runId,
+                    code: "journal_forwarding_failed"
+                  })
+                )
+              )
+            )
+          )
+        );
+        yield* Effect.forever(
+          Queue.take(queue).pipe(
+            Effect.flatMap(forward),
+            // A defect from a journal implementation would otherwise end
+            // this fiber for the rest of the run, silently, while the layer
+            // still looks installed. Interruption stays fatal.
+            Effect.catchCause(
+              (cause) => Cause.hasInterruptsOnly(cause) ? Effect.failCause(cause) : dropped.pipe(
+                Effect.andThen(
+                  Effect.annotateLogs(
+                    Effect.logWarning("The telemetry forwarding worker recovered from a defect"),
+                    { runId: configured.runId, code: "journal_forwarding_defect" }
+                  )
+                )
+              )
+            )
+          )
+        ).pipe(Effect.forkScoped);
+        const logger = Logger.make((logOptions) => {
+          const accepted = !Queue.isFullUnsafe(queue) && Queue.offerUnsafe(queue, makeLog(logOptions, configured.runId));
+          if (!accepted) import_Metric.droppedLogRecords.updateUnsafe(1, logOptions.fiber.context);
+        });
+        const current = yield* Effect.withFiber((fiber) => Effect.sync(() => fiber.getRef(Logger.CurrentLoggers)));
+        return new Set(configured.mergeWithExisting === true ? current : []).add(logger);
+      })
+    ),
+    configured.minimumLogLevel === void 0 ? Layer.empty : Layer.succeed(References.MinimumLogLevel, configured.minimumLogLevel)
+  ))
+);
+//# sourceMappingURL=JournalLogger.js.map

package/dist/cjs/JournalLogger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/JournalLogger.ts"],
+  "sourcesContent": ["/**\n * Non-blocking forwarding of bounded operational logs to the durable journal.\n *\n * @since 0.1.0\n */\n\nimport * as Journal from \"@smthrs/journal/Journal\"\nimport * as JournalEvent from \"@smthrs/journal/JournalEvent\"\nimport * as Redaction from \"@smthrs/journal/Redaction\"\nimport * as Cause from \"effect/Cause\"\nimport * as Context from \"effect/Context\"\nimport * as Effect from \"effect/Effect\"\nimport * as Layer from \"effect/Layer\"\nimport * as Logger from \"effect/Logger\"\nimport type * as LogLevel from \"effect/LogLevel\"\nimport * as EffectMetric from \"effect/Metric\"\nimport * as Option from \"effect/Option\"\nimport * as Queue from \"effect/Queue\"\nimport * as References from \"effect/References\"\nimport * as Schema from \"effect/Schema\"\nimport * as Tracer from \"effect/Tracer\"\nimport { schemaIssuePath } from \"./internal/schemaIssuePath.ts\"\nimport { droppedLogRecords } from \"./Metric.ts\"\n\n/**\n * Largest queue accepted by the forwarding logger.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumCapacity = 65_536\n\n/**\n * Largest detached log payload admitted to the asynchronous queue.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumSnapshotBytes = 1024 * 1024\n\n/**\n * Largest number of container members copied into one detached log payload.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumSnapshotMembers = 4_096\n\n/**\n * Deepest container path copied into one detached log payload.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const maximumSnapshotDepth = 64\n\n/**\n * What a hostile or unreadable logged value becomes.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const unrenderableMarker = \"[Unrenderable]\"\n\n/**\n * What a value beyond a logger resource ceiling becomes.\n *\n * @category constants\n * @since 1.0.0-rc.0\n */\nexport const truncatedMarker = \"[Truncated]\"\n\n/**\n * Options for the journal forwarding logger.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport interface Options {\n  /** The run every forwarded record is attributed to. */\n  readonly runId: JournalEvent.RunId\n  /** Queue depth, 1 through {@link maximumCapacity}. Defaults to 256. */\n  readonly capacity?: number | undefined\n  /**\n   * Pins `References.MinimumLogLevel` for the whole application. Omitted, the\n   * layer leaves that reference alone and Effect's own `Info` default applies.\n   */\n  readonly minimumLogLevel?: LogLevel.LogLevel | undefined\n  /**\n   * Keeps the ambient loggers alongside the forwarder. Defaults to `false`,\n   * which replaces the ambient logger set.\n   */\n  readonly mergeWithExisting?: boolean | undefined\n}\n\n/**\n * A stable logger configuration refusal.\n *\n * @category errors\n * @since 1.0.0-rc.0\n */\nexport class InvalidJournalLoggerOptions extends Schema.TaggedError<InvalidJournalLoggerOptions>()(\n  \"@smthrs/observability/InvalidJournalLoggerOptions\",\n  {\n    code: Schema.Literal(\"invalid_journal_logger_options\"),\n    path: Schema.String,\n    message: Schema.String\n  }\n) {}\n\n/**\n * One typed failure retained from an Effect cause.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const TelemetryFail = Schema.Struct({\n  _tag: Schema.Literal(\"Fail\"),\n  error: Schema.Unknown\n})\n\n/**\n * One unexpected defect retained from an Effect cause.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const TelemetryDie = Schema.Struct({\n  _tag: Schema.Literal(\"Die\"),\n  defect: Schema.Unknown\n})\n\n/**\n * One interruption retained from an Effect cause.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const TelemetryInterrupt = Schema.Struct({\n  _tag: Schema.Literal(\"Interrupt\"),\n  fiberId: Schema.NullOr(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))\n})\n\n/**\n * One reason in a persisted telemetry cause.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const TelemetryCauseReason = Schema.Union([TelemetryFail, TelemetryDie, TelemetryInterrupt])\n\n/**\n * One reason in a persisted telemetry cause.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type TelemetryCauseReason = typeof TelemetryCauseReason.Type\n\n/**\n * A versioned structural Effect cause.\n *\n * Effect 4 stores composed failures as an ordered reason list. The projection\n * preserves that order and each fail, defect, or interrupt discriminator.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const TelemetryCause = Schema.Struct({\n  version: Schema.Literal(1),\n  reasons: Schema.Array(TelemetryCauseReason)\n})\n\n/**\n * A versioned structural Effect cause.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type TelemetryCause = typeof TelemetryCause.Type\n\n/**\n * Runtime schema for the operational log payload written to the journal.\n *\n * @category schemas\n * @since 1.0.0-rc.0\n */\nexport const TelemetryLog = Schema.Struct({\n  version: Schema.Literal(1),\n  level: Schema.Literals([\"All\", \"Fatal\", \"Error\", \"Warn\", \"Info\", \"Debug\", \"Trace\", \"None\"]),\n  message: Schema.Unknown,\n  annotations: Schema.Record(Schema.String, Schema.Unknown),\n  cause: TelemetryCause,\n  fiberId: Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)),\n  traceId: Schema.optionalKey(Schema.String),\n  spanId: Schema.optionalKey(Schema.String),\n  timestamp: Schema.String\n})\n\n/**\n * Versioned operational log payload written to the journal.\n *\n * @category models\n * @since 1.0.0-rc.0\n */\nexport type TelemetryLog = typeof TelemetryLog.Type\n\nconst sourceId = \"flows/observability/logger\" as JournalEvent.SourceId\nconst encoder = new TextEncoder()\n\nconst OptionsSchema = Schema.Struct({\n  runId: JournalEvent.RunId,\n  capacity: Schema.optional(\n    Schema.Int.check(\n      Schema.isGreaterThanOrEqualTo(1),\n      Schema.isLessThanOrEqualTo(maximumCapacity)\n    )\n  ),\n  minimumLogLevel: Schema.optional(\n    Schema.Literals([\"All\", \"Fatal\", \"Error\", \"Warn\", \"Info\", \"Debug\", \"Trace\", \"None\"])\n  ),\n  mergeWithExisting: Schema.optional(Schema.Boolean)\n})\n\nconst validateOptions = (options: Options) =>\n  Schema.decodeUnknownEffect(OptionsSchema)(options).pipe(\n    Effect.mapError((cause) => {\n      const path = schemaIssuePath(cause, \"options\")\n      return new InvalidJournalLoggerOptions({\n        code: \"invalid_journal_logger_options\",\n        path,\n        message: `journal logger ${path} is invalid`\n      })\n    })\n  )\n\ninterface SnapshotBudget {\n  bytes: number\n  members: number\n}\n\nconst reserve = (budget: SnapshotBudget, bytes: number): boolean => {\n  if (bytes > budget.bytes) return false\n  budget.bytes -= bytes\n  return true\n}\n\nconst textBytes = (value: string): number => encoder.encode(JSON.stringify(value)).byteLength\n\nconst quoteBytes = 2\nconst shortEscapes = new Set([0x08, 0x09, 0x0a, 0x0c, 0x0d])\n\n/** Bytes one non-surrogate code unit occupies inside a JSON string body. */\nconst unitBytes = (code: number): number => {\n  if (code === 0x22 || code === 0x5c) return 2\n  if (code < 0x20) return shortEscapes.has(code) ? 2 : 6\n  if (code < 0x80) return 1\n  if (code < 0x800) return 2\n  return 3\n}\n\nconst isLowSurrogate = (code: number): boolean => code >= 0xdc00 && code <= 0xdfff\n\n/**\n * The longest prefix whose JSON string body fits `limit` bytes, measured in one\n * forward pass. A surrogate pair is admitted or refused whole, so the retained\n * text is well formed whenever the input is.\n */\nconst boundedPrefix = (value: string, limit: number): { readonly text: string; readonly bytes: number } => {\n  let bytes = 0\n  let index = 0\n  while (index < value.length) {\n    const code = value.charCodeAt(index)\n    let width = 1\n    let cost: number\n    if (code >= 0xd800 && code <= 0xdbff && isLowSurrogate(value.charCodeAt(index + 1))) {\n      width = 2\n      cost = 4\n    } else if (code >= 0xd800 && code <= 0xdfff) {\n      cost = 6\n    } else {\n      cost = unitBytes(code)\n    }\n    if (bytes + cost > limit) break\n    bytes += cost\n    index += width\n  }\n  return { text: value.slice(0, index), bytes }\n}\n\nconst boundedText = (value: string, budget: SnapshotBudget): string => {\n  if (value.length <= maximumSnapshotBytes && reserve(budget, textBytes(value))) return value\n  const markerBytes = textBytes(truncatedMarker)\n  const prefix = boundedPrefix(value, Math.max(0, budget.bytes - markerBytes - quoteBytes))\n  budget.bytes = Math.max(0, budget.bytes - (prefix.bytes + quoteBytes) - markerBytes)\n  return `${prefix.text}${truncatedMarker}`\n}\n\n/**\n * Error fields read through the prototype chain, in the order the snapshot\n * projects them before any own data property the error added.\n */\nconst standardErrorKeys = [\"name\", \"message\", \"stack\", \"cause\"] as const\n\nconst snapshotValue = (\n  value: unknown,\n  budget: SnapshotBudget,\n  ancestors: WeakSet<object>,\n  depth = 0\n): unknown => {\n  if (budget.bytes <= 0) return truncatedMarker\n  if (depth > maximumSnapshotDepth) return Redaction.depthMarker\n  if (typeof value === \"string\") return boundedText(value, budget)\n  if (typeof value === \"number\") {\n    const projected = Number.isFinite(value) ? value : String(value)\n    reserve(budget, String(projected).length)\n    return projected\n  }\n  if (typeof value === \"boolean\" || value === null) {\n    reserve(budget, value === null ? 4 : value ? 4 : 5)\n    return value\n  }\n  if (typeof value === \"bigint\") return boundedText(`${value}n`, budget)\n  if (value === undefined) return boundedText(\"[Undefined]\", budget)\n  if (typeof value === \"function\") return boundedText(Redaction.functionMarker, budget)\n  if (typeof value === \"symbol\") return boundedText(Redaction.symbolMarker, budget)\n  try {\n    if (ArrayBuffer.isView(value) || value instanceof ArrayBuffer) {\n      return boundedText(Redaction.binaryMarker, budget)\n    }\n  } catch {\n    return boundedText(unrenderableMarker, budget)\n  }\n  if (ancestors.has(value)) return boundedText(\"[Circular]\", budget)\n  ancestors.add(value)\n  try {\n    if (value instanceof Date) {\n      try {\n        return boundedText(value.toISOString(), budget)\n      } catch {\n        return boundedText(unrenderableMarker, budget)\n      }\n    }\n    if (value instanceof Error) {\n      const record: Record<string, unknown> = Object.create(null)\n      for (const key of standardErrorKeys.slice(0, budget.members)) {\n        budget.members--\n        try {\n          record[key] = snapshotValue(value[key], budget, ancestors, depth + 1)\n        } catch {\n          record[key] = unrenderableMarker\n        }\n      }\n      // Tagged failures (`_tag`, domain fields) and system errors (`code`,\n      // `path`, `syscall`) keep their diagnostics as own data properties, so\n      // the walk that projects plain records runs over the remaining keys.\n      let names: ReadonlyArray<string>\n      try {\n        names = Object.getOwnPropertyNames(value).filter((key) =>\n          !(standardErrorKeys as ReadonlyArray<string>).includes(key)\n        )\n      } catch {\n        return record\n      }\n      let projected = 0\n      let collided = false\n      for (; projected < names.length && budget.members > 0; projected++) {\n        budget.members--\n        const key = names[projected]!\n        const boundedKey = boundedText(key, budget)\n        if (Object.hasOwn(record, boundedKey)) {\n          collided = true\n          continue\n        }\n        const descriptor = Object.getOwnPropertyDescriptor(value, key)\n        record[boundedKey] = descriptor !== undefined && \"value\" in descriptor\n          ? snapshotValue(descriptor.value, budget, ancestors, depth + 1)\n          : unrenderableMarker\n      }\n      if (collided || projected < names.length) record[truncatedMarker] = truncatedMarker\n      return record\n    }\n    if (Array.isArray(value)) {\n      const output: Array<unknown> = []\n      const length = value.length\n      for (let index = 0; index < length && budget.members > 0; index++) {\n        budget.members--\n        const descriptor = Object.getOwnPropertyDescriptor(value, String(index))\n        output.push(\n          descriptor === undefined || !(\"value\" in descriptor)\n            ? unrenderableMarker\n            : snapshotValue(descriptor.value, budget, ancestors, depth + 1)\n        )\n      }\n      if (output.length < length) output.push(truncatedMarker)\n      return output\n    }\n    const record: Record<string, unknown> = Object.create(null)\n    const names = Object.getOwnPropertyNames(value)\n    for (let index = 0; index < names.length && budget.members > 0; index++) {\n      budget.members--\n      const key = names[index]!\n      const descriptor = Object.getOwnPropertyDescriptor(value, key)\n      const boundedKey = boundedText(key, budget)\n      // A key truncated to fit the budget can read exactly like one already\n      // copied. The first member keeps its slot; the later one is dropped and\n      // the record is marked truncated below rather than silently overwritten.\n      if (Object.hasOwn(record, boundedKey)) continue\n      record[boundedKey] = descriptor !== undefined && \"value\" in descriptor\n        ? snapshotValue(descriptor.value, budget, ancestors, depth + 1)\n        : unrenderableMarker\n    }\n    if (Object.keys(record).length < names.length) record[truncatedMarker] = truncatedMarker\n    return record\n  } catch {\n    return boundedText(unrenderableMarker, budget)\n  } finally {\n    ancestors.delete(value)\n  }\n}\n\nconst snapshotCause = (cause: Cause.Cause<unknown>, budget: SnapshotBudget): TelemetryCause => ({\n  version: 1,\n  reasons: cause.reasons.slice(0, maximumSnapshotMembers).map((reason): TelemetryCauseReason => {\n    switch (reason._tag) {\n      case \"Fail\":\n        return { _tag: \"Fail\", error: snapshotValue(reason.error, budget, new WeakSet()) }\n      case \"Die\":\n        return { _tag: \"Die\", defect: snapshotValue(reason.defect, budget, new WeakSet()) }\n      case \"Interrupt\":\n        return { _tag: \"Interrupt\", fiberId: reason.fiberId ?? null }\n    }\n  })\n})\n\nconst isTelemetryLog = Schema.is(TelemetryLog)\n\n/**\n * Annotations are a container in the durable schema, so a snapshot that spent\n * the budget names the loss inside a record instead of replacing the record\n * with a scalar the schema refuses.\n */\nconst snapshotAnnotations = (value: unknown, budget: SnapshotBudget): Readonly<Record<string, unknown>> => {\n  const snapshot = snapshotValue(value, budget, new WeakSet())\n  return typeof snapshot === \"object\" && snapshot !== null && !Array.isArray(snapshot)\n    ? snapshot as Readonly<Record<string, unknown>>\n    : { [truncatedMarker]: truncatedMarker }\n}\n\nconst snapshotLog = (options: Logger.Options<unknown>): TelemetryLog => {\n  const budget: SnapshotBudget = {\n    bytes: maximumSnapshotBytes,\n    members: maximumSnapshotMembers\n  }\n  try {\n    const span = Option.getOrUndefined(Context.getOption(options.fiber.context, Tracer.ParentSpan))\n    const candidate: TelemetryLog = {\n      version: 1,\n      level: options.logLevel,\n      message: snapshotValue(options.message, budget, new WeakSet()),\n      annotations: snapshotAnnotations(options.fiber.getRef(References.CurrentLogAnnotations), budget),\n      cause: snapshotCause(options.cause, budget),\n      fiberId: options.fiber.id,\n      ...(span === undefined ? {} : { traceId: span.traceId, spanId: span.spanId }),\n      timestamp: options.date.toISOString()\n    }\n    const redacted = Redaction.redact(candidate, { onTooDeep: \"name\" }) as TelemetryLog\n    // The durable row is only useful if the exported schema decodes it, so an\n    // oversized or schema-invalid projection degrades to the total record\n    // rather than to a payload every consumer throws on.\n    return encoder.encode(JSON.stringify(redacted)).byteLength <= maximumSnapshotBytes && isTelemetryLog(redacted)\n      ? redacted\n      : { ...candidate, message: truncatedMarker, annotations: {}, cause: { version: 1, reasons: [] } }\n  } catch {\n    return {\n      version: 1,\n      level: options.logLevel,\n      message: unrenderableMarker,\n      annotations: {},\n      cause: { version: 1, reasons: [] },\n      fiberId: options.fiber.id,\n      timestamp: options.date.toISOString()\n    }\n  }\n}\n\nconst makeLog = (options: Logger.Options<unknown>, runId: JournalEvent.RunId): JournalEvent.Input =>\n  new JournalEvent.Input({\n    runId,\n    sourceId,\n    // The journal owns the durable per-run/source allocation. A local counter\n    // starts over when a layer is rebuilt and makes distinct records collide.\n    eventType: \"telemetry.log\",\n    payload: snapshotLog(options),\n    meta: {\n      version: 1,\n      source: \"/observability\"\n    }\n  })\n\n/**\n * Installs a bounded, drop-on-overflow logger forwarder for one explicit run.\n *\n * Configuration is decoded before a worker starts. The callback reads the\n * queue's remaining room first, snapshots and redacts a bounded DTO\n * synchronously only when a slot is free, then performs only non-blocking\n * queue admission. A record a saturated queue cannot take is counted and\n * discarded without being snapshotted. Queue overflow, journal `Dropped` receipts, delivery failures,\n * and journal defects each advance `Metric.droppedLogRecords`. The two failure\n * paths also warn through the ambient loggers with a fixed code and run id,\n * and the worker keeps draining. `Accepted` and `Duplicate` do not advance the\n * counter. Admission receipts cannot identify later drop-oldest evictions of\n * these records or report asynchronous persistence failures or shutdown losses.\n * Closing the scope interrupts the worker and may drop records still queued\n * behind an in-flight write without advancing the counter.\n *\n * The layer replaces the ambient logger set unless `mergeWithExisting` is\n * `true`, and provides `MinimumLogLevel` only when `minimumLogLevel` is given,\n * so an application that set that reference elsewhere keeps it.\n *\n * @category layers\n * @since 1.0.0-rc.0\n */\nexport const layerJournalForwarding = (\n  options: Options\n): Layer.Layer<never, InvalidJournalLoggerOptions, Journal.Journal> =>\n  Layer.unwrap(\n    Effect.map(validateOptions(options), (configured) =>\n      Layer.merge(\n        Layer.effect(\n          Logger.CurrentLoggers,\n          Effect.gen(function*() {\n            const journal = yield* Journal.Journal\n            const queue = yield* Queue.bounded<JournalEvent.Input>(configured.capacity ?? 256)\n            const dropped = EffectMetric.update(droppedLogRecords, 1)\n            // This worker is forked before the logger it feeds is installed, so\n            // its ambient logger set cannot contain that logger and a warning\n            // here cannot enqueue itself. Delivery stays lossy; the loss is\n            // reported and counted instead of vanishing. Warning annotations\n            // use fixed codes so ambient sinks never receive raw failures.\n            const forward = Effect.fn(\"JournalLogger.forward\")((input: JournalEvent.Input) =>\n              journal.emitLossy(input).pipe(\n                Effect.tap((receipt) => receipt._tag === \"Dropped\" ? dropped : Effect.void),\n                Effect.catch(() =>\n                  dropped.pipe(\n                    Effect.andThen(\n                      Effect.annotateLogs(Effect.logWarning(\"A telemetry log record could not be forwarded\"), {\n                        runId: configured.runId,\n                        code: \"journal_forwarding_failed\"\n                      })\n                    )\n                  )\n                )\n              )\n            )\n            yield* Effect.forever(\n              Queue.take(queue).pipe(\n                Effect.flatMap(forward),\n                // A defect from a journal implementation would otherwise end\n                // this fiber for the rest of the run, silently, while the layer\n                // still looks installed. Interruption stays fatal.\n                Effect.catchCause((cause) =>\n                  Cause.hasInterruptsOnly(cause)\n                    ? Effect.failCause(cause)\n                    : dropped.pipe(\n                      Effect.andThen(\n                        Effect.annotateLogs(\n                          Effect.logWarning(\"The telemetry forwarding worker recovered from a defect\"),\n                          { runId: configured.runId, code: \"journal_forwarding_defect\" }\n                        )\n                      )\n                    )\n                )\n              )\n            ).pipe(Effect.forkScoped)\n\n            const logger = Logger.make<unknown, void>((logOptions) => {\n              // Snapshotting and redacting the record is the expensive half of\n              // admission, and saturation is exactly when that work is thrown\n              // away, so a queue with no room refuses before the record is\n              // built. Nothing else runs between this read and the offer, so\n              // the check cannot refuse a record the queue would have taken,\n              // and the offer still reports a queue that closed underneath it.\n              const accepted = !Queue.isFullUnsafe(queue)\n                && Queue.offerUnsafe(queue, makeLog(logOptions, configured.runId))\n              if (!accepted) droppedLogRecords.updateUnsafe(1, logOptions.fiber.context)\n            })\n            const current = yield* Effect.withFiber((fiber) => Effect.sync(() => fiber.getRef(Logger.CurrentLoggers)))\n            return new Set(configured.mergeWithExisting === true ? current : []).add(logger)\n          })\n        ),\n        configured.minimumLogLevel === undefined\n          ? Layer.empty\n          : Layer.succeed(References.MinimumLogLevel, configured.minimumLogLevel)\n      ))\n  )\n"],
+  "mappings": "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",
+  "names": ["record", "names"]
+}

package/dist/cjs/Logger.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Effect logger layers used by flows.
+ *
+ * @since 0.1.0
+ */
+import * as Layer from "effect/Layer";
+import * as Logger from "effect/Logger";
+import type * as LogLevel from "effect/LogLevel";
+/**
+ * Options shared by the built-in logger layers.
+ *
+ * @category models
+ * @since 0.1.0
+ */
+export interface Options {
+    /**
+     * Pins `References.MinimumLogLevel` for the whole application. Omitted, the
+     * layer leaves that reference alone and Effect's own `Info` default applies.
+     */
+    readonly minimumLogLevel?: LogLevel.LogLevel | undefined;
+    /**
+     * Keeps the ambient loggers alongside this one. Defaults to `false`, which
+     * replaces the ambient logger set, matching Effect's own `Logger.layer`.
+     */
+    readonly mergeWithExisting?: boolean | undefined;
+}
+/**
+ * Provides a human-readable development logger.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export declare const layerPrettyDev: (options?: Options) => Layer.Layer<never>;
+/**
+ * Provides one structured JSON object per log line.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export declare const layerStructuredJson: (options?: Options) => Layer.Layer<never>;
+/**
+ * Removes the active logger set while retaining Effect's minimum-level filter.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export declare const layerNoop: (options?: Pick<Options, "minimumLogLevel">) => Layer.Layer<never>;
+/**
+ * A logger layer that can be composed without requiring a runtime service.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export declare const layer: (logger: Logger.Logger<unknown, unknown>, options?: Options) => Layer.Layer<never>;
+//# sourceMappingURL=Logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/Logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,KAAK,QAAQ,MAAM,iBAAiB,CAAA;AAGhD;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,QAAQ,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxD;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACjD;AAuBD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,OAAO,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAQnE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,UAAU,OAAO,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAMxE,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,IAAI,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAIrF,CAAA;AAEH;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,OAAO,KAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAMnG,CAAA"}

package/dist/cjs/Logger.js

@@ -0,0 +1,72 @@
+"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 Logger_exports = {};
+__export(Logger_exports, {
+  layer: () => layer,
+  layerNoop: () => layerNoop,
+  layerPrettyDev: () => layerPrettyDev,
+  layerStructuredJson: () => layerStructuredJson
+});
+module.exports = __toCommonJS(Logger_exports);
+var Layer = __toESM(require("effect/Layer"), 1);
+var Logger = __toESM(require("effect/Logger"), 1);
+var References = __toESM(require("effect/References"), 1);
+const withMinimumLogLevel = (layer2, minimumLogLevel) => minimumLogLevel === void 0 ? layer2 : Layer.merge(layer2, Layer.succeed(References.MinimumLogLevel, minimumLogLevel));
+const optionsWithDefaults = (options) => ({
+  minimumLogLevel: options?.minimumLogLevel,
+  mergeWithExisting: options?.mergeWithExisting ?? false
+});
+const layerPrettyDev = (options) => {
+  const resolved = optionsWithDefaults(options);
+  return withMinimumLogLevel(
+    Logger.layer([Logger.consolePretty({ colors: "auto", mode: "auto" })], {
+      mergeWithExisting: resolved.mergeWithExisting
+    }),
+    resolved.minimumLogLevel
+  );
+};
+const layerStructuredJson = (options) => {
+  const resolved = optionsWithDefaults(options);
+  return withMinimumLogLevel(
+    Logger.layer([Logger.consoleJson], { mergeWithExisting: resolved.mergeWithExisting }),
+    resolved.minimumLogLevel
+  );
+};
+const layerNoop = (options) => withMinimumLogLevel(
+  Logger.layer([]),
+  options?.minimumLogLevel ?? "None"
+);
+const layer = (logger, options) => {
+  const resolved = optionsWithDefaults(options);
+  return withMinimumLogLevel(
+    Logger.layer([logger], { mergeWithExisting: resolved.mergeWithExisting }),
+    resolved.minimumLogLevel
+  );
+};
+//# sourceMappingURL=Logger.js.map

package/dist/cjs/Logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/Logger.ts"],
+  "sourcesContent": ["/**\n * Effect logger layers used by flows.\n *\n * @since 0.1.0\n */\n\nimport * as Layer from \"effect/Layer\"\nimport * as Logger from \"effect/Logger\"\nimport type * as LogLevel from \"effect/LogLevel\"\nimport * as References from \"effect/References\"\n\n/**\n * Options shared by the built-in logger layers.\n *\n * @category models\n * @since 0.1.0\n */\nexport interface Options {\n  /**\n   * Pins `References.MinimumLogLevel` for the whole application. Omitted, the\n   * layer leaves that reference alone and Effect's own `Info` default applies.\n   */\n  readonly minimumLogLevel?: LogLevel.LogLevel | undefined\n  /**\n   * Keeps the ambient loggers alongside this one. Defaults to `false`, which\n   * replaces the ambient logger set, matching Effect's own `Logger.layer`.\n   */\n  readonly mergeWithExisting?: boolean | undefined\n}\n\n/**\n * Installs the minimum-level reference only when the caller named a level, so\n * a layer that adds a sink does not pin the level an application chose\n * elsewhere. Effect's own default for the reference is already `Info`.\n */\nconst withMinimumLogLevel = (\n  layer: Layer.Layer<never>,\n  minimumLogLevel: LogLevel.LogLevel | undefined\n): Layer.Layer<never> =>\n  minimumLogLevel === undefined\n    ? layer\n    : Layer.merge(layer, Layer.succeed(References.MinimumLogLevel, minimumLogLevel))\n\nconst optionsWithDefaults = (options?: Options): {\n  readonly minimumLogLevel: LogLevel.LogLevel | undefined\n  readonly mergeWithExisting: boolean\n} => ({\n  minimumLogLevel: options?.minimumLogLevel,\n  mergeWithExisting: options?.mergeWithExisting ?? false\n})\n\n/**\n * Provides a human-readable development logger.\n *\n * @category layers\n * @since 0.1.0\n */\nexport const layerPrettyDev = (options?: Options): Layer.Layer<never> => {\n  const resolved = optionsWithDefaults(options)\n  return withMinimumLogLevel(\n    Logger.layer([Logger.consolePretty({ colors: \"auto\", mode: \"auto\" })], {\n      mergeWithExisting: resolved.mergeWithExisting\n    }),\n    resolved.minimumLogLevel\n  )\n}\n\n/**\n * Provides one structured JSON object per log line.\n *\n * @category layers\n * @since 0.1.0\n */\nexport const layerStructuredJson = (options?: Options): Layer.Layer<never> => {\n  const resolved = optionsWithDefaults(options)\n  return withMinimumLogLevel(\n    Logger.layer([Logger.consoleJson], { mergeWithExisting: resolved.mergeWithExisting }),\n    resolved.minimumLogLevel\n  )\n}\n\n/**\n * Removes the active logger set while retaining Effect's minimum-level filter.\n *\n * @category layers\n * @since 0.1.0\n */\nexport const layerNoop = (options?: Pick<Options, \"minimumLogLevel\">): Layer.Layer<never> =>\n  withMinimumLogLevel(\n    Logger.layer([]),\n    options?.minimumLogLevel ?? \"None\"\n  )\n\n/**\n * A logger layer that can be composed without requiring a runtime service.\n *\n * @category layers\n * @since 0.1.0\n */\nexport const layer = (logger: Logger.Logger<unknown, unknown>, options?: Options): Layer.Layer<never> => {\n  const resolved = optionsWithDefaults(options)\n  return withMinimumLogLevel(\n    Logger.layer([logger], { mergeWithExisting: resolved.mergeWithExisting }),\n    resolved.minimumLogLevel\n  )\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,YAAuB;AACvB,aAAwB;AAExB,iBAA4B;AA0B5B,MAAM,sBAAsB,CAC1BA,QACA,oBAEA,oBAAoB,SAChBA,SACA,MAAM,MAAMA,QAAO,MAAM,QAAQ,WAAW,iBAAiB,eAAe,CAAC;AAEnF,MAAM,sBAAsB,CAAC,aAGvB;AAAA,EACJ,iBAAiB,SAAS;AAAA,EAC1B,mBAAmB,SAAS,qBAAqB;AACnD;AAQO,MAAM,iBAAiB,CAAC,YAA0C;AACvE,QAAM,WAAW,oBAAoB,OAAO;AAC5C,SAAO;AAAA,IACL,OAAO,MAAM,CAAC,OAAO,cAAc,EAAE,QAAQ,QAAQ,MAAM,OAAO,CAAC,CAAC,GAAG;AAAA,MACrE,mBAAmB,SAAS;AAAA,IAC9B,CAAC;AAAA,IACD,SAAS;AAAA,EACX;AACF;AAQO,MAAM,sBAAsB,CAAC,YAA0C;AAC5E,QAAM,WAAW,oBAAoB,OAAO;AAC5C,SAAO;AAAA,IACL,OAAO,MAAM,CAAC,OAAO,WAAW,GAAG,EAAE,mBAAmB,SAAS,kBAAkB,CAAC;AAAA,IACpF,SAAS;AAAA,EACX;AACF;AAQO,MAAM,YAAY,CAAC,YACxB;AAAA,EACE,OAAO,MAAM,CAAC,CAAC;AAAA,EACf,SAAS,mBAAmB;AAC9B;AAQK,MAAM,QAAQ,CAAC,QAAyC,YAA0C;AACvG,QAAM,WAAW,oBAAoB,OAAO;AAC5C,SAAO;AAAA,IACL,OAAO,MAAM,CAAC,MAAM,GAAG,EAAE,mBAAmB,SAAS,kBAAkB,CAAC;AAAA,IACxE,SAAS;AAAA,EACX;AACF;",
+  "names": ["layer"]
+}