@alloy-js/core 0.23.0-dev.10 → 0.23.0-dev.11

package/src/debug/trace.ts

@@ -2,14 +2,20 @@
  * Trace helpers and configuration.
  */
 import type { ServerToClientMessage } from "../devtools/devtools-protocol.js";
-import {
-  broadcastDevtoolsMessage,
-  isDevtoolsEnabled,
-  type DevtoolsMessage,
-} from "../devtools/devtools-server.js";
+import { isDevtoolsEnabled } from "../devtools/devtools-server.js";
 import { untrack } from "../reactivity.js";
+import { initTrace, isTraceEnabled } from "./trace-writer.js";
 
 export { isDevtoolsEnabled } from "../devtools/devtools-server.js";
+export { isTraceEnabled } from "./trace-writer.js";
+
+/**
+ * Returns true when any debug instrumentation is active:
+ * devtools, console trace, or ALLOY_DEBUG_TRACE.
+ */
+export function isDebugEnabled(): boolean {
+  return isDevtoolsEnabled() || isConsoleTraceEnabled() || isTraceEnabled();
+}
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Environment configuration
@@ -58,6 +64,19 @@ if (tracePhases.size > 0) {
   );
 }
 
+// Initialize SQLite trace writer if ALLOY_DEBUG_TRACE is set
+const traceDbEnv = process.env.ALLOY_DEBUG_TRACE;
+if (traceDbEnv) {
+  const traceDbPath =
+    traceDbEnv === "1" || traceDbEnv === "true" ? "alloy-trace.db" : traceDbEnv;
+  try {
+    await initTrace(traceDbPath);
+  } catch (e) {
+    // eslint-disable-next-line no-console
+    console.warn(`Failed to initialize trace database at ${traceDbPath}:`, e);
+  }
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Trace phases
 // ─────────────────────────────────────────────────────────────────────────────
@@ -240,7 +259,7 @@ export function traceType(phase: TracePhaseInfo): string {
 }
 
 export function logDevtoolsMessage(
-  message: ServerToClientMessage | DevtoolsMessage,
+  message: ServerToClientMessage | { type: string; [key: string]: unknown },
 ) {
   if (!isConsoleTraceEnabled()) return;
   const type = String(message.type ?? "");
@@ -254,21 +273,6 @@ export function logDevtoolsMessage(
   console.log("devtools:", message.type, message);
 }
 
-/**
- * Emit a devtools message. Logs to console if tracing is enabled for the
- * message's area, and broadcasts over the WebSocket if devtools are connected.
- *
- * Accepts both strictly-typed protocol messages and loosely-typed trace
- * messages (which construct the type string dynamically).
- */
-export function emitDevtoolsMessage(
-  message: ServerToClientMessage | DevtoolsMessage,
-) {
-  logDevtoolsMessage(message);
-  if (!isDevtoolsEnabled()) return;
-  broadcastDevtoolsMessage(message as DevtoolsMessage);
-}
-
 /**
  * Low-level trace function for emitting console output.
  * Use the `debug` object methods for most use cases.
@@ -302,11 +306,4 @@ export function trace(
         "\n",
     );
   }
-
-  if (isDevtoolsEnabled()) {
-    broadcastDevtoolsMessage({
-      type: traceType(phase),
-      triggerIds: [...triggerIds],
-    });
-  }
 }