@smthrs/observability 0.35.0 → 1.0.0-rc.13

package/dist/esm/JournalLogger.js

@@ -0,0 +1,520 @@
+/**
+ * Non-blocking forwarding of bounded operational logs to the durable journal.
+ *
+ * @since 0.1.0
+ */
+import * as Journal from "@smthrs/journal/Journal";
+import * as JournalEvent from "@smthrs/journal/JournalEvent";
+import * as Redaction from "@smthrs/journal/Redaction";
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Logger from "effect/Logger";
+import * as EffectMetric from "effect/Metric";
+import * as Option from "effect/Option";
+import * as Queue from "effect/Queue";
+import * as References from "effect/References";
+import * as Schema from "effect/Schema";
+import * as Tracer from "effect/Tracer";
+import { schemaIssuePath } from "./internal/schemaIssuePath.js";
+import { droppedLogRecords } from "./Metric.js";
+/**
+ * Largest queue accepted by the forwarding logger.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const maximumCapacity = 65_536;
+/**
+ * Largest detached log payload admitted to the asynchronous queue.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const maximumSnapshotBytes = 1024 * 1024;
+/**
+ * Largest number of container members copied into one detached log payload.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const maximumSnapshotMembers = 4_096;
+/**
+ * Deepest container path copied into one detached log payload.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const maximumSnapshotDepth = 64;
+/**
+ * What a hostile or unreadable logged value becomes.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const unrenderableMarker = "[Unrenderable]";
+/**
+ * What a value beyond a logger resource ceiling becomes.
+ *
+ * @category constants
+ * @since 1.0.0-rc.0
+ */
+export const truncatedMarker = "[Truncated]";
+/**
+ * A stable logger configuration refusal.
+ *
+ * @category errors
+ * @since 1.0.0-rc.0
+ */
+export class InvalidJournalLoggerOptions extends Schema.TaggedError()("@smthrs/observability/InvalidJournalLoggerOptions", {
+    code: Schema.Literal("invalid_journal_logger_options"),
+    path: Schema.String,
+    message: Schema.String
+}) {
+}
+/**
+ * One typed failure retained from an Effect cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const TelemetryFail = Schema.Struct({
+    _tag: Schema.Literal("Fail"),
+    error: Schema.Unknown
+});
+/**
+ * One unexpected defect retained from an Effect cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const TelemetryDie = Schema.Struct({
+    _tag: Schema.Literal("Die"),
+    defect: Schema.Unknown
+});
+/**
+ * One interruption retained from an Effect cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const TelemetryInterrupt = Schema.Struct({
+    _tag: Schema.Literal("Interrupt"),
+    fiberId: Schema.NullOr(Schema.Int.check(Schema.isGreaterThanOrEqualTo(0)))
+});
+/**
+ * One reason in a persisted telemetry cause.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const TelemetryCauseReason = Schema.Union([TelemetryFail, TelemetryDie, TelemetryInterrupt]);
+/**
+ * A versioned structural Effect cause.
+ *
+ * Effect 4 stores composed failures as an ordered reason list. The projection
+ * preserves that order and each fail, defect, or interrupt discriminator.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export const TelemetryCause = Schema.Struct({
+    version: Schema.Literal(1),
+    reasons: Schema.Array(TelemetryCauseReason)
+});
+/**
+ * Runtime schema for the operational log payload written to the journal.
+ *
+ * @category schemas
+ * @since 1.0.0-rc.0
+ */
+export 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 = 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 shortEscapes = new Set([0x08, 0x09, 0x0a, 0x0c, 0x0d]);
+/** Bytes one non-surrogate code unit occupies inside a JSON string body. */
+const unitBytes = (code) => {
+    if (code === 0x22 || code === 0x5c)
+        return 2;
+    if (code < 0x20)
+        return shortEscapes.has(code) ? 2 : 6;
+    if (code < 0x80)
+        return 1;
+    if (code < 0x800)
+        return 2;
+    return 3;
+};
+const isLowSurrogate = (code) => code >= 0xdc00 && code <= 0xdfff;
+/** Code units that occupy exactly one byte inside a JSON string body. */
+const plainRun = /[\x20\x21\x23-\x5b\x5d-\x7f]*/y;
+/** One-byte units read one at a time before the rest of their run is matched natively. */
+const plainStreak = 16;
+/**
+ * The longest prefix whose JSON string body fits `limit` bytes, measured in one
+ * forward pass. A surrogate pair is admitted or refused whole, so the retained
+ * text is well formed whenever the input is.
+ *
+ * Plain text is one byte per unit, so once a streak of it starts, the rest of
+ * the run is matched natively instead of unit by unit. The match reads a window
+ * one unit past the bytes still free, never the tail the cut drops.
+ */
+const boundedPrefix = (value, limit) => {
+    let bytes = 0;
+    let index = 0;
+    let streak = 0;
+    while (index < value.length) {
+        if (streak >= plainStreak) {
+            plainRun.lastIndex = 0;
+            plainRun.test(value.slice(index, index + limit - bytes + 1));
+            const run = plainRun.lastIndex;
+            const admitted = Math.min(run, limit - bytes);
+            bytes += admitted;
+            index += admitted;
+            if (admitted < run)
+                break;
+            streak = 0;
+            continue;
+        }
+        const code = value.charCodeAt(index);
+        let width = 1;
+        let cost;
+        if (code >= 0xd800 && code <= 0xdbff && isLowSurrogate(value.charCodeAt(index + 1))) {
+            width = 2;
+            cost = 4;
+        }
+        else if (code >= 0xd800 && code <= 0xdfff) {
+            cost = 6;
+        }
+        else {
+            cost = unitBytes(code);
+        }
+        if (bytes + cost > limit)
+            break;
+        bytes += cost;
+        index += width;
+        streak = cost === 1 ? streak + 1 : 0;
+    }
+    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));
+    budget.bytes = Math.max(0, budget.bytes - prefix.bytes - markerBytes);
+    return `${prefix.text}${truncatedMarker}`;
+};
+/**
+ * Error fields read through the prototype chain, in the order the snapshot
+ * projects them before any own data property the error added.
+ */
+const standardErrorKeys = ["name", "message", "stack", "cause"];
+/** Reads inherited data fields without invoking accessors or walking forever. */
+const errorField = (value, key) => {
+    let current = value;
+    for (let depth = 0; current !== null && depth <= maximumSnapshotDepth; depth++) {
+        const descriptor = Object.getOwnPropertyDescriptor(current, key);
+        if (descriptor !== undefined)
+            return "value" in descriptor ? descriptor.value : unrenderableMarker;
+        current = Object.getPrototypeOf(current);
+    }
+    return current === null ? undefined : truncatedMarker;
+};
+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 === undefined)
+        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(Date.prototype.toISOString.call(value), budget);
+            }
+            catch {
+                return boundedText(unrenderableMarker, budget);
+            }
+        }
+        if (value instanceof Error) {
+            const record = Object.create(null);
+            for (const key of standardErrorKeys.slice(0, budget.members)) {
+                budget.members--;
+                try {
+                    record[key] = snapshotValue(errorField(value, key), budget, ancestors, depth + 1);
+                }
+                catch {
+                    record[key] = unrenderableMarker;
+                }
+            }
+            // Tagged failures (`_tag`, domain fields) and system errors (`code`,
+            // `path`, `syscall`) keep their diagnostics as own data properties, so
+            // the walk that projects plain records runs over the remaining keys.
+            let names;
+            try {
+                names = Object.getOwnPropertyNames(value).filter((key) => !standardErrorKeys.includes(key));
+            }
+            catch {
+                return record;
+            }
+            let projected = 0;
+            let collided = false;
+            for (; projected < names.length && budget.members > 0; projected++) {
+                budget.members--;
+                const key = names[projected];
+                const boundedKey = boundedText(key, budget);
+                if (Object.hasOwn(record, boundedKey)) {
+                    collided = true;
+                    continue;
+                }
+                const descriptor = Object.getOwnPropertyDescriptor(value, key);
+                record[boundedKey] = descriptor !== undefined && "value" in descriptor
+                    ? snapshotValue(descriptor.value, budget, ancestors, depth + 1)
+                    : unrenderableMarker;
+            }
+            if (collided || projected < names.length)
+                record[truncatedMarker] = truncatedMarker;
+            return record;
+        }
+        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 === undefined || !("value" in descriptor)
+                    ? unrenderableMarker
+                    : snapshotValue(descriptor.value, budget, ancestors, depth + 1));
+            }
+            if (output.length < length)
+                output.push(truncatedMarker);
+            return output;
+        }
+        const record = 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);
+            // A key truncated to fit the budget can read exactly like one already
+            // copied. The first member keeps its slot; the later one is dropped and
+            // the record is marked truncated below rather than silently overwritten.
+            if (Object.hasOwn(record, boundedKey))
+                continue;
+            record[boundedKey] = descriptor !== undefined && "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, new WeakSet()) };
+            case "Die":
+                return { _tag: "Die", defect: snapshotValue(reason.defect, budget, new WeakSet()) };
+            case "Interrupt":
+                return { _tag: "Interrupt", fiberId: reason.fiberId ?? null };
+        }
+    })
+});
+const isTelemetryLog = Schema.is(TelemetryLog);
+/**
+ * Annotations are a container in the durable schema, so a snapshot that spent
+ * the budget names the loss inside a record instead of replacing the record
+ * with a scalar the schema refuses.
+ */
+const snapshotAnnotations = (value, budget) => {
+    const snapshot = snapshotValue(value, budget, 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));
+        let candidate = {
+            version: 1,
+            level: options.logLevel,
+            message: typeof options.message === "string" ? "" : snapshotValue(options.message, budget, new WeakSet()),
+            annotations: snapshotAnnotations(options.fiber.getRef(References.CurrentLogAnnotations), budget),
+            cause: snapshotCause(options.cause, budget),
+            fiberId: options.fiber.id,
+            ...(span === undefined ? {} : { traceId: span.traceId, spanId: span.spanId }),
+            timestamp: options.date.toISOString()
+        };
+        // A scalar message can spend the whole value budget. Reserve the actual
+        // record envelope first so the final size check does not discard its prefix.
+        if (typeof options.message === "string") {
+            budget.bytes = Math.max(0, maximumSnapshotBytes - encoder.encode(JSON.stringify(candidate)).byteLength + 2);
+            candidate = { ...candidate, message: boundedText(options.message, budget) };
+        }
+        const redacted = Redaction.redact(candidate, { onTooDeep: "name" });
+        // The durable row is only useful if the exported schema decodes it, so an
+        // oversized or schema-invalid projection degrades to the total record
+        // rather than to a payload every consumer throws on.
+        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"
+    }
+});
+/**
+ * Installs a bounded, drop-on-overflow logger forwarder for one explicit run.
+ *
+ * Configuration is decoded before a worker starts. The callback reads the
+ * queue's remaining room first, snapshots and redacts a bounded DTO
+ * synchronously only when a slot is free, then performs only non-blocking
+ * queue admission. A record a saturated queue cannot take is counted and
+ * discarded without being snapshotted. Queue overflow, journal `Dropped` receipts, delivery failures,
+ * and journal defects each advance `Metric.droppedLogRecords`. The two failure
+ * paths also warn through the ambient loggers with a fixed code and run id,
+ * and the worker keeps draining. `Accepted` and `Duplicate` do not advance the
+ * counter. Admission receipts cannot identify later drop-oldest evictions of
+ * these records or report asynchronous persistence failures or shutdown losses.
+ * Closing the scope interrupts the worker and may drop records still queued
+ * behind an in-flight write without advancing the counter.
+ *
+ * The layer replaces the ambient logger set unless `mergeWithExisting` is
+ * `true`, and provides `MinimumLogLevel` only when `minimumLogLevel` is given,
+ * so an application that set that reference elsewhere keeps it.
+ *
+ * @category layers
+ * @since 1.0.0-rc.0
+ */
+export 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(droppedLogRecords, 1);
+    // This worker is forked before the logger it feeds is installed, so
+    // its ambient logger set cannot contain that logger and a warning
+    // here cannot enqueue itself. Delivery stays lossy; the loss is
+    // reported and counted instead of vanishing. Warning annotations
+    // use fixed codes so ambient sinks never receive raw failures.
+    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) => {
+        // Snapshotting and redacting the record is the expensive half of
+        // admission, and saturation is exactly when that work is thrown
+        // away, so a queue with no room refuses before the record is
+        // built. Nothing else runs between this read and the offer, so
+        // the check cannot refuse a record the queue would have taken,
+        // and the offer still reports a queue that closed underneath it.
+        const accepted = !Queue.isFullUnsafe(queue)
+            && Queue.offerUnsafe(queue, makeLog(logOptions, configured.runId));
+        if (!accepted)
+            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 === undefined
+    ? Layer.empty
+    : Layer.succeed(References.MinimumLogLevel, configured.minimumLogLevel))));
+//# sourceMappingURL=JournalLogger.js.map

package/dist/esm/JournalLogger.js.map

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

package/dist/esm/Logger.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 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 and pins the minimum level to `None` unless
+ * `options.minimumLogLevel` explicitly selects another level.
+ *
+ * @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/esm/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;;;;;;GAMG;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/esm/Logger.js

@@ -0,0 +1,61 @@
+/**
+ * Effect logger layers used by flows.
+ *
+ * @since 0.1.0
+ */
+import * as Layer from "effect/Layer";
+import * as Logger from "effect/Logger";
+import * as References from "effect/References";
+/**
+ * Installs the minimum-level reference only when the caller named a level, so
+ * a layer that adds a sink does not pin the level an application chose
+ * elsewhere. Effect's own default for the reference is already `Info`.
+ */
+const withMinimumLogLevel = (layer, minimumLogLevel) => minimumLogLevel === undefined
+    ? layer
+    : Layer.merge(layer, Layer.succeed(References.MinimumLogLevel, minimumLogLevel));
+const optionsWithDefaults = (options) => ({
+    minimumLogLevel: options?.minimumLogLevel,
+    mergeWithExisting: options?.mergeWithExisting ?? false
+});
+/**
+ * Provides a human-readable development logger.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export const layerPrettyDev = (options) => {
+    const resolved = optionsWithDefaults(options);
+    return withMinimumLogLevel(Logger.layer([Logger.consolePretty({ colors: "auto", mode: "auto" })], {
+        mergeWithExisting: resolved.mergeWithExisting
+    }), resolved.minimumLogLevel);
+};
+/**
+ * Provides one structured JSON object per log line.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export const layerStructuredJson = (options) => {
+    const resolved = optionsWithDefaults(options);
+    return withMinimumLogLevel(Logger.layer([Logger.consoleJson], { mergeWithExisting: resolved.mergeWithExisting }), resolved.minimumLogLevel);
+};
+/**
+ * Removes the active logger set and pins the minimum level to `None` unless
+ * `options.minimumLogLevel` explicitly selects another level.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export const layerNoop = (options) => withMinimumLogLevel(Logger.layer([]), options?.minimumLogLevel ?? "None");
+/**
+ * A logger layer that can be composed without requiring a runtime service.
+ *
+ * @category layers
+ * @since 0.1.0
+ */
+export const layer = (logger, options) => {
+    const resolved = optionsWithDefaults(options);
+    return withMinimumLogLevel(Logger.layer([logger], { mergeWithExisting: resolved.mergeWithExisting }), resolved.minimumLogLevel);
+};
+//# sourceMappingURL=Logger.js.map