effect-start 0.26.0 → 0.27.0

package/src/console/ConsoleErrors.ts

@@ -1,213 +0,0 @@
-import * as Cause from "effect/Cause"
-import * as Chunk from "effect/Chunk"
-import * as Effect from "effect/Effect"
-import * as Exit from "effect/Exit"
-import * as FiberId from "effect/FiberId"
-import * as FiberRef from "effect/FiberRef"
-import * as HashMap from "effect/HashMap"
-import * as Layer from "effect/Layer"
-import * as Option from "effect/Option"
-import * as PubSub from "effect/PubSub"
-import type * as Context from "effect/Context"
-import type * as Fiber from "effect/Fiber"
-import * as Supervisor from "effect/Supervisor"
-import * as ConsoleStore from "./ConsoleStore.ts"
-
-let errorId = 0
-
-function safeSerialize(value: unknown, depth = 0): unknown {
-  if (depth > 4) return "<deep>"
-  if (value === null || value === undefined) return value
-  if (typeof value === "bigint") return `${value}n`
-  if (typeof value === "function") return undefined
-  if (typeof value === "symbol") return value.toString()
-  if (typeof value !== "object") return value
-  if (value instanceof Date) return value.toISOString()
-  if (value instanceof Error) return value.message
-  if (Array.isArray(value)) return value.slice(0, 20).map((v) => safeSerialize(v, depth + 1))
-  const proto = Object.getPrototypeOf(value)
-  if (proto !== null && proto !== Object.prototype) {
-    if (typeof (value as any)._tag === "string") {
-      return serializeTaggedObject(value as Record<string, unknown>, depth)
-    }
-    return `<${proto.constructor?.name ?? "object"}>`
-  }
-  return serializePlainObject(value as Record<string, unknown>, depth)
-}
-
-function serializePlainObject(
-  obj: Record<string, unknown>,
-  depth: number,
-): Record<string, unknown> {
-  const out: Record<string, unknown> = {}
-  let count = 0
-  for (const [k, v] of Object.entries(obj)) {
-    if (count >= 20) break
-    if (typeof v === "function") continue
-    const serialized = safeSerialize(v, depth + 1)
-    if (serialized !== undefined) {
-      out[k] = serialized
-      count++
-    }
-  }
-  return out
-}
-
-function serializeTaggedObject(
-  obj: Record<string, unknown>,
-  depth: number,
-): Record<string, unknown> {
-  const out: Record<string, unknown> = { _tag: obj._tag }
-  let count = 0
-  for (const [k, v] of Object.entries(obj)) {
-    if (count >= 20) break
-    if (k === "_tag") continue
-    if (typeof v === "function") continue
-    if (k === "stack" || k === "name") continue
-    const serialized = safeSerialize(v, depth + 1)
-    if (serialized !== undefined) {
-      out[k] = serialized
-      count++
-    }
-  }
-  return out
-}
-
-function extractTag(error: unknown): string | undefined {
-  if (
-    error !== null &&
-    typeof error === "object" &&
-    "_tag" in error &&
-    typeof (error as any)._tag === "string"
-  ) {
-    return (error as any)._tag
-  }
-  return undefined
-}
-
-function extractMessage(error: unknown): string {
-  if (error instanceof Error) return error.message
-  if (typeof error === "string") return error
-  const tag = extractTag(error)
-  if (tag) return tag
-  try {
-    return String(error)
-  } catch {
-    return "<unknown>"
-  }
-}
-
-function extractProperties(error: unknown): Record<string, unknown> {
-  if (error === null || error === undefined || typeof error !== "object") return {}
-  const out: Record<string, unknown> = {}
-  let count = 0
-  for (const [k, v] of Object.entries(error)) {
-    if (count >= 20) break
-    if (k === "_tag" || k === "stack" || k === "name") continue
-    if (typeof v === "function") continue
-    const serialized = safeSerialize(v, 0)
-    if (serialized !== undefined) {
-      out[k] = serialized
-      count++
-    }
-  }
-  return out
-}
-
-const spanSymbol = Symbol.for("effect/SpanAnnotation")
-
-function extractSpanName(error: unknown): string | undefined {
-  if (error !== null && typeof error === "object" && spanSymbol in error) {
-    const span = (error as any)[spanSymbol]
-    return typeof span?.name === "string" ? span.name : undefined
-  }
-  return undefined
-}
-
-function extractDetails(cause: Cause.Cause<unknown>): Array<ConsoleStore.ConsoleErrorDetail> {
-  const details: Array<ConsoleStore.ConsoleErrorDetail> = []
-
-  const failures = Chunk.toArray(Cause.failures(cause))
-  for (const error of failures) {
-    details.push({
-      kind: "fail",
-      tag: extractTag(error),
-      message: extractMessage(error),
-      properties: extractProperties(error),
-      span: extractSpanName(error),
-    })
-  }
-
-  const defects = Chunk.toArray(Cause.defects(cause))
-  for (const defect of defects) {
-    details.push({
-      kind: "die",
-      tag: extractTag(defect),
-      message: extractMessage(defect),
-      properties: extractProperties(defect),
-      span: extractSpanName(defect),
-    })
-  }
-
-  return details
-}
-
-function make(store: ConsoleStore.ConsoleStoreShape): Supervisor.Supervisor<void> {
-  return new (class extends Supervisor.AbstractSupervisor<void> {
-    value = Effect.void
-
-    onStart<A, E, R>(
-      _context: Context.Context<R>,
-      _effect: Effect.Effect<A, E, R>,
-      parent: Option.Option<Fiber.RuntimeFiber<any, any>>,
-      fiber: Fiber.RuntimeFiber<A, E>,
-    ) {
-      const childId = FiberId.threadName(fiber.id())
-      if (Option.isSome(parent)) {
-        const parentId = FiberId.threadName(parent.value.id())
-        if (childId !== parentId) {
-          store.fiberParents.set(childId, parentId)
-        }
-      }
-
-      const span = fiber.currentSpan
-      const annotations: Record<string, unknown> = {}
-      const spanAnnotations = fiber.getFiberRef(FiberRef.currentTracerSpanAnnotations)
-      HashMap.forEach(spanAnnotations, (value, key) => {
-        annotations[key] = value
-      })
-      const logAnnotations = fiber.getFiberRef(FiberRef.currentLogAnnotations)
-      HashMap.forEach(logAnnotations, (value, key) => {
-        annotations[key] = value
-      })
-
-      store.fiberContexts.set(childId, {
-        spanName: span?._tag === "Span" ? span.name : undefined,
-        traceId: span ? span.traceId : undefined,
-        annotations,
-      })
-    }
-
-    onEnd<A, E>(exit: Exit.Exit<A, E>, fiber: Fiber.RuntimeFiber<A, E>) {
-      if (Exit.isFailure(exit) && !Cause.isInterruptedOnly(exit.cause)) {
-        const error: ConsoleStore.ConsoleError = {
-          id: String(++errorId),
-          date: new Date(),
-          fiberId: FiberId.threadName(fiber.id()),
-          interrupted: Cause.isInterrupted(exit.cause),
-          prettyPrint: Cause.pretty(exit.cause, { renderErrorCause: true }),
-          details: extractDetails(exit.cause),
-        }
-        store.errors.push(error)
-        Effect.runSync(PubSub.publish(store.events, { _tag: "Error", error }))
-      }
-    }
-  })()
-}
-
-export const layer: Layer.Layer<never, never, ConsoleStore.ConsoleStore> = Layer.unwrapEffect(
-  Effect.gen(function* () {
-    const store = yield* ConsoleStore.ConsoleStore
-    return Supervisor.addSupervisor(make(store))
-  }),
-)

package/src/console/ConsoleLogger.ts

@@ -1,56 +0,0 @@
-import * as Cause from "effect/Cause"
-import * as Effect from "effect/Effect"
-import * as FiberId from "effect/FiberId"
-import * as FiberRef from "effect/FiberRef"
-import * as HashMap from "effect/HashMap"
-import * as HashSet from "effect/HashSet"
-import * as Layer from "effect/Layer"
-import * as List from "effect/List"
-import * as Logger from "effect/Logger"
-import * as PubSub from "effect/PubSub"
-import * as ConsoleStore from "./ConsoleStore.ts"
-
-let logId = 0
-
-export const layer: Layer.Layer<never, never, ConsoleStore.ConsoleStore> = Layer.effectDiscard(
-  Effect.gen(function* () {
-    const store = yield* ConsoleStore.ConsoleStore
-
-    const logger = Logger.make(
-      ({ message, logLevel, cause, fiberId, spans, annotations, date }) => {
-        const levelMap: Record<string, ConsoleStore.ConsoleLog["level"]> = {
-          Debug: "DEBUG",
-          Info: "INFO",
-          Warning: "WARNING",
-          Error: "ERROR",
-          Fatal: "FATAL",
-        }
-        const level = levelMap[logLevel._tag] ?? "INFO"
-        const causeStr = !Cause.isEmpty(cause)
-          ? Cause.pretty(cause, { renderErrorCause: true })
-          : undefined
-        const spanNames: Array<string> = []
-        List.forEach(spans, (s) => spanNames.push(s.label))
-        const ann: Record<string, unknown> = {}
-        HashMap.forEach(annotations, (v, k) => {
-          ann[k] = v
-        })
-
-        const log: ConsoleStore.ConsoleLog = {
-          id: String(++logId),
-          date,
-          level,
-          message: String(message),
-          fiberId: FiberId.threadName(fiberId),
-          cause: causeStr,
-          spans: spanNames,
-          annotations: ann,
-        }
-        store.logs.push(log)
-        Effect.runSync(PubSub.publish(store.events, { _tag: "Log", log }))
-      },
-    )
-
-    yield* FiberRef.update(FiberRef.currentLoggers, (loggers) => HashSet.add(loggers, logger))
-  }),
-)

package/src/console/ConsoleMetrics.ts

@@ -1,72 +0,0 @@
-import * as Effect from "effect/Effect"
-import * as Layer from "effect/Layer"
-import * as Metric from "effect/Metric"
-import * as MetricKeyType from "effect/MetricKeyType"
-import * as PubSub from "effect/PubSub"
-import * as Schedule from "effect/Schedule"
-import * as ConsoleStore from "./ConsoleStore.ts"
-
-export const layer: Layer.Layer<never, never, ConsoleStore.ConsoleStore> = Layer.scopedDiscard(
-  Effect.gen(function* () {
-    const store = yield* ConsoleStore.ConsoleStore
-
-    yield* Effect.forkScoped(
-      Effect.schedule(
-        Effect.sync(() => {
-          const pairs = Metric.unsafeSnapshot()
-          const snapshots: Array<ConsoleStore.ConsoleMetricSnapshot> = []
-
-          for (const pair of pairs) {
-            const key = pair.metricKey
-            const state = pair.metricState as any
-            let type: ConsoleStore.ConsoleMetricSnapshot["type"] = "counter"
-            let value: unknown = 0
-
-            if (MetricKeyType.CounterKeyTypeTypeId in key.keyType) {
-              type = "counter"
-              value = state.count
-            } else if (MetricKeyType.GaugeKeyTypeTypeId in key.keyType) {
-              type = "gauge"
-              value = state.value
-            } else if (MetricKeyType.HistogramKeyTypeTypeId in key.keyType) {
-              type = "histogram"
-              value = {
-                buckets: state.buckets,
-                count: state.count,
-                sum: state.sum,
-                min: state.min,
-                max: state.max,
-              }
-            } else if (MetricKeyType.FrequencyKeyTypeTypeId in key.keyType) {
-              type = "frequency"
-              value = Object.fromEntries(state.occurrences)
-            } else if (MetricKeyType.SummaryKeyTypeTypeId in key.keyType) {
-              type = "summary"
-              value = {
-                quantiles: state.quantiles,
-                count: state.count,
-                sum: state.sum,
-                min: state.min,
-                max: state.max,
-              }
-            }
-
-            snapshots.push({
-              name: key.name,
-              type,
-              value,
-              tags: key.tags.map((t: any) => ({ key: t.key, value: t.value })),
-              timestamp: Date.now(),
-            })
-          }
-
-          store.metrics = snapshots
-          Effect.runSync(
-            PubSub.publish(store.events, { _tag: "MetricsSnapshot", metrics: snapshots }),
-          )
-        }),
-        Schedule.spaced("2 seconds"),
-      ),
-    )
-  }),
-)

package/src/console/ConsoleProcess.ts

@@ -1,59 +0,0 @@
-import * as NOS from "node:os"
-import * as Effect from "effect/Effect"
-import * as Layer from "effect/Layer"
-import * as PubSub from "effect/PubSub"
-import * as Schedule from "effect/Schedule"
-import * as ConsoleStore from "./ConsoleStore.ts"
-
-function snapshot(): ConsoleStore.ProcessStats {
-  const mem = process.memoryUsage()
-  const cpu = process.cpuUsage()
-  const res = process.resourceUsage()
-  const loadavg = NOS.loadavg() as [number, number, number]
-  return {
-    pid: process.pid,
-    uptime: process.uptime(),
-    memory: {
-      rss: mem.rss,
-      heapUsed: mem.heapUsed,
-      heapTotal: mem.heapTotal,
-      external: mem.external,
-      arrayBuffers: mem.arrayBuffers,
-    },
-    cpu: { user: cpu.user, system: cpu.system },
-    resourceUsage: {
-      maxRSS: res.maxRSS,
-      minorPageFault: res.minorPageFault,
-      majorPageFault: res.majorPageFault,
-      fsRead: res.fsRead,
-      fsWrite: res.fsWrite,
-      voluntaryContextSwitches: res.voluntaryContextSwitches,
-      involuntaryContextSwitches: res.involuntaryContextSwitches,
-    },
-    system: {
-      loadavg,
-      freemem: NOS.freemem(),
-      totalmem: NOS.totalmem(),
-      cpuCount: NOS.cpus().length,
-      platform: NOS.platform(),
-      arch: NOS.arch(),
-    },
-  }
-}
-
-export const layer: Layer.Layer<never, never, ConsoleStore.ConsoleStore> = Layer.scopedDiscard(
-  Effect.gen(function* () {
-    const store = yield* ConsoleStore.ConsoleStore
-
-    yield* Effect.forkScoped(
-      Effect.schedule(
-        Effect.sync(() => {
-          const stats = snapshot()
-          store.process = stats
-          Effect.runSync(PubSub.publish(store.events, { _tag: "ProcessSnapshot", stats }))
-        }),
-        Schedule.spaced("2 seconds"),
-      ),
-    )
-  }),
-)

package/src/console/ConsoleStore.ts

@@ -1,187 +0,0 @@
-import * as Context from "effect/Context"
-import * as Effect from "effect/Effect"
-import * as GlobalValue from "effect/GlobalValue"
-import * as Layer from "effect/Layer"
-import * as MutableRef from "effect/MutableRef"
-import * as PubSub from "effect/PubSub"
-
-export const store: ConsoleStoreShape = GlobalValue.globalValue(
-  Symbol.for("effect-start/ConsoleStore"),
-  () => ({
-    prefix: "/console",
-    spans: new CircularBuffer<ConsoleSpan>(1000),
-    logs: new CircularBuffer<ConsoleLog>(5000),
-    errors: new CircularBuffer<ConsoleError>(1000),
-    metrics: [] as Array<ConsoleMetricSnapshot>,
-    process: undefined as ProcessStats | undefined,
-    events: Effect.runSync(PubSub.unbounded<ConsoleEvent>()),
-    fiberParents: new Map<string, string>(),
-    fiberContexts: new Map<string, FiberContext>(),
-  }),
-)
-
-export interface ConsoleSpan {
-  readonly spanId: string
-  readonly traceId: string
-  readonly name: string
-  readonly kind: string
-  readonly parentSpanId: string | undefined
-  startTime: bigint
-  endTime: bigint | undefined
-  durationMs: number | undefined
-  status: "started" | "ok" | "error"
-  readonly attributes: Record<string, unknown>
-  readonly events: Array<{ name: string; startTime: bigint; attributes?: Record<string, unknown> }>
-}
-
-export interface ConsoleLog {
-  readonly id: string
-  readonly date: Date
-  readonly level: "DEBUG" | "INFO" | "WARNING" | "ERROR" | "FATAL"
-  readonly message: string
-  readonly fiberId: string
-  readonly cause: string | undefined
-  readonly spans: Array<string>
-  readonly annotations: Record<string, unknown>
-}
-
-export interface ProcessStats {
-  readonly pid: number
-  readonly uptime: number
-  readonly memory: {
-    readonly rss: number
-    readonly heapUsed: number
-    readonly heapTotal: number
-    readonly external: number
-    readonly arrayBuffers: number
-  }
-  readonly cpu: { readonly user: number; readonly system: number }
-  readonly resourceUsage: {
-    readonly maxRSS: number
-    readonly minorPageFault: number
-    readonly majorPageFault: number
-    readonly fsRead: number
-    readonly fsWrite: number
-    readonly voluntaryContextSwitches: number
-    readonly involuntaryContextSwitches: number
-  }
-  readonly system: {
-    readonly loadavg: readonly [number, number, number]
-    readonly freemem: number
-    readonly totalmem: number
-    readonly cpuCount: number
-    readonly platform: string
-    readonly arch: string
-  }
-}
-
-export interface ConsoleErrorDetail {
-  readonly kind: "fail" | "die"
-  readonly tag: string | undefined
-  readonly message: string
-  readonly properties: Record<string, unknown>
-  readonly span: string | undefined
-}
-
-export interface ConsoleError {
-  readonly id: string
-  readonly date: Date
-  readonly fiberId: string
-  readonly interrupted: boolean
-  readonly prettyPrint: string
-  readonly details: Array<ConsoleErrorDetail>
-}
-
-export interface ConsoleMetricSnapshot {
-  readonly name: string
-  readonly type: "counter" | "gauge" | "histogram" | "summary" | "frequency"
-  readonly value: unknown
-  readonly tags: ReadonlyArray<{ key: string; value: string }>
-  readonly timestamp: number
-}
-
-export type ConsoleEvent =
-  | { readonly _tag: "SpanStart"; readonly span: ConsoleSpan }
-  | { readonly _tag: "SpanEnd"; readonly span: ConsoleSpan }
-  | { readonly _tag: "Log"; readonly log: ConsoleLog }
-  | { readonly _tag: "Error"; readonly error: ConsoleError }
-  | { readonly _tag: "MetricsSnapshot"; readonly metrics: Array<ConsoleMetricSnapshot> }
-  | { readonly _tag: "ProcessSnapshot"; readonly stats: ProcessStats }
-
-export class CircularBuffer<T> {
-  private buffer: Array<T | undefined>
-  private head = 0
-  private count = 0
-  capacity: number
-
-  constructor(capacity: number) {
-    this.capacity = capacity
-    this.buffer = Array.from({ length: capacity })
-  }
-
-  push(item: T): void {
-    this.buffer[this.head] = item
-    this.head = (this.head + 1) % this.capacity
-    if (this.count < this.capacity) this.count++
-  }
-
-  toArray(): Array<T> {
-    if (this.count === 0) return []
-    const result: Array<T> = []
-    const start = this.count < this.capacity ? 0 : this.head
-    for (let i = 0; i < this.count; i++) {
-      result.push(this.buffer[(start + i) % this.capacity]!)
-    }
-    return result
-  }
-
-  get size(): number {
-    return this.count
-  }
-}
-
-export interface FiberContext {
-  readonly spanName: string | undefined
-  readonly traceId: string | undefined
-  readonly annotations: Record<string, unknown>
-}
-
-export interface ConsoleStoreShape {
-  prefix: string
-  readonly spans: CircularBuffer<ConsoleSpan>
-  readonly logs: CircularBuffer<ConsoleLog>
-  readonly errors: CircularBuffer<ConsoleError>
-  metrics: Array<ConsoleMetricSnapshot>
-  process: ProcessStats | undefined
-  readonly events: PubSub.PubSub<ConsoleEvent>
-  readonly fiberParents: Map<string, string>
-  readonly fiberContexts: Map<string, FiberContext>
-}
-
-export function fiberIdCounter(): number {
-  const counter = GlobalValue.globalValue(Symbol.for("effect/Fiber/Id/_fiberCounter"), () =>
-    MutableRef.make(0),
-  )
-  return MutableRef.get(counter)
-}
-
-export class ConsoleStore extends Context.Tag("effect-start/ConsoleStore")<
-  ConsoleStore,
-  ConsoleStoreShape
->() {}
-
-export interface ConsoleStoreOptions {
-  readonly spanCapacity?: number
-  readonly logCapacity?: number
-  readonly errorCapacity?: number
-}
-
-export function layer(options?: ConsoleStoreOptions): Layer.Layer<ConsoleStore> {
-  if (options?.spanCapacity)
-    (store as any).spans = new CircularBuffer<ConsoleSpan>(options.spanCapacity)
-  if (options?.logCapacity)
-    (store as any).logs = new CircularBuffer<ConsoleLog>(options.logCapacity)
-  if (options?.errorCapacity)
-    (store as any).errors = new CircularBuffer<ConsoleError>(options.errorCapacity)
-  return Layer.sync(ConsoleStore, () => store)
-}

package/src/console/ConsoleTracer.ts

@@ -1,107 +0,0 @@
-import * as Effect from "effect/Effect"
-import * as Exit from "effect/Exit"
-import * as Fiber from "effect/Fiber"
-import * as FiberId from "effect/FiberId"
-import * as Layer from "effect/Layer"
-import * as Option from "effect/Option"
-import * as PubSub from "effect/PubSub"
-import * as Tracer from "effect/Tracer"
-import * as ConsoleStore from "./ConsoleStore.ts"
-
-const publish = (store: ConsoleStore.ConsoleStoreShape, event: ConsoleStore.ConsoleEvent) =>
-  Effect.runSync(PubSub.publish(store.events, event))
-
-const make = (store: ConsoleStore.ConsoleStoreShape): Tracer.Tracer =>
-  Tracer.make({
-    span(name, parent, context, links, startTime, kind, options) {
-      const parentSpanId =
-        Option.isSome(parent) && parent.value._tag === "Span" ? parent.value.spanId : undefined
-      const traceId = Option.isSome(parent)
-        ? parent.value.traceId
-        : Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2)
-      const spanId = Math.random().toString(36).slice(2)
-
-      const attributes: Record<string, unknown> = {}
-      const currentFiber = Fiber.getCurrentFiber()
-      if (Option.isSome(currentFiber)) {
-        attributes["fiber.id"] = FiberId.threadName(currentFiber.value.id())
-      }
-      if (typeof options?.captureStackTrace === "function") {
-        const stacktrace = options.captureStackTrace()
-        if (stacktrace) {
-          attributes["code.stacktrace"] = stacktrace
-        }
-      }
-
-      const consoleSpan: ConsoleStore.ConsoleSpan = {
-        spanId,
-        traceId,
-        name,
-        kind,
-        parentSpanId,
-        startTime,
-        endTime: undefined,
-        durationMs: undefined,
-        status: "started",
-        attributes,
-        events: [],
-      }
-
-      store.spans.push(consoleSpan)
-      publish(store, { _tag: "SpanStart", span: consoleSpan })
-
-      const attrs = new Map<string, unknown>(Object.entries(attributes))
-      const spanLinks = [...links]
-
-      const span: Tracer.Span = {
-        _tag: "Span",
-        name,
-        spanId,
-        traceId,
-        parent,
-        context,
-        get status(): Tracer.SpanStatus {
-          if (consoleSpan.endTime != null) {
-            return {
-              _tag: "Ended",
-              startTime: consoleSpan.startTime,
-              endTime: consoleSpan.endTime,
-              exit: Exit.void,
-            }
-          }
-          return { _tag: "Started", startTime: consoleSpan.startTime }
-        },
-        attributes: attrs,
-        links: spanLinks,
-        sampled: true,
-        kind,
-        end(endTime, exit) {
-          consoleSpan.endTime = endTime
-          consoleSpan.durationMs = Number(endTime - consoleSpan.startTime) / 1_000_000
-          consoleSpan.status = Exit.isSuccess(exit) ? "ok" : "error"
-          publish(store, { _tag: "SpanEnd", span: consoleSpan })
-        },
-        attribute(key, value) {
-          attrs.set(key, value)
-          ;(consoleSpan.attributes as Record<string, unknown>)[key] = value
-        },
-        event(name, startTime, attributes) {
-          consoleSpan.events.push({ name, startTime, attributes })
-        },
-        addLinks(newLinks) {
-          spanLinks.push(...newLinks)
-        },
-      }
-      return span
-    },
-    context(f) {
-      return f()
-    },
-  })
-
-export const layer: Layer.Layer<never, never, ConsoleStore.ConsoleStore> = Layer.unwrapEffect(
-  Effect.gen(function* () {
-    const store = yield* ConsoleStore.ConsoleStore
-    return Layer.setTracer(make(store))
-  }),
-)