@yetanotheraryan/coldstart 1.0.0

package/dist/cli.js

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/cli.ts
+var import_fs = require("fs");
+var import_os = require("os");
+var import_path = require("path");
+var import_child_process = require("child_process");
+
+// src/reporter/json.ts
+function renderJsonReport(report, options2 = {}) {
+  return `${JSON.stringify(report, jsonReplacer, options2.pretty === false ? 0 : 2)}
+`;
+}
+function jsonReplacer(_key, value) {
+  if (typeof value === "number" && !Number.isFinite(value)) {
+    return 0;
+  }
+  return value;
+}
+
+// src/reporter/text.ts
+var BAR_WIDTH = 18;
+var ANSI_RESET = "\x1B[0m";
+var ANSI_RED = "\x1B[31m";
+var ANSI_YELLOW = "\x1B[33m";
+var ANSI_GREEN = "\x1B[32m";
+var ANSI_DIM = "\x1B[2m";
+function renderTextReport(report, options2 = {}) {
+  const color = options2.color ?? true;
+  const barWidth = options2.barWidth ?? BAR_WIDTH;
+  const showSummary = options2.showSummary ?? true;
+  const displayTree = collapseDisplayNoise(report.tree);
+  const maxInclusiveMs = Math.max(
+    1,
+    ...report.flat.filter((node) => !node.cached).map((node) => node.inclusiveMs)
+  );
+  const lines = [
+    `coldstart - ${formatDuration(report.totalStartupMs)} total startup`,
+    ""
+  ];
+  for (let index = 0; index < displayTree.length; index += 1) {
+    const isLastRoot = index === displayTree.length - 1;
+    const root = displayTree[index];
+    lines.push(...renderNode(root, "", isLastRoot, maxInclusiveMs, barWidth, color));
+  }
+  if (showSummary) {
+    if (displayTree.length > 0) {
+      lines.push("");
+    }
+    lines.push(
+      `${dim("event loop")} max ${formatDuration(report.eventLoop.maxBlockMs)}, p99 ${formatDuration(report.eventLoop.p99BlockMs)}, mean ${formatDuration(report.eventLoop.meanBlockMs)}`,
+      `${dim("modules")} ${report.totalModulesLoaded} total, ${report.cachedModulesCount} cached`,
+      `${dim("time split")} ${formatDuration(report.firstPartyTime)} first-party, ${formatDuration(report.nodeModuleTime)} node_modules`
+    );
+  }
+  return lines.join("\n");
+  function dim(value) {
+    return colorize(value, ANSI_DIM, color);
+  }
+}
+function collapseDisplayNoise(nodes) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const node of nodes) {
+    const collapsedChildren = collapseDisplayNoise(node.children);
+    const collapsedNode = {
+      ...node,
+      children: collapsedChildren
+    };
+    if (shouldCollapseBuiltinNode(collapsedNode)) {
+      const key = [
+        collapsedNode.request,
+        collapsedNode.depth
+      ].join("|");
+      if (seen.has(key)) {
+        continue;
+      }
+      seen.add(key);
+    }
+    result.push(collapsedNode);
+  }
+  return result;
+}
+function shouldCollapseBuiltinNode(node) {
+  return node.isBuiltin && node.cached && node.inclusiveMs === 0 && node.children.length === 0;
+}
+function renderNode(node, prefix, isLast, maxInclusiveMs, barWidth, color) {
+  const branch = prefix.length === 0 ? isLast ? "\u2514\u2500 " : "\u250C\u2500 " : `${prefix}${isLast ? "\u2514\u2500 " : "\u251C\u2500 "}`;
+  const nextPrefix = prefix.length === 0 ? isLast ? "   " : "\u2502  " : `${prefix}${isLast ? "   " : "\u2502  "}`;
+  const label = formatLabel(node);
+  const duration = formatDuration(node.inclusiveMs).padStart(6);
+  const durationColor = getDurationColor(node.inclusiveMs);
+  const bar = renderBar(node.inclusiveMs, maxInclusiveMs, barWidth);
+  const suffix = node.inclusiveMs >= 100 ? `  ${colorize("! slow", ANSI_RED, color)}` : "";
+  const line = `${branch}${label.padEnd(18)} ${colorize(duration, durationColor, color)}  ${colorize(bar, durationColor, color)}${suffix}`;
+  const lines = [line];
+  for (let index = 0; index < node.children.length; index += 1) {
+    const child = node.children[index];
+    const isLastChild = index === node.children.length - 1;
+    lines.push(...renderNode(child, nextPrefix, isLastChild, maxInclusiveMs, barWidth, color));
+  }
+  return lines;
+}
+function formatLabel(node) {
+  if (node.isBuiltin) {
+    return node.request.replace(/^node:/, "");
+  }
+  if (node.isNodeModule) {
+    return packageNameFromRequest(node.request);
+  }
+  const normalizedPath = normalizeModulePath(node);
+  const segments = normalizedPath.split("/");
+  const base = segments[segments.length - 1] ?? "";
+  return base.length > 0 ? base : node.request;
+}
+function normalizeModulePath(node) {
+  if (looksLikeRelativeRequest(node.request)) {
+    return node.request.replace(/\\/g, "/");
+  }
+  if (node.resolvedPath.startsWith("file://")) {
+    try {
+      return decodeURIComponent(new URL(node.resolvedPath).pathname).replace(/\\/g, "/");
+    } catch {
+      return node.resolvedPath.replace(/\\/g, "/");
+    }
+  }
+  return node.resolvedPath.replace(/\\/g, "/");
+}
+function looksLikeRelativeRequest(request) {
+  return request.startsWith("./") || request.startsWith("../") || request.startsWith("/");
+}
+function packageNameFromRequest(request) {
+  if (request.startsWith("@")) {
+    const [scope, name2] = request.split("/");
+    return name2 ? `${scope}/${name2}` : request;
+  }
+  const [name] = request.split("/");
+  return name || request;
+}
+function renderBar(durationMs, maxInclusiveMs, barWidth) {
+  const filled = Math.max(1, Math.round(durationMs / maxInclusiveMs * barWidth));
+  return `${"\u2588".repeat(Math.min(barWidth, filled))}${"\u2591".repeat(Math.max(0, barWidth - filled))}`;
+}
+function formatDuration(valueMs) {
+  if (!Number.isFinite(valueMs)) {
+    return "0ms";
+  }
+  if (valueMs >= 1e3) {
+    return `${Math.round(valueMs)}ms`;
+  }
+  if (valueMs >= 100) {
+    return `${Math.round(valueMs)}ms`;
+  }
+  if (valueMs >= 10) {
+    return `${valueMs.toFixed(1).replace(/\.0$/, "")}ms`;
+  }
+  return `${valueMs.toFixed(2).replace(/0+$/, "").replace(/\.$/, "")}ms`;
+}
+function getDurationColor(durationMs) {
+  if (durationMs > 100) {
+    return ANSI_RED;
+  }
+  if (durationMs >= 20) {
+    return ANSI_YELLOW;
+  }
+  return ANSI_GREEN;
+}
+function colorize(value, code, enabled) {
+  if (!enabled) {
+    return value;
+  }
+  return `${code}${value}${ANSI_RESET}`;
+}
+
+// src/cli.ts
+var options = parseArgs(process.argv.slice(2));
+if (options.help || options.targetArgs.length === 0) {
+  printHelp(options.targetArgs.length === 0 ? 1 : 0);
+} else {
+  run(options).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`coldstart: ${message}
+`);
+    process.exitCode = 1;
+  });
+}
+async function run(options2) {
+  const tempDir = (0, import_fs.mkdtempSync)((0, import_path.join)((0, import_os.tmpdir)(), "coldstart-"));
+  const reportPath = (0, import_path.join)(tempDir, "startup-report.json");
+  const childArgs = buildChildArgs(options2.targetArgs);
+  const child = (0, import_child_process.spawn)(process.execPath, childArgs, {
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      COLDSTART_REPORT_FILE: reportPath
+    }
+  });
+  const forwardSignal = (signal) => {
+    if (!child.killed) {
+      child.kill(signal);
+    }
+  };
+  process.once("SIGINT", () => forwardSignal("SIGINT"));
+  process.once("SIGTERM", () => forwardSignal("SIGTERM"));
+  const exitInfo = await new Promise((resolvePromise, reject) => {
+    child.once("error", reject);
+    child.once("exit", (code, signal) => resolvePromise({ code, signal }));
+  });
+  let report = null;
+  if ((0, import_fs.existsSync)(reportPath)) {
+    report = JSON.parse((0, import_fs.readFileSync)(reportPath, "utf8"));
+  }
+  (0, import_fs.rmSync)(tempDir, { recursive: true, force: true });
+  if (report) {
+    const output = options2.output === "json" ? renderJsonReport(report) : `${renderTextReport(report, { color: options2.color })}
+`;
+    process.stdout.write(output);
+  } else {
+    process.stderr.write("coldstart: no startup report was captured\n");
+  }
+  if (exitInfo.signal) {
+    process.kill(process.pid, exitInfo.signal);
+    return;
+  }
+  process.exitCode = exitInfo.code ?? 1;
+}
+function parseArgs(argv) {
+  const targetArgs = [];
+  let output = "text";
+  let color = process.stdout.isTTY;
+  let help = false;
+  let passthrough = false;
+  for (const arg of argv) {
+    if (passthrough) {
+      targetArgs.push(arg);
+      continue;
+    }
+    if (arg === "--") {
+      passthrough = true;
+      continue;
+    }
+    if (arg === "--json") {
+      output = "json";
+      continue;
+    }
+    if (arg === "--no-color") {
+      color = false;
+      continue;
+    }
+    if (arg === "--color") {
+      color = true;
+      continue;
+    }
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+      continue;
+    }
+    targetArgs.push(arg);
+  }
+  return { output, color, help, targetArgs };
+}
+function buildChildArgs(targetArgs) {
+  const registerPath = (0, import_path.resolve)(__dirname, "register.mjs");
+  if (targetArgs[0] === "node") {
+    return ["--import", registerPath, ...targetArgs.slice(1)];
+  }
+  return ["--import", registerPath, ...targetArgs];
+}
+function printHelp(exitCode) {
+  const helpText = [
+    "Usage:",
+    "  coldstart [--json] [--no-color] app.js [args...]",
+    "  coldstart [--json] [--no-color] -- node [node-flags...] app.js [args...]",
+    "",
+    "Examples:",
+    "  coldstart server.js",
+    "  coldstart --json server.js",
+    "  coldstart -- node --trace-warnings server.js"
+  ].join("\n");
+  const stream = exitCode === 0 ? process.stdout : process.stderr;
+  stream.write(`${helpText}
+`);
+  process.exit(exitCode);
+}

package/dist/cli.mjs

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+import {
+  renderJsonReport,
+  renderTextReport
+} from "./chunk-IGYROJNQ.mjs";
+import {
+  __dirname
+} from "./chunk-B5TADGOF.mjs";
+
+// src/cli.ts
+import { existsSync, mkdtempSync, readFileSync, rmSync } from "fs";
+import { tmpdir } from "os";
+import { join, resolve } from "path";
+import { spawn } from "child_process";
+var options = parseArgs(process.argv.slice(2));
+if (options.help || options.targetArgs.length === 0) {
+  printHelp(options.targetArgs.length === 0 ? 1 : 0);
+} else {
+  run(options).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`coldstart: ${message}
+`);
+    process.exitCode = 1;
+  });
+}
+async function run(options2) {
+  const tempDir = mkdtempSync(join(tmpdir(), "coldstart-"));
+  const reportPath = join(tempDir, "startup-report.json");
+  const childArgs = buildChildArgs(options2.targetArgs);
+  const child = spawn(process.execPath, childArgs, {
+    stdio: "inherit",
+    env: {
+      ...process.env,
+      COLDSTART_REPORT_FILE: reportPath
+    }
+  });
+  const forwardSignal = (signal) => {
+    if (!child.killed) {
+      child.kill(signal);
+    }
+  };
+  process.once("SIGINT", () => forwardSignal("SIGINT"));
+  process.once("SIGTERM", () => forwardSignal("SIGTERM"));
+  const exitInfo = await new Promise((resolvePromise, reject) => {
+    child.once("error", reject);
+    child.once("exit", (code, signal) => resolvePromise({ code, signal }));
+  });
+  let report = null;
+  if (existsSync(reportPath)) {
+    report = JSON.parse(readFileSync(reportPath, "utf8"));
+  }
+  rmSync(tempDir, { recursive: true, force: true });
+  if (report) {
+    const output = options2.output === "json" ? renderJsonReport(report) : `${renderTextReport(report, { color: options2.color })}
+`;
+    process.stdout.write(output);
+  } else {
+    process.stderr.write("coldstart: no startup report was captured\n");
+  }
+  if (exitInfo.signal) {
+    process.kill(process.pid, exitInfo.signal);
+    return;
+  }
+  process.exitCode = exitInfo.code ?? 1;
+}
+function parseArgs(argv) {
+  const targetArgs = [];
+  let output = "text";
+  let color = process.stdout.isTTY;
+  let help = false;
+  let passthrough = false;
+  for (const arg of argv) {
+    if (passthrough) {
+      targetArgs.push(arg);
+      continue;
+    }
+    if (arg === "--") {
+      passthrough = true;
+      continue;
+    }
+    if (arg === "--json") {
+      output = "json";
+      continue;
+    }
+    if (arg === "--no-color") {
+      color = false;
+      continue;
+    }
+    if (arg === "--color") {
+      color = true;
+      continue;
+    }
+    if (arg === "--help" || arg === "-h") {
+      help = true;
+      continue;
+    }
+    targetArgs.push(arg);
+  }
+  return { output, color, help, targetArgs };
+}
+function buildChildArgs(targetArgs) {
+  const registerPath = resolve(__dirname, "register.mjs");
+  if (targetArgs[0] === "node") {
+    return ["--import", registerPath, ...targetArgs.slice(1)];
+  }
+  return ["--import", registerPath, ...targetArgs];
+}
+function printHelp(exitCode) {
+  const helpText = [
+    "Usage:",
+    "  coldstart [--json] [--no-color] app.js [args...]",
+    "  coldstart [--json] [--no-color] -- node [node-flags...] app.js [args...]",
+    "",
+    "Examples:",
+    "  coldstart server.js",
+    "  coldstart --json server.js",
+    "  coldstart -- node --trace-warnings server.js"
+  ].join("\n");
+  const stream = exitCode === 0 ? process.stdout : process.stderr;
+  stream.write(`${helpText}
+`);
+  process.exit(exitCode);
+}

package/dist/esm-loader.d.mts

@@ -0,0 +1,30 @@
+declare function initialize(data: {
+    port?: MessagePortLike;
+}): Promise<void>;
+declare function resolve(specifier: string, context: {
+    parentURL?: string;
+}, nextResolve: (specifier: string, context: {
+    parentURL?: string;
+}) => Promise<{
+    url: string;
+    format?: string | null;
+}>): Promise<{
+    url: string;
+    format?: string | null;
+}>;
+declare function load(url: string, context: {
+    format?: string | null;
+}, nextLoad: (url: string, context: {
+    format?: string | null;
+}) => Promise<{
+    format: string;
+    source?: string | ArrayBuffer | Uint8Array;
+}>): Promise<{
+    format: string;
+    source?: string | ArrayBuffer | Uint8Array;
+}>;
+interface MessagePortLike {
+    postMessage(message: unknown): void;
+}
+
+export { initialize, load, resolve };

package/dist/esm-loader.d.ts

@@ -0,0 +1,30 @@
+declare function initialize(data: {
+    port?: MessagePortLike;
+}): Promise<void>;
+declare function resolve(specifier: string, context: {
+    parentURL?: string;
+}, nextResolve: (specifier: string, context: {
+    parentURL?: string;
+}) => Promise<{
+    url: string;
+    format?: string | null;
+}>): Promise<{
+    url: string;
+    format?: string | null;
+}>;
+declare function load(url: string, context: {
+    format?: string | null;
+}, nextLoad: (url: string, context: {
+    format?: string | null;
+}) => Promise<{
+    format: string;
+    source?: string | ArrayBuffer | Uint8Array;
+}>): Promise<{
+    format: string;
+    source?: string | ArrayBuffer | Uint8Array;
+}>;
+interface MessagePortLike {
+    postMessage(message: unknown): void;
+}
+
+export { initialize, load, resolve };

package/dist/esm-loader.js

@@ -0,0 +1,125 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/esm-loader.ts
+var esm_loader_exports = {};
+__export(esm_loader_exports, {
+  initialize: () => initialize,
+  load: () => load,
+  resolve: () => resolve
+});
+module.exports = __toCommonJS(esm_loader_exports);
+var import_node_module = require("module");
+var import_node_perf_hooks = require("perf_hooks");
+var port = null;
+async function initialize(data) {
+  port = data.port ?? null;
+}
+async function resolve(specifier, context, nextResolve) {
+  const result = await nextResolve(specifier, context);
+  const isBuiltin = result.format === "builtin" || isBuiltinModule(specifier) || result.url.startsWith("node:");
+  port?.postMessage({
+    type: "resolve",
+    request: specifier,
+    resolvedPath: isBuiltin ? `builtin:${stripNodePrefix(specifier)}` : result.url,
+    parentPath: context.parentURL ?? "<entry>",
+    startTime: import_node_perf_hooks.performance.now(),
+    isBuiltin,
+    isNodeModule: !isBuiltin && result.url.includes("/node_modules/")
+  });
+  return result;
+}
+async function load(url, context, nextLoad) {
+  const result = await nextLoad(url, context);
+  if (result.format !== "module" || typeof result.source === "undefined" || shouldSkipInstrumentation(url)) {
+    return result;
+  }
+  const sourceText = typeof result.source === "string" ? result.source : arrayBufferLikeToString(result.source);
+  return {
+    ...result,
+    source: `${sourceText}
+;globalThis[Symbol.for('coldstart:esm:exit')]?.(${JSON.stringify(url)});
+`
+  };
+}
+function shouldSkipInstrumentation(url) {
+  return url.startsWith("node:") || url.startsWith("data:");
+}
+function stripNodePrefix(value) {
+  return value.startsWith("node:") ? value.slice(5) : value;
+}
+function isBuiltinModule(name) {
+  return import_node_module.Module.isBuiltin?.(name) ?? fallbackBuiltinSet.has(stripNodePrefix(name));
+}
+function arrayBufferLikeToString(source) {
+  if (source instanceof Uint8Array) {
+    return Buffer.from(source).toString("utf8");
+  }
+  return Buffer.from(new Uint8Array(source)).toString("utf8");
+}
+var fallbackBuiltinSet = /* @__PURE__ */ new Set([
+  "assert",
+  "async_hooks",
+  "buffer",
+  "child_process",
+  "cluster",
+  "console",
+  "constants",
+  "crypto",
+  "dgram",
+  "diagnostics_channel",
+  "dns",
+  "domain",
+  "events",
+  "fs",
+  "http",
+  "http2",
+  "https",
+  "inspector",
+  "module",
+  "net",
+  "os",
+  "path",
+  "perf_hooks",
+  "process",
+  "punycode",
+  "querystring",
+  "readline",
+  "repl",
+  "stream",
+  "string_decoder",
+  "sys",
+  "timers",
+  "tls",
+  "trace_events",
+  "tty",
+  "url",
+  "util",
+  "v8",
+  "vm",
+  "wasi",
+  "worker_threads",
+  "zlib"
+]);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  initialize,
+  load,
+  resolve
+});

package/dist/esm-loader.mjs

@@ -0,0 +1,100 @@
+import "./chunk-B5TADGOF.mjs";
+
+// src/esm-loader.ts
+import { Module } from "module";
+import { performance } from "perf_hooks";
+var port = null;
+async function initialize(data) {
+  port = data.port ?? null;
+}
+async function resolve(specifier, context, nextResolve) {
+  const result = await nextResolve(specifier, context);
+  const isBuiltin = result.format === "builtin" || isBuiltinModule(specifier) || result.url.startsWith("node:");
+  port?.postMessage({
+    type: "resolve",
+    request: specifier,
+    resolvedPath: isBuiltin ? `builtin:${stripNodePrefix(specifier)}` : result.url,
+    parentPath: context.parentURL ?? "<entry>",
+    startTime: performance.now(),
+    isBuiltin,
+    isNodeModule: !isBuiltin && result.url.includes("/node_modules/")
+  });
+  return result;
+}
+async function load(url, context, nextLoad) {
+  const result = await nextLoad(url, context);
+  if (result.format !== "module" || typeof result.source === "undefined" || shouldSkipInstrumentation(url)) {
+    return result;
+  }
+  const sourceText = typeof result.source === "string" ? result.source : arrayBufferLikeToString(result.source);
+  return {
+    ...result,
+    source: `${sourceText}
+;globalThis[Symbol.for('coldstart:esm:exit')]?.(${JSON.stringify(url)});
+`
+  };
+}
+function shouldSkipInstrumentation(url) {
+  return url.startsWith("node:") || url.startsWith("data:");
+}
+function stripNodePrefix(value) {
+  return value.startsWith("node:") ? value.slice(5) : value;
+}
+function isBuiltinModule(name) {
+  return Module.isBuiltin?.(name) ?? fallbackBuiltinSet.has(stripNodePrefix(name));
+}
+function arrayBufferLikeToString(source) {
+  if (source instanceof Uint8Array) {
+    return Buffer.from(source).toString("utf8");
+  }
+  return Buffer.from(new Uint8Array(source)).toString("utf8");
+}
+var fallbackBuiltinSet = /* @__PURE__ */ new Set([
+  "assert",
+  "async_hooks",
+  "buffer",
+  "child_process",
+  "cluster",
+  "console",
+  "constants",
+  "crypto",
+  "dgram",
+  "diagnostics_channel",
+  "dns",
+  "domain",
+  "events",
+  "fs",
+  "http",
+  "http2",
+  "https",
+  "inspector",
+  "module",
+  "net",
+  "os",
+  "path",
+  "perf_hooks",
+  "process",
+  "punycode",
+  "querystring",
+  "readline",
+  "repl",
+  "stream",
+  "string_decoder",
+  "sys",
+  "timers",
+  "tls",
+  "trace_events",
+  "tty",
+  "url",
+  "util",
+  "v8",
+  "vm",
+  "wasi",
+  "worker_threads",
+  "zlib"
+]);
+export {
+  initialize,
+  load,
+  resolve
+};