@beignet/devtools 0.0.3 → 0.0.4

package/dist/trace-context.js

@@ -1,92 +0,0 @@
-const TRACEPARENT_PATTERN = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
-function createHexId(length) {
-    const bytes = new Uint8Array(length / 2);
-    if (typeof crypto !== "undefined" && "getRandomValues" in crypto) {
-        crypto.getRandomValues(bytes);
-        return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
-    }
-    let value = "";
-    while (value.length < length) {
-        value += Math.floor(Math.random() * 16).toString(16);
-    }
-    return value.slice(0, length);
-}
-function isNonZeroHex(value) {
-    return !/^0+$/.test(value);
-}
-/**
- * Create a non-zero W3C trace ID.
- */
-export function createTraceId() {
-    let traceId = createHexId(32);
-    while (!isNonZeroHex(traceId)) {
-        traceId = createHexId(32);
-    }
-    return traceId;
-}
-/**
- * Create a non-zero W3C span ID.
- */
-export function createSpanId() {
-    let spanId = createHexId(16);
-    while (!isNonZeroHex(spanId)) {
-        spanId = createHexId(16);
-    }
-    return spanId;
-}
-/**
- * Create a W3C traceparent header value.
- */
-export function createTraceparent(args) {
-    return `00-${args.traceId}-${args.spanId}-${args.traceFlags ?? "01"}`;
-}
-/**
- * Parse and validate a W3C traceparent header value.
- */
-export function parseTraceparent(value) {
-    if (!value)
-        return undefined;
-    const normalized = value.trim().toLowerCase();
-    const match = TRACEPARENT_PATTERN.exec(normalized);
-    if (!match)
-        return undefined;
-    const [, traceId, spanId, traceFlags] = match;
-    if (!isNonZeroHex(traceId) || !isNonZeroHex(spanId))
-        return undefined;
-    return {
-        traceId,
-        spanId,
-        traceFlags,
-        traceparent: normalized,
-    };
-}
-/**
- * Create devtools trace context from explicit IDs or an existing traceparent.
- */
-export function createDevtoolsTraceContext(input = {}) {
-    const parsed = parseTraceparent(input.traceparent);
-    const traceId = input.traceId ?? parsed?.traceId ?? createTraceId();
-    const parentSpanId = input.parentSpanId ?? parsed?.spanId;
-    const spanId = input.spanId ?? createSpanId();
-    return {
-        traceId,
-        spanId,
-        ...(parentSpanId ? { parentSpanId } : {}),
-        traceparent: createTraceparent({
-            traceId,
-            spanId,
-            traceFlags: parsed?.traceFlags,
-        }),
-    };
-}
-/**
- * Create child trace context from a parent context.
- */
-export function createChildDevtoolsTraceContext(parent) {
-    return createDevtoolsTraceContext({
-        traceId: parent.traceId,
-        parentSpanId: parent.spanId,
-        traceparent: parent.traceparent,
-    });
-}
-//# sourceMappingURL=trace-context.js.map

package/dist/trace-context.js.map

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

package/src/audit.ts

@@ -1,92 +0,0 @@
-import {
-  type AuditLogEntry,
-  type AuditLogEntryInput,
-  type AuditLogPort,
-  normalizeAuditLogEntry,
-  redactAuditLogEntry,
-} from "@beignet/core/ports";
-import type { DevtoolsPort } from "./index";
-
-/**
- * Options for wrapping an audit log with devtools emission.
- */
-export interface DevtoolsAuditLogOptions {
-  /**
-   * Durable audit log to write first.
-   */
-  audit: AuditLogPort;
-  /**
-   * Optional devtools port that receives audit events.
-   */
-  devtools?: DevtoolsPort;
-  /**
-   * Whether to emit devtools events. Defaults to true.
-   */
-  emit?: boolean;
-  /**
-   * Optional app-owned redactor applied after Beignet's audit redaction.
-   */
-  redact?: (entry: AuditLogEntry) => AuditLogEntry;
-}
-
-function prepareEntry(
-  input: AuditLogEntryInput,
-  redact?: (entry: AuditLogEntry) => AuditLogEntry,
-): AuditLogEntry {
-  const redacted = redactAuditLogEntry(normalizeAuditLogEntry(input));
-  return redact ? redact(redacted) : redacted;
-}
-
-function auditSummary(entry: AuditLogEntry): string {
-  const resource = entry.resource?.id
-    ? `${entry.resource.type}:${entry.resource.id}`
-    : entry.resource?.type;
-  const outcome = entry.outcome === "failure" ? "failed" : "succeeded";
-  return resource
-    ? `${entry.action} ${outcome} for ${resource}`
-    : `${entry.action} ${outcome}`;
-}
-
-/**
- * Wrap an audit log so durable audit writes can also appear in devtools.
- *
- * Devtools observer failures are ignored so audit persistence remains the
- * source of truth.
- */
-export function createDevtoolsAuditLog(
-  options: DevtoolsAuditLogOptions,
-): AuditLogPort {
-  return {
-    async record(input) {
-      const entry = prepareEntry(input, options.redact);
-
-      await options.audit.record(entry);
-
-      if (options.emit === false || !options.devtools) return;
-
-      try {
-        options.devtools.record({
-          type: "custom",
-          watcher: "audit",
-          name: entry.action,
-          label: "Audit",
-          summary: auditSummary(entry),
-          requestId: entry.requestId,
-          traceId: entry.traceId,
-          details: {
-            action: entry.action,
-            actor: entry.actor,
-            tenant: entry.tenant,
-            resource: entry.resource,
-            outcome: entry.outcome,
-            message: entry.message,
-            metadata: entry.metadata,
-            occurredAt: entry.occurredAt.toISOString(),
-          },
-        });
-      } catch {
-        // Devtools is an observer; durable audit writes must not depend on it.
-      }
-    },
-  };
-}

package/src/instrumentation.ts

@@ -1,491 +0,0 @@
-import type { AnyPorts } from "@beignet/core/ports";
-import type {
-  HttpContractConfig,
-  HttpRequestLike,
-  HttpResponseLike,
-  ServerHook,
-} from "@beignet/core/server";
-import type { DevtoolsEventInput, DevtoolsRedactor } from "./events";
-import type { DevtoolsPort } from "./index";
-import { createDevtoolsEvent } from "./provider";
-import {
-  createChildDevtoolsTraceContext,
-  createDevtoolsTraceContext,
-  type DevtoolsTraceContext,
-  type DevtoolsTraceContextInput,
-  parseTraceparent,
-} from "./trace-context";
-import type { BuiltInDevtoolsWatcherName } from "./watchers";
-
-type PortsWithDevtools = AnyPorts & {
-  devtools?: DevtoolsPort;
-};
-
-type ContextWithPorts = {
-  requestId?: string;
-  traceId?: string;
-  spanId?: string;
-  parentSpanId?: string;
-  traceparent?: string;
-  ports?: {
-    devtools?: DevtoolsPort;
-  };
-};
-
-/**
- * Options for server hooks that record request/error events to devtools.
- */
-export interface DevtoolsHooksOptions<Ctx> {
-  /**
-   * Devtools route prefix. Requests under this path are ignored to avoid
-   * filling the timeline with its own polling traffic.
-   *
-   * @default "/api/devtools"
-   */
-  basePath?: string;
-
-  /**
-   * Resolve the request ID used for event correlation.
-   */
-  getRequestId?: (args: {
-    req: HttpRequestLike;
-    ctx?: Ctx;
-    response?: HttpResponseLike;
-  }) => string | undefined;
-
-  /**
-   * Response header used to expose the resolved request ID.
-   *
-   * Pass `false` to avoid writing a header.
-   *
-   * @default "x-request-id"
-   */
-  requestIdHeader?: string | false;
-
-  /**
-   * W3C trace context header used to correlate devtools events with distributed
-   * traces.
-   *
-   * Pass `false` to avoid writing a header.
-   *
-   * @default "traceparent"
-   */
-  traceContextHeader?: string | false;
-
-  /**
-   * Resolve a trace context from request/context/response data.
-   */
-  getTraceContext?: (args: {
-    req: HttpRequestLike;
-    ctx?: Ctx;
-    response?: HttpResponseLike;
-  }) => DevtoolsTraceContextInput | string | undefined;
-
-  /**
-   * Apply a custom redactor to events produced by these hooks. The default
-   * devtools redactor still runs when events are stored.
-   */
-  redact?: DevtoolsRedactor;
-
-  /**
-   * Decide whether to capture a completed request event.
-   */
-  shouldCapture?: (args: {
-    req: HttpRequestLike;
-    ctx?: Ctx;
-    contract: HttpContractConfig;
-    response: HttpResponseLike;
-    error?: unknown;
-  }) => boolean;
-}
-
-/**
- * Use-case run event shape consumed by the devtools observer.
- */
-export interface DevtoolsUseCaseRunEvent<Ctx> {
-  name: string;
-  kind: "command" | "query";
-  phase: "start" | "end" | "error";
-  durationMs?: number;
-  error?: unknown;
-  ctx: Ctx;
-}
-
-/**
- * Options for `createDevtoolsUseCaseObserver(...)`.
- */
-export interface DevtoolsUseCaseObserverOptions<Ctx> {
-  /**
-   * Resolve a devtools port from use-case context.
-   */
-  getDevtools?: (ctx: Ctx) => DevtoolsPort | undefined;
-  /**
-   * Resolve the request ID used for event correlation.
-   */
-  getRequestId?: (ctx: Ctx) => string | undefined;
-  /**
-   * Whether use-case error phases should also emit `error` events.
-   */
-  logErrorEvents?: boolean;
-  /**
-   * Optional redactor applied before events are recorded.
-   */
-  redact?: DevtoolsRedactor;
-}
-
-function getContextRequestId(ctx: unknown): string | undefined {
-  if (!ctx || typeof ctx !== "object") return undefined;
-  const requestId = (ctx as { requestId?: unknown }).requestId;
-  return typeof requestId === "string" ? requestId : undefined;
-}
-
-function getContextDevtools(ctx: unknown): DevtoolsPort | undefined {
-  if (!ctx || typeof ctx !== "object") return undefined;
-  const ports = (ctx as ContextWithPorts).ports;
-  return ports?.devtools;
-}
-
-function getContextTraceContext(
-  ctx: unknown,
-): DevtoolsTraceContextInput | undefined {
-  if (!ctx || typeof ctx !== "object") return undefined;
-  const context = ctx as ContextWithPorts;
-  if (
-    !context.traceId &&
-    !context.spanId &&
-    !context.parentSpanId &&
-    !context.traceparent
-  ) {
-    return undefined;
-  }
-  return {
-    traceId: context.traceId,
-    spanId: context.spanId,
-    parentSpanId: context.parentSpanId,
-    traceparent: context.traceparent,
-  };
-}
-
-function getErrorMessage(error: unknown): string {
-  if (error instanceof Error) return error.message;
-  if (typeof error === "string") return error;
-  return "Unknown error";
-}
-
-function getErrorStack(error: unknown): string | undefined {
-  return error instanceof Error ? error.stack : undefined;
-}
-
-function createRequestId(): string {
-  if (typeof crypto !== "undefined" && "randomUUID" in crypto) {
-    return crypto.randomUUID();
-  }
-  return `${Date.now()}-${Math.random().toString(16).slice(2)}`;
-}
-
-function getPathname(req: HttpRequestLike): string {
-  try {
-    return new URL(req.url).pathname;
-  } catch {
-    return req.url;
-  }
-}
-
-function isDevtoolsPath(pathname: string, basePath: string): boolean {
-  const normalizedBase = basePath.replace(/\/+$/, "");
-  return (
-    pathname === normalizedBase || pathname.startsWith(`${normalizedBase}/`)
-  );
-}
-
-function isWatcherEnabled(
-  devtools: DevtoolsPort,
-  name: BuiltInDevtoolsWatcherName,
-): boolean {
-  return devtools.isWatcherEnabled(name);
-}
-
-/**
- * Create server hooks that record Beignet request and error activity.
- *
- * Devtools routes under `basePath` are ignored so polling and SSE traffic do not
- * fill the event buffer. Request IDs and trace context are also written to
- * response headers unless disabled.
- */
-export function createDevtoolsHooks<
-  Ctx,
-  Ports extends PortsWithDevtools = PortsWithDevtools,
->(options: DevtoolsHooksOptions<Ctx> = {}): ServerHook<Ctx, Ports> {
-  let devtools: DevtoolsPort | undefined;
-  const basePath = options.basePath ?? "/api/devtools";
-  const requestIdHeader = options.requestIdHeader ?? "x-request-id";
-  const traceContextHeader = options.traceContextHeader ?? "traceparent";
-  const generatedRequestIds = new WeakMap<HttpRequestLike, string>();
-  const traceContexts = new WeakMap<HttpRequestLike, DevtoolsTraceContext>();
-
-  const resolveRequestId = (args: {
-    req: HttpRequestLike;
-    ctx?: Ctx;
-    response?: HttpResponseLike;
-  }) => {
-    const headerRequestId =
-      requestIdHeader === false
-        ? undefined
-        : args.req.headers.get(requestIdHeader);
-    const existing =
-      options.getRequestId?.(args) ??
-      getContextRequestId(args.ctx) ??
-      headerRequestId ??
-      generatedRequestIds.get(args.req);
-
-    if (existing) return existing;
-
-    const requestId = createRequestId();
-    generatedRequestIds.set(args.req, requestId);
-    return requestId;
-  };
-
-  const resolveTraceContext = (args: {
-    req: HttpRequestLike;
-    ctx?: Ctx;
-    response?: HttpResponseLike;
-  }) => {
-    const configured = options.getTraceContext?.(args);
-    const configuredContext =
-      typeof configured === "string" ? { traceparent: configured } : configured;
-    const contextTrace = getContextTraceContext(args.ctx);
-    const headerTraceparent =
-      traceContextHeader === false
-        ? undefined
-        : args.req.headers.get(traceContextHeader);
-    const existing = configuredContext ?? contextTrace;
-    const existingTraceparent =
-      existing?.traceparent ?? parseTraceparent(headerTraceparent)?.traceparent;
-
-    if (existing) {
-      const traceContext = createDevtoolsTraceContext({
-        ...existing,
-        traceparent: existingTraceparent,
-      });
-      traceContexts.set(args.req, traceContext);
-      return traceContext;
-    }
-
-    const cached = traceContexts.get(args.req);
-    if (cached) return cached;
-
-    const traceContext = createDevtoolsTraceContext({
-      traceparent: existingTraceparent,
-    });
-    traceContexts.set(args.req, traceContext);
-    return traceContext;
-  };
-
-  const record = (event: DevtoolsEventInput) => {
-    if (!devtools) return;
-    const normalized = createDevtoolsEvent(event);
-    try {
-      devtools.record(options.redact ? options.redact(normalized) : normalized);
-    } catch (error) {
-      devtools.record({
-        type: "error",
-        message: "Devtools hook redactor failed",
-        details: {
-          message: error instanceof Error ? error.message : String(error),
-        },
-      });
-    }
-  };
-
-  return {
-    name: "devtools",
-    onRequest: ({ ports }) => {
-      devtools = ports.devtools;
-      return undefined;
-    },
-    beforeHandle: ({ req, ctx }) => {
-      if (!ctx || typeof ctx !== "object" || Array.isArray(ctx)) {
-        return undefined;
-      }
-
-      const traceContext = resolveTraceContext({ req, ctx });
-      return {
-        ctx: {
-          ...ctx,
-          traceId: traceContext.traceId,
-          spanId: traceContext.spanId,
-          parentSpanId: traceContext.parentSpanId,
-          traceparent: traceContext.traceparent,
-        } as Ctx,
-      };
-    },
-    beforeSend: async ({ req, ctx, response }) => {
-      if (requestIdHeader === false && traceContextHeader === false) {
-        return undefined;
-      }
-
-      const requestId = resolveRequestId({ req, ctx, response });
-      const traceContext = resolveTraceContext({ req, ctx, response });
-      const headers = {
-        ...response.headers,
-        ...(requestIdHeader === false ? {} : { [requestIdHeader]: requestId }),
-        ...(traceContextHeader === false
-          ? {}
-          : { [traceContextHeader]: traceContext.traceparent }),
-      };
-      return {
-        ...response,
-        headers,
-      };
-    },
-    afterSend: async ({ req, ctx, contract, response, error, durationMs }) => {
-      if (!devtools) return;
-
-      const path = getPathname(req);
-      if (isDevtoolsPath(path, basePath)) return;
-
-      const shouldCaptureRequest = isWatcherEnabled(devtools, "requests");
-      const shouldCaptureError =
-        Boolean(error) && isWatcherEnabled(devtools, "errors");
-
-      if (!shouldCaptureRequest && !shouldCaptureError) return;
-
-      if (
-        options.shouldCapture &&
-        !options.shouldCapture({ req, ctx, contract, response, error })
-      ) {
-        return;
-      }
-
-      const requestId = resolveRequestId({ req, ctx, response });
-      const traceContext = resolveTraceContext({ req, ctx, response });
-
-      if (shouldCaptureRequest) {
-        record({
-          type: "request",
-          requestId,
-          traceId: traceContext.traceId,
-          spanId: traceContext.spanId,
-          parentSpanId: traceContext.parentSpanId,
-          traceparent: traceContext.traceparent,
-          method: req.method,
-          path,
-          contractName: contract.name,
-          status: response.status,
-          durationMs,
-          details: {
-            headers: Object.fromEntries(req.headers.entries()),
-          },
-        });
-      }
-
-      if (error && shouldCaptureError) {
-        record({
-          type: "error",
-          requestId,
-          traceId: traceContext.traceId,
-          spanId: traceContext.spanId,
-          parentSpanId: traceContext.parentSpanId,
-          traceparent: traceContext.traceparent,
-          message: getErrorMessage(error),
-          stack: getErrorStack(error),
-          contractName: contract.name,
-        });
-      }
-    },
-  };
-}
-
-/**
- * Create a use-case observer compatible with `createUseCase({ onRun })`.
- */
-export function createDevtoolsUseCaseObserver<Ctx>(
-  options: DevtoolsUseCaseObserverOptions<Ctx> = {},
-): (event: DevtoolsUseCaseRunEvent<Ctx>) => void {
-  const logErrorEvents = options.logErrorEvents ?? true;
-  const activeTraceContexts = new Map<string, DevtoolsTraceContext>();
-
-  return (event) => {
-    const devtools =
-      options.getDevtools?.(event.ctx) ?? getContextDevtools(event.ctx);
-    if (!devtools) return;
-
-    const requestId =
-      options.getRequestId?.(event.ctx) ?? getContextRequestId(event.ctx);
-    const errorMessage =
-      event.phase === "error" ? getErrorMessage(event.error) : undefined;
-    const shouldCaptureUseCase = isWatcherEnabled(devtools, "useCases");
-    const shouldCaptureError =
-      event.phase === "error" &&
-      logErrorEvents &&
-      isWatcherEnabled(devtools, "errors");
-
-    if (!shouldCaptureUseCase && !shouldCaptureError) return;
-
-    const parentTraceContext = getContextTraceContext(event.ctx);
-    const useCaseKey = [
-      requestId ?? "no-request",
-      parentTraceContext?.traceId ?? "no-trace",
-      event.kind,
-      event.name,
-    ].join(":");
-    const traceContext =
-      event.phase === "start"
-        ? createChildDevtoolsTraceContext(parentTraceContext ?? {})
-        : (activeTraceContexts.get(useCaseKey) ??
-          createChildDevtoolsTraceContext(parentTraceContext ?? {}));
-
-    if (event.phase === "start") {
-      activeTraceContexts.set(useCaseKey, traceContext);
-    } else {
-      activeTraceContexts.delete(useCaseKey);
-    }
-
-    const record = (input: DevtoolsEventInput) => {
-      const normalized = createDevtoolsEvent(input);
-      try {
-        devtools.record(
-          options.redact ? options.redact(normalized) : normalized,
-        );
-      } catch (error) {
-        devtools.record({
-          type: "error",
-          message: "Devtools use case redactor failed",
-          details: {
-            message: error instanceof Error ? error.message : String(error),
-          },
-        });
-      }
-    };
-
-    if (shouldCaptureUseCase) {
-      record({
-        type: "usecase",
-        requestId,
-        traceId: traceContext.traceId,
-        spanId: traceContext.spanId,
-        parentSpanId: traceContext.parentSpanId,
-        traceparent: traceContext.traceparent,
-        name: event.name,
-        kind: event.kind,
-        phase: event.phase,
-        durationMs: event.durationMs,
-        error: errorMessage,
-      });
-    }
-
-    if (shouldCaptureError) {
-      record({
-        type: "error",
-        requestId,
-        traceId: traceContext.traceId,
-        spanId: traceContext.spanId,
-        parentSpanId: traceContext.parentSpanId,
-        traceparent: traceContext.traceparent,
-        message: errorMessage ?? "Use case failed",
-        stack: getErrorStack(event.error),
-        useCaseName: event.name,
-      });
-    }
-  };
-}