V8 Maglev vs TurboFan: When Tiering Ups Silently Hurt p99

# local / staging — illustrative
node --trace-deopt --trace-opt dist/server.js 2> deopt.log
# look for repeated Optimized => deoptimized on the same function
rg "deoptimiz|not enough type info|wrong map" deopt.log | head

// production-friendly: use V8 logs via diagnostic_channel / perf hooks carefully
import { performance } from "node:perf_hooks";

export function timeHot<T>(name: string, fn: () => T): T {
  const t0 = performance.now();
  try {
    return fn();
  } finally {
    const ms = performance.now() - t0;
    if (ms > 5) metrics.histogram("hot.fn.ms", ms, { name });
  }
}

// ❌ Megamorphic — different shapes hit same function
function total(order: any) {
  return order.cents ?? order.totalCents ?? order.amount * 100;
}

// ✅ Normalize once at the boundary
type Order = { totalCents: number; tenantId: string };
function total(order: Order) {
  return order.totalCents;
}

export function normalize(raw: Record<string, unknown>): Order {
  return {
    totalCents: Number(raw.totalCents ?? raw.cents ?? 0),
    tenantId: String(raw.tenantId),
  };
}

// after listen — optional warmup of JIT for known hot handlers
for (let i = 0; i < 1000; i++) {
  normalize({ totalCents: i, tenantId: "warm" });
  total({ totalCents: i, tenantId: "warm" });
}