brass-runtime 1.16.0 → 1.17.0

package/dist/chunk-5QC7LRZ3.js

@@ -0,0 +1,229 @@
+import {
+  makeRuntimeEventRecord
+} from "./chunk-RKGKFN2A.js";
+import {
+  emptyContext,
+  getCurrentFiber
+} from "./chunk-FH2X7BVP.js";
+import {
+  Cause,
+  asyncFlatMap,
+  asyncSync
+} from "./chunk-UB4B6OFY.js";
+
+// src/core/runtime/fiberRef.ts
+var nextFiberRefId = 1;
+function makeFiberRef(initial) {
+  const ref = {
+    id: nextFiberRefId++,
+    initial,
+    get: () => getFiberRef(ref),
+    set: (value) => setFiberRef(ref, value),
+    update: (f) => updateFiberRef(ref, f),
+    modify: (f) => modifyFiberRef(ref, f),
+    locally: (value, effect) => locallyFiberRef(ref, value, effect),
+    locallyWith: (f, effect) => locallyFiberRefWith(ref, f, effect),
+    unsafeGet: () => unsafeGetFiberRef(ref),
+    unsafeSet: (value) => unsafeSetFiberRef(ref, value)
+  };
+  return ref;
+}
+function getFiberRef(ref) {
+  return asyncSync(() => unsafeGetFiberRef(ref));
+}
+function setFiberRef(ref, value) {
+  return asyncSync(() => {
+    unsafeSetFiberRef(ref, value);
+  });
+}
+function updateFiberRef(ref, f) {
+  return asyncSync(() => {
+    const next = f(unsafeGetFiberRef(ref));
+    unsafeSetFiberRef(ref, next);
+    return next;
+  });
+}
+function modifyFiberRef(ref, f) {
+  return asyncSync(() => {
+    const [result, next] = f(unsafeGetFiberRef(ref));
+    unsafeSetFiberRef(ref, next);
+    return result;
+  });
+}
+function locallyFiberRef(ref, value, effect) {
+  return {
+    _tag: "FiberRefLocally",
+    refId: ref.id,
+    value,
+    effect
+  };
+}
+function locallyFiberRefWith(ref, f, effect) {
+  return asyncFlatMap(getFiberRef(ref), (value) => locallyFiberRef(ref, f(value), effect));
+}
+function unsafeGetFiberRef(ref) {
+  const refs = currentFiberRefs(false);
+  return refs?.has(ref.id) ? refs.get(ref.id) : ref.initial;
+}
+function unsafeSetFiberRef(ref, value) {
+  const refs = currentFiberRefs(true);
+  refs?.set(ref.id, value);
+}
+function fiberRefSnapshot() {
+  return new Map(currentFiberRefs(false));
+}
+function currentFiberRefs(create) {
+  const fiber = getCurrentFiber();
+  if (!fiber) return void 0;
+  fiber.fiberContext ??= { log: emptyContext, trace: null };
+  if (!fiber.fiberContext.fiberRefs && create) fiber.fiberContext.fiberRefs = /* @__PURE__ */ new Map();
+  return fiber.fiberContext.fiberRefs;
+}
+
+// src/core/runtime/recorder.ts
+function makeRuntimeRecorder(options = {}) {
+  const capacity = Math.max(1, Math.floor(options.maxEvents ?? 2048));
+  const records = new Array(capacity);
+  let next = 0;
+  let size = 0;
+  let dropped = 0;
+  let seq = 1;
+  const snapshot = () => {
+    const out = [];
+    const start = size === capacity ? next : 0;
+    for (let i = 0; i < size; i++) {
+      const record = records[(start + i) % capacity];
+      if (record) out.push(record);
+    }
+    return out;
+  };
+  const emit = (ev, ctx) => {
+    records[next] = makeRuntimeEventRecord(ev, ctx, seq++);
+    next = (next + 1) % capacity;
+    if (size < capacity) size++;
+    else dropped++;
+  };
+  const clear = () => {
+    records.fill(void 0);
+    next = 0;
+    size = 0;
+    dropped = 0;
+  };
+  const stats = () => {
+    const current = snapshot();
+    return {
+      size,
+      capacity,
+      dropped,
+      ...current[0] ? { firstSeq: current[0].seq } : {},
+      ...current[current.length - 1] ? { lastSeq: current[current.length - 1].seq } : {}
+    };
+  };
+  const recorder = {
+    emit,
+    snapshot,
+    clear,
+    stats,
+    explain: (explainOptions = {}) => explainRuntimeEvents(snapshot(), dropped, explainOptions)
+  };
+  return Object.assign(recorder, { hooks: recorder });
+}
+function explainRuntimeEvents(events, dropped, options) {
+  const maxEvents = Math.max(1, Math.floor(options.maxEvents ?? 80));
+  const slice = events.length > maxEvents ? events.slice(events.length - maxEvents) : events;
+  const fiberStarts = /* @__PURE__ */ new Map();
+  const fiberSuspends = /* @__PURE__ */ new Map();
+  const lines = [`Runtime flight recorder: ${events.length} event${events.length === 1 ? "" : "s"}${dropped > 0 ? `, ${dropped} dropped` : ""}.`];
+  for (const event of slice) {
+    switch (event.type) {
+      case "fiber.start": {
+        fiberStarts.set(event.fiberId, event);
+        lines.push(`fiber#${event.fiberId} started${event.name ? ` "${event.name}"` : ""}${event.parentFiberId !== void 0 ? ` parent=fiber#${event.parentFiberId}` : ""}`);
+        break;
+      }
+      case "fiber.suspend": {
+        fiberSuspends.set(event.fiberId, event);
+        lines.push(`fiber#${event.fiberId} suspended awaiting ${event.reason ?? "unknown"}`);
+        break;
+      }
+      case "fiber.resume": {
+        const suspended = fiberSuspends.get(event.fiberId);
+        fiberSuspends.delete(event.fiberId);
+        lines.push(`fiber#${event.fiberId} resumed${suspended ? ` after ${durationMs(suspended, event)} awaiting ${fiberSuspendReason(suspended)}` : ""}`);
+        break;
+      }
+      case "fiber.end": {
+        const started = fiberStarts.get(event.fiberId);
+        const suspended = fiberSuspends.get(event.fiberId);
+        fiberSuspends.delete(event.fiberId);
+        lines.push(`fiber#${event.fiberId} ended ${event.status}${started ? ` after ${durationMs(started, event)}` : ""}${suspended ? ` while awaiting ${fiberSuspendReason(suspended)}` : ""}${event.error ? ` error=${formatUnknown(event.error)}` : ""}`);
+        break;
+      }
+      case "scope.open":
+        lines.push(`scope#${event.scopeId} opened${event.parentScopeId !== void 0 ? ` parent=scope#${event.parentScopeId}` : ""}`);
+        break;
+      case "scope.close":
+        lines.push(`scope#${event.scopeId} closed ${event.status}${event.error ? ` error=${formatUnknown(event.error)}` : ""}`);
+        break;
+      case "supervisor.child.restart":
+        lines.push(`supervisor#${event.supervisorId} restarting child#${event.childId} attempt=${event.restartCount} delay=${event.delayMs}ms${event.reason ? ` reason=${event.reason}` : ""}`);
+        break;
+      case "supervisor.child.escalate":
+        lines.push(`supervisor#${event.supervisorId} escalated child#${event.childId}${event.reason ? ` reason=${event.reason}` : ""}${event.error ? ` error=${formatUnknown(event.error)}` : ""}`);
+        break;
+      case "schedule.decision":
+        lines.push(`schedule${event.name ? ` "${event.name}"` : ""} attempt=${event.attempt} ${event.continue ? "continues" : "stops"} delay=${event.delayMs}ms elapsed=${Math.round(event.elapsedMs)}ms${event.reason ? ` reason=${event.reason}` : ""}`);
+        break;
+      case "log":
+        if (event.level === "warn" || event.level === "error") {
+          lines.push(`${event.level}: ${event.message ?? ""}${event.fields ? ` ${JSON.stringify(event.fields)}` : ""}`);
+        }
+        break;
+      case "span.start":
+        lines.push(`span started "${event.name}"${event.traceId ? ` trace=${event.traceId}` : ""}`);
+        break;
+      case "span.end":
+        lines.push(`span ended ${event.status}${event.name ? ` "${event.name}"` : ""}${event.error ? ` error=${formatUnknown(event.error)}` : ""}`);
+        break;
+      default:
+        break;
+    }
+  }
+  for (const suspended of fiberSuspends.values()) {
+    lines.push(`fiber#${suspended.fiberId} still suspended for ${durationFromNowMs(suspended)} awaiting ${fiberSuspendReason(suspended)}`);
+  }
+  return lines.join("\n");
+}
+function durationMs(start, end) {
+  return `${Math.max(0, Math.round(end.wallTs - start.wallTs))}ms`;
+}
+function durationFromNowMs(start) {
+  return `${Math.max(0, Math.round(Date.now() - start.wallTs))}ms`;
+}
+function formatUnknown(value) {
+  if (Cause.isCause(value)) return Cause.pretty(value, { singleLine: true });
+  if (value instanceof Error) return value.message;
+  if (typeof value === "string") return value;
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return String(value);
+  }
+}
+function fiberSuspendReason(record) {
+  return record.type === "fiber.suspend" ? record.reason ?? "unknown" : "unknown";
+}
+
+export {
+  makeFiberRef,
+  getFiberRef,
+  setFiberRef,
+  updateFiberRef,
+  modifyFiberRef,
+  locallyFiberRef,
+  locallyFiberRefWith,
+  unsafeGetFiberRef,
+  unsafeSetFiberRef,
+  fiberRefSnapshot,
+  makeRuntimeRecorder
+};