@warlock.js/core 5.30.0 → 5.32.0

package/esm/tooling/syntax/ast.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/syntax/ast.ts"],"sourcesContent":["import { parseSync, visitorKeys, type Node, type Program } from \"oxc-parser\";\nexport type * from \"oxc-parser\";\n\nexport type SourceFile = Program & { fileName: string; text: string };\nconst parents = new WeakMap<Node, Node>();\nconst sources = new WeakMap<Node, SourceFile>();\n\nexport function forEachChild(node: Node, visit: (node: Node) => void): void {\n  const record = node as unknown as Record<string, unknown>;\n  for (const key of visitorKeys[node.type] ?? []) {\n    const value = record[key];\n    for (const child of Array.isArray(value) ? value : [value]) {\n      if (child && typeof child === \"object\" && \"type\" in child) visit(child as Node);\n    }\n  }\n}\n\nexport function parseSourceFile(fileName: string, text: string): SourceFile {\n  const source = Object.assign(parseSync(fileName, text).program, { fileName, text });\n  const attach = (node: Node): void => {\n    sources.set(node, source);\n    forEachChild(node, (child) => {\n      parents.set(child, node);\n      attach(child);\n    });\n  };\n  attach(source);\n  return source;\n}\nexport function parentOf(node: Node): Node | undefined {\n  return parents.get(node);\n}\nexport function sourceOf(node: Node): SourceFile {\n  const source = sources.get(node);\n  if (!source) throw new Error(\"Node has no source file.\");\n  return source;\n}\nexport function textOf(node: Node): string {\n  return node.type === \"Identifier\" ? node.name : sourceOf(node).text.slice(node.start, node.end);\n}\nexport function keyName(node: Node | null | undefined): string | undefined {\n  if (!node) return undefined;\n  const parent = parentOf(node);\n  if (parent && \"computed\" in parent && parent.computed) return undefined;\n  if (node.type === \"Identifier\" || node.type === \"PrivateIdentifier\") return node.name;\n  if (node.type === \"JSXIdentifier\") return node.name;\n  if (node.type === \"Literal\" && (typeof node.value === \"string\" || typeof node.value === \"number\"))\n    return String(node.value);\n  if (node.type === \"TemplateLiteral\" && node.expressions.length === 0)\n    return node.quasis[0]?.value.cooked ?? undefined;\n  return undefined;\n}\nexport function positionOf(source: SourceFile, node: Node): { line: number; column: number } {\n  const lines = source.text.slice(0, node.start).split(\"\\n\");\n  return { line: lines.length, column: (lines.at(-1)?.length ?? 0) + 1 };\n}\n\nexport function expressionOf(node: Node): Node {\n  if (node.type === \"CallExpression\" || node.type === \"NewExpression\") return node.callee;\n  if (node.type === \"MemberExpression\") return node.object;\n  if (node.type === \"AwaitExpression\" || node.type === \"SpreadElement\") return node.argument;\n  if (node.type === \"IfStatement\") return node.test;\n  if (\"expression\" in node && node.expression && typeof node.expression === \"object\")\n    return node.expression;\n  throw new Error(`No expression on ${node.type}.`);\n}\nexport function nameNode(node: Node): Node {\n  if (\"id\" in node && node.id) return node.id;\n  if (\"key\" in node) return node.key;\n  if (\n    node.type === \"ImportSpecifier\" ||\n    node.type === \"ImportDefaultSpecifier\" ||\n    node.type === \"ImportNamespaceSpecifier\"\n  )\n    return node.local;\n  if (node.type === \"JSXAttribute\") return node.name;\n  throw new Error(`No name on ${node.type}.`);\n}\nexport function declarationName(node: Node): string | undefined {\n  return \"id\" in node && node.id?.type === \"Identifier\" ? node.id.name : undefined;\n}\nexport function valueText(node: Node): string {\n  return keyName(node) ?? (node.type === \"Literal\" ? (node.raw ?? \"\") : textOf(node));\n}\nexport function initializerOf(\n  node: import(\"oxc-parser\").ObjectProperty,\n): import(\"oxc-parser\").Expression;\nexport function initializerOf(node: Node): Node | null;\nexport function initializerOf(node: Node): Node | null {\n  if (node.type === \"Property\") return node.value;\n  if (node.type === \"VariableDeclarator\") return node.init;\n  if (node.type === \"PropertyDefinition\" || node.type === \"JSXAttribute\") return node.value;\n  return null;\n}\n\nexport function isCallExpression(node: Node): node is Node & { type: \"CallExpression\" } {\n  return node.type === \"CallExpression\";\n}\n\nexport function isNewExpression(node: Node): node is Node & { type: \"NewExpression\" } {\n  return node.type === \"NewExpression\";\n}\n\nexport function isIdentifier(node: Node): node is Node & { type: \"Identifier\" } {\n  return node.type === \"Identifier\";\n}\n\nexport function isObjectLiteralExpression(node: Node): node is Node & { type: \"ObjectExpression\" } {\n  return node.type === \"ObjectExpression\";\n}\n\nexport function isVariableDeclaration(node: Node): node is Node & { type: \"VariableDeclarator\" } {\n  return node.type === \"VariableDeclarator\";\n}\n\nexport function isVariableStatement(node: Node): node is Node & { type: \"VariableDeclaration\" } {\n  return node.type === \"VariableDeclaration\";\n}\n\nexport function isImportDeclaration(node: Node): node is Node & { type: \"ImportDeclaration\" } {\n  return node.type === \"ImportDeclaration\";\n}\n\nexport function isPropertyAssignment(\n  node: Node,\n): node is Node & { type: \"Property\"; shorthand: false; method: false; kind: \"init\" } {\n  return node.type === \"Property\" && !node.shorthand && !node.method && node.kind === \"init\";\n}\n\nexport function isShorthandPropertyAssignment(\n  node: Node,\n): node is Node & { type: \"Property\"; shorthand: true } {\n  return node.type === \"Property\" && node.shorthand;\n}\n\nexport function isPropertyDeclaration(node: Node): node is Node & { type: \"PropertyDefinition\" } {\n  return node.type === \"PropertyDefinition\";\n}\n\nexport function isExportAssignment(\n  node: Node,\n): node is Node & { type: \"ExportDefaultDeclaration\" } {\n  return node.type === \"ExportDefaultDeclaration\";\n}\n\nexport function isExportDeclaration(node: Node): node is Node & { type: \"ExportNamedDeclaration\" } {\n  return node.type === \"ExportNamedDeclaration\";\n}\n\nexport function isClassDeclaration(node: Node): node is Node & { type: \"ClassDeclaration\" } {\n  return node.type === \"ClassDeclaration\";\n}\n\nexport function isClassExpression(node: Node): node is Node & { type: \"ClassExpression\" } {\n  return node.type === \"ClassExpression\";\n}\n\nexport function isFunctionDeclaration(node: Node): node is Node & { type: \"FunctionDeclaration\" } {\n  return node.type === \"FunctionDeclaration\";\n}\n\nexport function isFunctionExpression(node: Node): node is Node & { type: \"FunctionExpression\" } {\n  return node.type === \"FunctionExpression\";\n}\n\nexport function isArrowFunction(node: Node): node is Node & { type: \"ArrowFunctionExpression\" } {\n  return node.type === \"ArrowFunctionExpression\";\n}\n\nexport function isInterfaceDeclaration(\n  node: Node,\n): node is Node & { type: \"TSInterfaceDeclaration\" } {\n  return node.type === \"TSInterfaceDeclaration\";\n}\n\nexport function isTypeAliasDeclaration(\n  node: Node,\n): node is Node & { type: \"TSTypeAliasDeclaration\" } {\n  return node.type === \"TSTypeAliasDeclaration\";\n}\n\nexport function isTypeReferenceNode(node: Node): node is Node & { type: \"TSTypeReference\" } {\n  return node.type === \"TSTypeReference\";\n}\n\nexport function isAwaitExpression(node: Node): node is Node & { type: \"AwaitExpression\" } {\n  return node.type === \"AwaitExpression\";\n}\n\nexport function isArrayLiteralExpression(node: Node): node is Node & { type: \"ArrayExpression\" } {\n  return node.type === \"ArrayExpression\";\n}\n\nexport function isSpreadElement(node: Node): node is Node & { type: \"SpreadElement\" } {\n  return node.type === \"SpreadElement\";\n}\n\nexport function isSpreadAssignment(node: Node): node is Node & { type: \"SpreadElement\" } {\n  return node.type === \"SpreadElement\";\n}\n\nexport function isAsExpression(node: Node): node is Node & { type: \"TSAsExpression\" } {\n  return node.type === \"TSAsExpression\";\n}\n\nexport function isNonNullExpression(node: Node): node is Node & { type: \"TSNonNullExpression\" } {\n  return node.type === \"TSNonNullExpression\";\n}\n\nexport function isSatisfiesExpression(\n  node: Node,\n): node is Node & { type: \"TSSatisfiesExpression\" } {\n  return node.type === \"TSSatisfiesExpression\";\n}\n\nexport function isTypeAssertionExpression(node: Node): node is Node & { type: \"TSTypeAssertion\" } {\n  return node.type === \"TSTypeAssertion\";\n}\n\nexport function isParenthesizedExpression(\n  node: Node,\n): node is Node & { type: \"ParenthesizedExpression\" } {\n  return node.type === \"ParenthesizedExpression\";\n}\n\nexport function isJsxAttribute(node: Node): node is Node & { type: \"JSXAttribute\" } {\n  return node.type === \"JSXAttribute\";\n}\n\nexport function isJsxExpression(node: Node): node is Node & { type: \"JSXExpressionContainer\" } {\n  return node.type === \"JSXExpressionContainer\";\n}\n\nexport function isJsxOpeningElement(node: Node): node is Node & { type: \"JSXOpeningElement\" } {\n  return node.type === \"JSXOpeningElement\";\n}\n\nexport function isJsxSelfClosingElement(node: Node): node is Node & { type: \"JSXOpeningElement\" } {\n  return node.type === \"JSXOpeningElement\" && node.selfClosing;\n}\n\nexport function isIfStatement(node: Node): node is Node & { type: \"IfStatement\" } {\n  return node.type === \"IfStatement\";\n}\n\nexport function isConditionalExpression(\n  node: Node,\n): node is Node & { type: \"ConditionalExpression\" } {\n  return node.type === \"ConditionalExpression\";\n}\n\nexport function isTemplateExpression(node: Node): node is Node & { type: \"TemplateLiteral\" } {\n  return node.type === \"TemplateLiteral\" && node.expressions.length > 0;\n}\n\nexport function isPropertySignature(node: Node): node is Node & { type: \"TSPropertySignature\" } {\n  return node.type === \"TSPropertySignature\";\n}\n\nexport function isUnionTypeNode(node: Node): node is Node & { type: \"TSUnionType\" } {\n  return node.type === \"TSUnionType\";\n}\n\nexport function isLiteralTypeNode(node: Node): node is Node & { type: \"TSLiteralType\" } {\n  return node.type === \"TSLiteralType\";\n}\n\nexport function isPrivateIdentifier(node: Node): node is Node & { type: \"PrivateIdentifier\" } {\n  return node.type === \"PrivateIdentifier\";\n}\n\nexport function isExpressionStatement(node: Node): node is Node & { type: \"ExpressionStatement\" } {\n  return node.type === \"ExpressionStatement\";\n}\n\nexport function isStringLiteral(node: Node): node is import(\"oxc-parser\").StringLiteral {\n  return node.type === \"Literal\" && typeof node.value === \"string\";\n}\nexport function isNumericLiteral(node: Node): node is import(\"oxc-parser\").NumericLiteral {\n  return node.type === \"Literal\" && typeof node.value === \"number\";\n}\nexport function isNoSubstitutionTemplateLiteral(\n  node: Node,\n): node is import(\"oxc-parser\").TemplateLiteral {\n  return node.type === \"TemplateLiteral\" && node.expressions.length === 0;\n}\nexport function isBinaryExpression(\n  node: Node,\n): node is\n  | import(\"oxc-parser\").BinaryExpression\n  | import(\"oxc-parser\").LogicalExpression\n  | import(\"oxc-parser\").AssignmentExpression {\n  return (\n    node.type === \"BinaryExpression\" ||\n    node.type === \"LogicalExpression\" ||\n    node.type === \"AssignmentExpression\"\n  );\n}\nexport function isRegularExpressionLiteral(node: Node): node is import(\"oxc-parser\").RegExpLiteral {\n  return node.type === \"Literal\" && \"regex\" in node;\n}\nexport function isPropertyAccessExpression(\n  node: Node,\n): node is import(\"oxc-parser\").MemberExpression & { computed: false } {\n  return node.type === \"MemberExpression\" && !node.computed;\n}\nexport function isElementAccessExpression(\n  node: Node,\n): node is import(\"oxc-parser\").MemberExpression & { computed: true } {\n  return node.type === \"MemberExpression\" && node.computed;\n}\nexport function isComputedPropertyName(node: Node): boolean {\n  const parent = parentOf(node);\n  return !!parent && \"computed\" in parent && parent.computed;\n}\nexport function isOmittedExpression(node: Node | null): node is null {\n  return node === null;\n}\nexport function hasModifier(\n  node: Node,\n  modifier: \"export\" | \"default\" | \"static\" | \"declare\",\n): boolean {\n  const parent = parentOf(node);\n  if (modifier === \"export\")\n    return parent?.type === \"ExportNamedDeclaration\" || parent?.type === \"ExportDefaultDeclaration\";\n  if (modifier === \"default\") return parent?.type === \"ExportDefaultDeclaration\";\n  return modifier in node && Reflect.get(node, modifier) === true;\n}\nexport function topLevelDeclarations(source: SourceFile): Node[] {\n  return source.body.map((statement) =>\n    (statement.type === \"ExportNamedDeclaration\" ||\n      statement.type === \"ExportDefaultDeclaration\") &&\n    statement.declaration\n      ? statement.declaration\n      : statement,\n  );\n}\n\nexport type Identifier = Node & { type: \"Identifier\" };\nexport type FunctionDeclaration = Node & { type: \"FunctionDeclaration\" };\nexport type FunctionExpression = Node & { type: \"FunctionExpression\" };\nexport function isEnumDeclaration(node: Node): node is Node & { type: \"TSEnumDeclaration\" } {\n  return node.type === \"TSEnumDeclaration\";\n}\n"],"mappings":"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"}

package/esm/tooling/syntax/imports.mjs

@@ -0,0 +1,34 @@
+import { forEachChild, parseSourceFile } from "./ast.mjs";
+
+//#region ../../packages/core/src/tooling/syntax/imports.ts
+/** Module references in real syntax, including type-only, dynamic and require references. */
+function importSpecifiers(fileName, source) {
+	const found = [];
+	const visit = (node) => {
+		if ((node.type === "ImportDeclaration" || node.type === "ExportNamedDeclaration" || node.type === "ExportAllDeclaration") && node.source) found.push({
+			specifier: node.source.value,
+			node: node.source,
+			dynamic: false
+		});
+		else if (node.type === "ImportExpression" && node.source.type === "Literal" && typeof node.source.value === "string") found.push({
+			specifier: node.source.value,
+			node: node.source,
+			dynamic: true
+		});
+		else if (node.type === "CallExpression" && node.callee.type === "Identifier" && node.callee.name === "require") {
+			const argument = node.arguments[0];
+			if (argument?.type === "Literal" && typeof argument.value === "string") found.push({
+				specifier: argument.value,
+				node: argument,
+				dynamic: false
+			});
+		}
+		forEachChild(node, visit);
+	};
+	visit(parseSourceFile(fileName, source));
+	return found;
+}
+
+//#endregion
+export { importSpecifiers };
+//# sourceMappingURL=imports.mjs.map

package/esm/tooling/syntax/imports.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"imports.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/syntax/imports.ts"],"sourcesContent":["import { forEachChild, parseSourceFile, type Node } from \"./ast\";\n\n/** Module references in real syntax, including type-only, dynamic and require references. */\nexport function importSpecifiers(\n  fileName: string,\n  source: string,\n): { specifier: string; node: Node; dynamic: boolean }[] {\n  const found: { specifier: string; node: Node; dynamic: boolean }[] = [];\n  const visit = (node: Node): void => {\n    if (\n      (node.type === \"ImportDeclaration\" ||\n        node.type === \"ExportNamedDeclaration\" ||\n        node.type === \"ExportAllDeclaration\") &&\n      node.source\n    )\n      found.push({ specifier: node.source.value, node: node.source, dynamic: false });\n    else if (\n      node.type === \"ImportExpression\" &&\n      node.source.type === \"Literal\" &&\n      typeof node.source.value === \"string\"\n    )\n      found.push({ specifier: node.source.value, node: node.source, dynamic: true });\n    else if (\n      node.type === \"CallExpression\" &&\n      node.callee.type === \"Identifier\" &&\n      node.callee.name === \"require\"\n    ) {\n      const argument = node.arguments[0];\n      if (argument?.type === \"Literal\" && typeof argument.value === \"string\")\n        found.push({ specifier: argument.value, node: argument, dynamic: false });\n    }\n    forEachChild(node, visit);\n  };\n  visit(parseSourceFile(fileName, source));\n  return found;\n}\n"],"mappings":";;;;AAGA,SAAgB,iBACd,UACA,QACuD;CACvD,MAAM,QAA+D,CAAC;CACtE,MAAM,SAAS,SAAqB;EAClC,KACG,KAAK,SAAS,uBACb,KAAK,SAAS,4BACd,KAAK,SAAS,2BAChB,KAAK,QAEL,MAAM,KAAK;GAAE,WAAW,KAAK,OAAO;GAAO,MAAM,KAAK;GAAQ,SAAS;EAAM,CAAC;OAC3E,IACH,KAAK,SAAS,sBACd,KAAK,OAAO,SAAS,aACrB,OAAO,KAAK,OAAO,UAAU,UAE7B,MAAM,KAAK;GAAE,WAAW,KAAK,OAAO;GAAO,MAAM,KAAK;GAAQ,SAAS;EAAK,CAAC;OAC1E,IACH,KAAK,SAAS,oBACd,KAAK,OAAO,SAAS,gBACrB,KAAK,OAAO,SAAS,WACrB;GACA,MAAM,WAAW,KAAK,UAAU;GAChC,IAAI,UAAU,SAAS,aAAa,OAAO,SAAS,UAAU,UAC5D,MAAM,KAAK;IAAE,WAAW,SAAS;IAAO,MAAM;IAAU,SAAS;GAAM,CAAC;EAC5E;EACA,aAAa,MAAM,KAAK;CAC1B;CACA,MAAM,gBAAgB,UAAU,MAAM,CAAC;CACvC,OAAO;AACT"}

package/esm/tooling/trace/trace-report.types.d.mts

@@ -0,0 +1,85 @@
+import { DevtoolsPhaseRecord } from "../devtools/devtools-client.mjs";
+//#region ../../packages/core/src/tooling/trace/trace-report.types.d.ts
+/** The `schemaVersion` of {@link TraceReport}. Fields are only added within a version. */
+export declare const TRACE_SCHEMA_VERSION = 1;
+/** One middleware run, in the order it ran. */
+export type TraceMiddleware = {
+  name: string | null;
+  index: number | null;
+  durationMs: number;
+};
+/** What the route's validation did. */
+export type TraceValidation = {
+  /** Whether a validation phase ran (the route declares a schema or a `validate` function). */
+  ran: boolean;
+  durationMs: number | null;
+  /**
+   * `true` when validation ran and the handler ran after it (or the response
+   * succeeded); `false` when it ran, the handler did not, and the response is
+   * an error; `null` when validation did not run.
+   */
+  passed: boolean | null;
+  /** The response body's `errors` (or the whole body) when validation failed; otherwise `null`. */
+  errors: unknown;
+};
+/** One recorded query, with its N+1 flag. */
+export type TraceQuery = Record<string, unknown> & {
+  /** `true` when the query's shape is one devtools reported as an N+1. */
+  nPlusOne: boolean;
+};
+/** What `warlock trace --json` prints and `traceRequest()` returns. */
+export type TraceReport = {
+  schemaVersion: typeof TRACE_SCHEMA_VERSION;
+  /** The request id the server used (the `x-request-id` it echoed). */
+  requestId: string;
+  /** The dev server origin the request went to. */
+  server: string;
+  request: {
+    method: string;
+    url: string;
+    /** Sent headers; `authorization`, `cookie` and `proxy-authorization` values read `[redacted]`. */
+    headers: Record<string, string>;
+    body: unknown;
+  };
+  response: {
+    status: number;
+    headers: Record<string, string>;
+    /** Parsed JSON when the content type is JSON, else text; `null` for an empty body. */
+    body: unknown;
+    /** Whether `body` was cut to the first 64 KiB. */
+    truncated: boolean;
+  };
+  /** The matched route pattern, e.g. `/posts/:id`, or `null`. */
+  route: string | null;
+  /** The error devtools recorded for the request, or `null`. */
+  error: string | null;
+  timeline: {
+    /** Every recorded phase in the order it was recorded. */
+    phases: DevtoolsPhaseRecord[];
+    routeMatch: {
+      durationMs: number;
+    } | null;
+    middleware: TraceMiddleware[];
+    validation: TraceValidation;
+    handler: {
+      durationMs: number;
+    } | null;
+  };
+  queries: TraceQuery[];
+  /** Devtools warnings for the request (`{ type: "n+1", message, shape, count, caller }`). */
+  warnings: Record<string, unknown>[];
+  logs: Record<string, unknown>[];
+  cache: Record<string, unknown>[];
+  /** Ids of mails captured during the request. */
+  mails: string[];
+  timings: {
+    /** The server-side duration devtools measured, or `null` while unsettled. */
+    totalMs: number | null;
+    /** The round trip measured by the client. */
+    clientMs: number;
+    /** Total time per phase name. */
+    phasesMs: Record<string, number>;
+  };
+};
+//#endregion
+//# sourceMappingURL=trace-report.types.d.mts.map

package/esm/tooling/trace/trace-report.types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-report.types.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/trace/trace-report.types.ts"],"mappings":";;;qBAGa;;YAGD;EACV;EACA;EACA;;;YAIU;;EAEV;EACA;;;;;;EAMA;;EAEA;;;YAIU,aAAa;;EAEvB;;;YAIU;EACV,sBAAsB;;EAEtB;;EAEA;EACA;IACE;IACA;;IAEA,SAAS;IACT;;EAEF;IACE;IACA,SAAS;;IAET;;IAEA;;;EAGF;;EAEA;EACA;;IAEE,QAAQ;IACR;MAAc;;IACd,YAAY;IACZ,YAAY;IACZ;MAAW;;;EAEb,SAAS;;EAET,UAAU;EACV,MAAM;EACN,OAAO;;EAEP;EACA;;IAEE;;IAEA;;IAEA,UAAU"}

package/esm/tooling/trace/trace-report.types.mjs

@@ -0,0 +1,7 @@
+//#region ../../packages/core/src/tooling/trace/trace-report.types.ts
+/** The `schemaVersion` of {@link TraceReport}. Fields are only added within a version. */
+const TRACE_SCHEMA_VERSION = 1;
+
+//#endregion
+export { TRACE_SCHEMA_VERSION };
+//# sourceMappingURL=trace-report.types.mjs.map

package/esm/tooling/trace/trace-report.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-report.types.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/trace/trace-report.types.ts"],"sourcesContent":["import type { DevtoolsPhaseRecord } from \"../devtools/devtools-client\";\n\n/** The `schemaVersion` of {@link TraceReport}. Fields are only added within a version. */\nexport const TRACE_SCHEMA_VERSION = 1;\n\n/** One middleware run, in the order it ran. */\nexport type TraceMiddleware = {\n  name: string | null;\n  index: number | null;\n  durationMs: number;\n};\n\n/** What the route's validation did. */\nexport type TraceValidation = {\n  /** Whether a validation phase ran (the route declares a schema or a `validate` function). */\n  ran: boolean;\n  durationMs: number | null;\n  /**\n   * `true` when validation ran and the handler ran after it (or the response\n   * succeeded); `false` when it ran, the handler did not, and the response is\n   * an error; `null` when validation did not run.\n   */\n  passed: boolean | null;\n  /** The response body's `errors` (or the whole body) when validation failed; otherwise `null`. */\n  errors: unknown;\n};\n\n/** One recorded query, with its N+1 flag. */\nexport type TraceQuery = Record<string, unknown> & {\n  /** `true` when the query's shape is one devtools reported as an N+1. */\n  nPlusOne: boolean;\n};\n\n/** What `warlock trace --json` prints and `traceRequest()` returns. */\nexport type TraceReport = {\n  schemaVersion: typeof TRACE_SCHEMA_VERSION;\n  /** The request id the server used (the `x-request-id` it echoed). */\n  requestId: string;\n  /** The dev server origin the request went to. */\n  server: string;\n  request: {\n    method: string;\n    url: string;\n    /** Sent headers; `authorization`, `cookie` and `proxy-authorization` values read `[redacted]`. */\n    headers: Record<string, string>;\n    body: unknown;\n  };\n  response: {\n    status: number;\n    headers: Record<string, string>;\n    /** Parsed JSON when the content type is JSON, else text; `null` for an empty body. */\n    body: unknown;\n    /** Whether `body` was cut to the first 64 KiB. */\n    truncated: boolean;\n  };\n  /** The matched route pattern, e.g. `/posts/:id`, or `null`. */\n  route: string | null;\n  /** The error devtools recorded for the request, or `null`. */\n  error: string | null;\n  timeline: {\n    /** Every recorded phase in the order it was recorded. */\n    phases: DevtoolsPhaseRecord[];\n    routeMatch: { durationMs: number } | null;\n    middleware: TraceMiddleware[];\n    validation: TraceValidation;\n    handler: { durationMs: number } | null;\n  };\n  queries: TraceQuery[];\n  /** Devtools warnings for the request (`{ type: \"n+1\", message, shape, count, caller }`). */\n  warnings: Record<string, unknown>[];\n  logs: Record<string, unknown>[];\n  cache: Record<string, unknown>[];\n  /** Ids of mails captured during the request. */\n  mails: string[];\n  timings: {\n    /** The server-side duration devtools measured, or `null` while unsettled. */\n    totalMs: number | null;\n    /** The round trip measured by the client. */\n    clientMs: number;\n    /** Total time per phase name. */\n    phasesMs: Record<string, number>;\n  };\n};\n"],"mappings":";;AAGA,MAAa,uBAAuB"}

package/esm/tooling/trace/trace-request.d.mts

@@ -0,0 +1,90 @@
+import { DevtoolsFetch, DevtoolsRequestRecord } from "../devtools/devtools-client.mjs";
+import { TraceReport } from "./trace-report.types.mjs";
+//#region ../../packages/core/src/tooling/trace/trace-request.d.ts
+/** The correlation header core reads and echoes by default (`http.requestId.header`). */
+export declare const TRACE_REQUEST_ID_HEADER = "x-request-id";
+/** Response bodies longer than this are cut in the report. */
+export declare const TRACE_BODY_LIMIT: number;
+/** Inputs of {@link traceRequest}. */
+export type TraceRequestOptions = {
+  /** HTTP method, any case. */
+  method: string;
+  /** A path on the dev server (`/posts?page=2`) or an absolute URL. */
+  url: string;
+  /**
+   * The request body. A string is sent as-is; anything else is sent as JSON
+   * with `content-type: application/json` unless `headers` sets a content type.
+   */
+  body?: unknown;
+  /** Extra request headers. */
+  headers?: Record<string, string>;
+  /** Project root, where `.warlock/dev-server.json` is read. Default: `process.cwd()`. */
+  cwd?: string;
+  /** The dev server origin; overrides the recorded one. */
+  serverUrl?: string;
+  /** The devtools mount; overrides the recorded one (default `/__warlock`). */
+  devtoolsPath?: string;
+  fetch?: DevtoolsFetch;
+  /** How long to wait for devtools to settle the request record. Default 5000 ms. */
+  timeoutMs?: number;
+  /** Poll interval while waiting for the record. Default 50 ms. */
+  intervalMs?: number;
+  /**
+   * The correlation header the app reads and echoes (`http.requestId.header`).
+   * Default `x-request-id`.
+   */
+  requestIdHeader?: string;
+};
+/** The HTTP response as the report needs it. */
+export type TracedResponse = {
+  status: number;
+  headers: Record<string, string>;
+  /** The raw response text. */
+  text: string;
+};
+/** Inputs of {@link buildTraceReport}. */
+export type BuildTraceReportInput = {
+  requestId: string;
+  server: string;
+  request: {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body: unknown;
+  };
+  response: TracedResponse;
+  record: DevtoolsRequestRecord;
+  clientMs: number;
+};
+/** Headers with credential values replaced by `[redacted]`. */
+export declare function redactHeaders(headers: Record<string, string>): Record<string, string>;
+/** The response body as the report prints it: parsed JSON, else text, cut at the limit. */
+export declare function readResponseBody(text: string, contentType: string | undefined): {
+  body: unknown;
+  truncated: boolean;
+};
+/**
+ * Assemble a {@link TraceReport} from the HTTP response and the devtools
+ * record of the same request. Pure: no I/O, so it is testable on its own.
+ */
+export declare function buildTraceReport(input: BuildTraceReportInput): TraceReport;
+/** The absolute URL a trace sends to: `url` as-is when absolute, else joined to the server origin. */
+export declare function resolveTraceUrl(server: string, url: string): string;
+/**
+ * Send one request to the running dev server and return its devtools
+ * timeline: middleware, validation result, handler, queries (with N+1 flags),
+ * logs, cache operations, captured mails, the response and the timings.
+ *
+ * Devtools is reached first, so a missing dev server (`WL8008`) or devtools
+ * (`WL8009`) fails before anything is sent. The request carries an
+ * `x-request-id` (unless the caller set one), which core adopts as
+ * `request.id` and echoes back; that id is how the devtools record is found.
+ * Throws `WL5004` when devtools never recorded the request.
+ *
+ * @example
+ * const report = await traceRequest({ method: "POST", url: "/posts", body: { title: "Hi" } });
+ * report.timeline.validation.passed; // false when the body was refused
+ */
+export declare function traceRequest(options: TraceRequestOptions): Promise<TraceReport>;
+//#endregion
+//# sourceMappingURL=trace-request.d.mts.map

package/esm/tooling/trace/trace-request.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-request.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/trace/trace-request.ts"],"mappings":";;;;qBAgBa;;qBAGA;;YAMD;;EAEV;;EAEA;;;;;EAKA;;EAEA,UAAU;;EAEV;;EAEA;;EAEA;EACA,QAAQ;;EAER;;EAEA;;;;;EAKA;;;YAIU;EACV;EACA,SAAS;;EAET;;;YAIU;EACV;EACA;EACA;IAAW;IAAgB;IAAa,SAAS;IAAwB;;EACzE,UAAU;EACV,QAAQ;EACR;;;wBAkBc,cAAc,SAAS,yBAAyB;;wBAWhD,iBACd,cACA;EACG;EAAe;;;;;;wBA6DJ,iBAAiB,OAAO,wBAAwB;;wBAoEhD,gBAAgB,gBAAgB;;;;;;;;;;;;;;;;wBA2C1B,aAAa,SAAS,sBAAsB,QAAQ"}

package/esm/tooling/trace/trace-request.mjs

@@ -0,0 +1,241 @@
+import { WarlockError } from "../../errors/warlock-error.mjs";
+import { connectDevtools } from "../devtools/devtools-client.mjs";
+import { TRACE_SCHEMA_VERSION } from "./trace-report.types.mjs";
+import { randomUUID } from "node:crypto";
+
+//#region ../../packages/core/src/tooling/trace/trace-request.ts
+/** The correlation header core reads and echoes by default (`http.requestId.header`). */
+const TRACE_REQUEST_ID_HEADER = "x-request-id";
+/** Response bodies longer than this are cut in the report. */
+const TRACE_BODY_LIMIT = 65536;
+/** Header values never printed in a report. */
+const REDACTED_HEADERS = /* @__PURE__ */ new Set([
+	"authorization",
+	"cookie",
+	"proxy-authorization"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function lowerCaseKeys(headers) {
+	const result = {};
+	for (const [key, value] of Object.entries(headers)) result[key.toLowerCase()] = value;
+	return result;
+}
+/** Headers with credential values replaced by `[redacted]`. */
+function redactHeaders(headers) {
+	const result = {};
+	for (const [key, value] of Object.entries(headers)) result[key] = REDACTED_HEADERS.has(key.toLowerCase()) ? "[redacted]" : value;
+	return result;
+}
+/** The response body as the report prints it: parsed JSON, else text, cut at the limit. */
+function readResponseBody(text, contentType) {
+	if (text.length === 0) return {
+		body: null,
+		truncated: false
+	};
+	const truncated = text.length > TRACE_BODY_LIMIT;
+	if (!truncated && contentType !== void 0 && /\bjson\b/i.test(contentType)) try {
+		return {
+			body: JSON.parse(text),
+			truncated: false
+		};
+	} catch {}
+	return {
+		body: truncated ? text.slice(0, TRACE_BODY_LIMIT) : text,
+		truncated
+	};
+}
+function attrNumber(attrs, key) {
+	const value = attrs?.[key];
+	return typeof value === "number" ? value : null;
+}
+function attrString(attrs, key) {
+	const value = attrs?.[key];
+	return typeof value === "string" ? value : null;
+}
+function validationOf(record, status, body) {
+	const phases = record.phases.filter((phase) => phase.name === "validation");
+	if (phases.length === 0) return {
+		ran: false,
+		durationMs: null,
+		passed: null,
+		errors: null
+	};
+	const durationMs = phases.reduce((total, phase) => total + phase.durationMs, 0);
+	const passed = record.phases.some((phase) => phase.name === "handler") || status < 400;
+	return {
+		ran: true,
+		durationMs,
+		passed,
+		errors: passed ? null : isRecord(body) && "errors" in body ? body.errors : body
+	};
+}
+function sumPhase(record, name) {
+	const phases = record.phases.filter((phase) => phase.name === name);
+	if (phases.length === 0) return null;
+	return { durationMs: phases.reduce((total, phase) => total + phase.durationMs, 0) };
+}
+/**
+* Assemble a {@link TraceReport} from the HTTP response and the devtools
+* record of the same request. Pure: no I/O, so it is testable on its own.
+*/
+function buildTraceReport(input) {
+	const { record, response } = input;
+	const responseHeaders = lowerCaseKeys(response.headers);
+	const { body, truncated } = readResponseBody(response.text, responseHeaders["content-type"]);
+	const middleware = record.phases.filter((phase) => phase.name === "middleware").map((phase) => ({
+		name: attrString(phase.attrs, "name"),
+		index: attrNumber(phase.attrs, "index"),
+		durationMs: phase.durationMs
+	}));
+	const nPlusOneShapes = new Set(record.warnings.flatMap((warning) => warning.type === "n+1" && typeof warning.shape === "string" ? [warning.shape] : []));
+	const queries = record.queries.map((query) => ({
+		...query,
+		nPlusOne: typeof query.shape === "string" && nPlusOneShapes.has(query.shape)
+	}));
+	const phasesMs = {};
+	for (const phase of record.phases) phasesMs[phase.name] = (phasesMs[phase.name] ?? 0) + phase.durationMs;
+	return {
+		schemaVersion: 1,
+		requestId: input.requestId,
+		server: input.server,
+		request: {
+			method: input.request.method,
+			url: input.request.url,
+			headers: redactHeaders(input.request.headers),
+			body: input.request.body
+		},
+		response: {
+			status: response.status,
+			headers: redactHeaders(responseHeaders),
+			body,
+			truncated
+		},
+		route: record.route ?? null,
+		error: record.error ?? null,
+		timeline: {
+			phases: record.phases,
+			routeMatch: sumPhase(record, "route.match"),
+			middleware,
+			validation: validationOf(record, response.status, body),
+			handler: sumPhase(record, "handler")
+		},
+		queries,
+		warnings: record.warnings,
+		logs: record.logs,
+		cache: record.cache,
+		mails: record.mails,
+		timings: {
+			totalMs: record.durationMs ?? null,
+			clientMs: input.clientMs,
+			phasesMs
+		}
+	};
+}
+/** The absolute URL a trace sends to: `url` as-is when absolute, else joined to the server origin. */
+function resolveTraceUrl(server, url) {
+	if (/^https?:\/\//i.test(url)) return url;
+	return `${server}${url.startsWith("/") ? url : `/${url}`}`;
+}
+/** The body and headers to send for a {@link TraceRequestOptions.body}. */
+function encodeBody(body, headers) {
+	if (body === void 0) return {
+		payload: void 0,
+		headers
+	};
+	if (typeof body === "string") return {
+		payload: body,
+		headers
+	};
+	const hasContentType = Object.keys(headers).some((key) => key.toLowerCase() === "content-type");
+	return {
+		payload: JSON.stringify(body),
+		headers: hasContentType ? headers : {
+			...headers,
+			"content-type": "application/json"
+		}
+	};
+}
+function headerValue(headers, name) {
+	const key = Object.keys(headers).find((candidate) => candidate.toLowerCase() === name);
+	return key === void 0 ? void 0 : headers[key];
+}
+/**
+* Send one request to the running dev server and return its devtools
+* timeline: middleware, validation result, handler, queries (with N+1 flags),
+* logs, cache operations, captured mails, the response and the timings.
+*
+* Devtools is reached first, so a missing dev server (`WL8008`) or devtools
+* (`WL8009`) fails before anything is sent. The request carries an
+* `x-request-id` (unless the caller set one), which core adopts as
+* `request.id` and echoes back; that id is how the devtools record is found.
+* Throws `WL5004` when devtools never recorded the request.
+*
+* @example
+* const report = await traceRequest({ method: "POST", url: "/posts", body: { title: "Hi" } });
+* report.timeline.validation.passed; // false when the body was refused
+*/
+async function traceRequest(options) {
+	const fetcher = options.fetch ?? ((input, init) => fetch(input, init));
+	const devtools = await connectDevtools({
+		cwd: options.cwd,
+		url: options.serverUrl,
+		devtoolsPath: options.devtoolsPath,
+		fetch: fetcher
+	});
+	const method = options.method.toUpperCase();
+	const url = resolveTraceUrl(devtools.url, options.url);
+	const idHeader = (options.requestIdHeader ?? "x-request-id").toLowerCase();
+	const ownId = headerValue(options.headers ?? {}, idHeader);
+	const sentId = ownId ?? randomUUID();
+	const base = ownId === void 0 ? {
+		...options.headers,
+		[idHeader]: sentId
+	} : { ...options.headers };
+	const { payload, headers } = encodeBody(options.body, base);
+	const startedAt = performance.now();
+	let response;
+	try {
+		response = await fetcher(url, {
+			method,
+			headers,
+			body: payload
+		});
+	} catch (error) {
+		throw new WarlockError("WL8008", `The dev server at ${devtools.url} did not answer ${method} ${url}: ${error instanceof Error ? error.message : String(error)}.`, { cause: error });
+	}
+	const text = await response.text();
+	const clientMs = performance.now() - startedAt;
+	const responseHeaders = {};
+	response.headers.forEach((value, key) => {
+		responseHeaders[key] = value;
+	});
+	const requestId = responseHeaders[idHeader] ?? sentId;
+	const record = await devtools.waitForRequest(requestId, {
+		timeoutMs: options.timeoutMs,
+		intervalMs: options.intervalMs
+	});
+	if (!record) throw new WarlockError("WL5004", `Devtools holds no record of request ${requestId} (${method} ${url} answered ${response.status}). Keep http.requestId enabled so the id is echoed; paths under ${devtools.devtoolsPath} are never recorded.`);
+	return buildTraceReport({
+		requestId,
+		server: devtools.url,
+		request: {
+			method,
+			url,
+			headers,
+			body: options.body ?? null
+		},
+		response: {
+			status: response.status,
+			headers: responseHeaders,
+			text
+		},
+		record,
+		clientMs
+	});
+}
+
+//#endregion
+export { TRACE_BODY_LIMIT, TRACE_REQUEST_ID_HEADER, buildTraceReport, readResponseBody, redactHeaders, resolveTraceUrl, traceRequest };
+//# sourceMappingURL=trace-request.mjs.map

package/esm/tooling/trace/trace-request.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-request.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/trace/trace-request.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { WarlockError } from \"../../errors/warlock-error\";\nimport {\n  connectDevtools,\n  type DevtoolsFetch,\n  type DevtoolsRequestRecord,\n} from \"../devtools/devtools-client\";\nimport {\n  TRACE_SCHEMA_VERSION,\n  type TraceMiddleware,\n  type TraceQuery,\n  type TraceReport,\n  type TraceValidation,\n} from \"./trace-report.types\";\n\n/** The correlation header core reads and echoes by default (`http.requestId.header`). */\nexport const TRACE_REQUEST_ID_HEADER = \"x-request-id\";\n\n/** Response bodies longer than this are cut in the report. */\nexport const TRACE_BODY_LIMIT = 64 * 1024;\n\n/** Header values never printed in a report. */\nconst REDACTED_HEADERS = new Set([\"authorization\", \"cookie\", \"proxy-authorization\"]);\n\n/** Inputs of {@link traceRequest}. */\nexport type TraceRequestOptions = {\n  /** HTTP method, any case. */\n  method: string;\n  /** A path on the dev server (`/posts?page=2`) or an absolute URL. */\n  url: string;\n  /**\n   * The request body. A string is sent as-is; anything else is sent as JSON\n   * with `content-type: application/json` unless `headers` sets a content type.\n   */\n  body?: unknown;\n  /** Extra request headers. */\n  headers?: Record<string, string>;\n  /** Project root, where `.warlock/dev-server.json` is read. Default: `process.cwd()`. */\n  cwd?: string;\n  /** The dev server origin; overrides the recorded one. */\n  serverUrl?: string;\n  /** The devtools mount; overrides the recorded one (default `/__warlock`). */\n  devtoolsPath?: string;\n  fetch?: DevtoolsFetch;\n  /** How long to wait for devtools to settle the request record. Default 5000 ms. */\n  timeoutMs?: number;\n  /** Poll interval while waiting for the record. Default 50 ms. */\n  intervalMs?: number;\n  /**\n   * The correlation header the app reads and echoes (`http.requestId.header`).\n   * Default `x-request-id`.\n   */\n  requestIdHeader?: string;\n};\n\n/** The HTTP response as the report needs it. */\nexport type TracedResponse = {\n  status: number;\n  headers: Record<string, string>;\n  /** The raw response text. */\n  text: string;\n};\n\n/** Inputs of {@link buildTraceReport}. */\nexport type BuildTraceReportInput = {\n  requestId: string;\n  server: string;\n  request: { method: string; url: string; headers: Record<string, string>; body: unknown };\n  response: TracedResponse;\n  record: DevtoolsRequestRecord;\n  clientMs: number;\n};\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction lowerCaseKeys(headers: Record<string, string>): Record<string, string> {\n  const result: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(headers)) {\n    result[key.toLowerCase()] = value;\n  }\n\n  return result;\n}\n\n/** Headers with credential values replaced by `[redacted]`. */\nexport function redactHeaders(headers: Record<string, string>): Record<string, string> {\n  const result: Record<string, string> = {};\n\n  for (const [key, value] of Object.entries(headers)) {\n    result[key] = REDACTED_HEADERS.has(key.toLowerCase()) ? \"[redacted]\" : value;\n  }\n\n  return result;\n}\n\n/** The response body as the report prints it: parsed JSON, else text, cut at the limit. */\nexport function readResponseBody(\n  text: string,\n  contentType: string | undefined,\n): { body: unknown; truncated: boolean } {\n  if (text.length === 0) return { body: null, truncated: false };\n\n  const truncated = text.length > TRACE_BODY_LIMIT;\n\n  if (!truncated && contentType !== undefined && /\\bjson\\b/i.test(contentType)) {\n    try {\n      return { body: JSON.parse(text), truncated: false };\n    } catch {\n      // Fall through to text: a body that claims JSON and is not is worth seeing as-is.\n    }\n  }\n\n  return { body: truncated ? text.slice(0, TRACE_BODY_LIMIT) : text, truncated };\n}\n\nfunction attrNumber(attrs: Record<string, unknown> | undefined, key: string): number | null {\n  const value = attrs?.[key];\n\n  return typeof value === \"number\" ? value : null;\n}\n\nfunction attrString(attrs: Record<string, unknown> | undefined, key: string): string | null {\n  const value = attrs?.[key];\n\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction validationOf(\n  record: DevtoolsRequestRecord,\n  status: number,\n  body: unknown,\n): TraceValidation {\n  const phases = record.phases.filter((phase) => phase.name === \"validation\");\n\n  if (phases.length === 0) {\n    return { ran: false, durationMs: null, passed: null, errors: null };\n  }\n\n  const durationMs = phases.reduce((total, phase) => total + phase.durationMs, 0);\n  const handlerRan = record.phases.some((phase) => phase.name === \"handler\");\n  // A validation failure answers before the handler runs, with the configured\n  // failure status (422 by default, `validation.response.status`).\n  const passed = handlerRan || status < 400;\n  const errors = passed ? null : isRecord(body) && \"errors\" in body ? body.errors : body;\n\n  return { ran: true, durationMs, passed, errors };\n}\n\nfunction sumPhase(record: DevtoolsRequestRecord, name: string): { durationMs: number } | null {\n  const phases = record.phases.filter((phase) => phase.name === name);\n\n  if (phases.length === 0) return null;\n\n  return { durationMs: phases.reduce((total, phase) => total + phase.durationMs, 0) };\n}\n\n/**\n * Assemble a {@link TraceReport} from the HTTP response and the devtools\n * record of the same request. Pure: no I/O, so it is testable on its own.\n */\nexport function buildTraceReport(input: BuildTraceReportInput): TraceReport {\n  const { record, response } = input;\n  const responseHeaders = lowerCaseKeys(response.headers);\n  const { body, truncated } = readResponseBody(response.text, responseHeaders[\"content-type\"]);\n\n  const middleware: TraceMiddleware[] = record.phases\n    .filter((phase) => phase.name === \"middleware\")\n    .map((phase) => ({\n      name: attrString(phase.attrs, \"name\"),\n      index: attrNumber(phase.attrs, \"index\"),\n      durationMs: phase.durationMs,\n    }));\n\n  const nPlusOneShapes = new Set(\n    record.warnings.flatMap((warning) =>\n      warning.type === \"n+1\" && typeof warning.shape === \"string\" ? [warning.shape] : [],\n    ),\n  );\n  const queries: TraceQuery[] = record.queries.map((query) => ({\n    ...query,\n    nPlusOne: typeof query.shape === \"string\" && nPlusOneShapes.has(query.shape),\n  }));\n\n  const phasesMs: Record<string, number> = {};\n\n  for (const phase of record.phases) {\n    phasesMs[phase.name] = (phasesMs[phase.name] ?? 0) + phase.durationMs;\n  }\n\n  return {\n    schemaVersion: TRACE_SCHEMA_VERSION,\n    requestId: input.requestId,\n    server: input.server,\n    request: {\n      method: input.request.method,\n      url: input.request.url,\n      headers: redactHeaders(input.request.headers),\n      body: input.request.body,\n    },\n    response: {\n      status: response.status,\n      headers: redactHeaders(responseHeaders),\n      body,\n      truncated,\n    },\n    route: record.route ?? null,\n    error: record.error ?? null,\n    timeline: {\n      phases: record.phases,\n      routeMatch: sumPhase(record, \"route.match\"),\n      middleware,\n      validation: validationOf(record, response.status, body),\n      handler: sumPhase(record, \"handler\"),\n    },\n    queries,\n    warnings: record.warnings,\n    logs: record.logs,\n    cache: record.cache,\n    mails: record.mails,\n    timings: {\n      totalMs: record.durationMs ?? null,\n      clientMs: input.clientMs,\n      phasesMs,\n    },\n  };\n}\n\n/** The absolute URL a trace sends to: `url` as-is when absolute, else joined to the server origin. */\nexport function resolveTraceUrl(server: string, url: string): string {\n  if (/^https?:\\/\\//i.test(url)) return url;\n\n  return `${server}${url.startsWith(\"/\") ? url : `/${url}`}`;\n}\n\n/** The body and headers to send for a {@link TraceRequestOptions.body}. */\nfunction encodeBody(\n  body: unknown,\n  headers: Record<string, string>,\n): { payload: string | undefined; headers: Record<string, string> } {\n  if (body === undefined) return { payload: undefined, headers };\n  if (typeof body === \"string\") return { payload: body, headers };\n\n  const hasContentType = Object.keys(headers).some((key) => key.toLowerCase() === \"content-type\");\n\n  return {\n    payload: JSON.stringify(body),\n    headers: hasContentType ? headers : { ...headers, \"content-type\": \"application/json\" },\n  };\n}\n\nfunction headerValue(headers: Record<string, string>, name: string): string | undefined {\n  const key = Object.keys(headers).find((candidate) => candidate.toLowerCase() === name);\n\n  return key === undefined ? undefined : headers[key];\n}\n\n/**\n * Send one request to the running dev server and return its devtools\n * timeline: middleware, validation result, handler, queries (with N+1 flags),\n * logs, cache operations, captured mails, the response and the timings.\n *\n * Devtools is reached first, so a missing dev server (`WL8008`) or devtools\n * (`WL8009`) fails before anything is sent. The request carries an\n * `x-request-id` (unless the caller set one), which core adopts as\n * `request.id` and echoes back; that id is how the devtools record is found.\n * Throws `WL5004` when devtools never recorded the request.\n *\n * @example\n * const report = await traceRequest({ method: \"POST\", url: \"/posts\", body: { title: \"Hi\" } });\n * report.timeline.validation.passed; // false when the body was refused\n */\nexport async function traceRequest(options: TraceRequestOptions): Promise<TraceReport> {\n  const fetcher: DevtoolsFetch = options.fetch ?? ((input, init) => fetch(input, init));\n  const devtools = await connectDevtools({\n    cwd: options.cwd,\n    url: options.serverUrl,\n    devtoolsPath: options.devtoolsPath,\n    fetch: fetcher,\n  });\n\n  const method = options.method.toUpperCase();\n  const url = resolveTraceUrl(devtools.url, options.url);\n  const idHeader = (options.requestIdHeader ?? TRACE_REQUEST_ID_HEADER).toLowerCase();\n  const ownId = headerValue(options.headers ?? {}, idHeader);\n  const sentId = ownId ?? randomUUID();\n  const base =\n    ownId === undefined ? { ...options.headers, [idHeader]: sentId } : { ...options.headers };\n  const { payload, headers } = encodeBody(options.body, base);\n\n  const startedAt = performance.now();\n  let response: Response;\n\n  try {\n    response = await fetcher(url, { method, headers, body: payload });\n  } catch (error) {\n    throw new WarlockError(\n      \"WL8008\",\n      `The dev server at ${devtools.url} did not answer ${method} ${url}: ${error instanceof Error ? error.message : String(error)}.`,\n      { cause: error },\n    );\n  }\n\n  const text = await response.text();\n  const clientMs = performance.now() - startedAt;\n  const responseHeaders: Record<string, string> = {};\n\n  response.headers.forEach((value, key) => {\n    responseHeaders[key] = value;\n  });\n\n  const requestId = responseHeaders[idHeader] ?? sentId;\n  const record = await devtools.waitForRequest(requestId, {\n    timeoutMs: options.timeoutMs,\n    intervalMs: options.intervalMs,\n  });\n\n  if (!record) {\n    throw new WarlockError(\n      \"WL5004\",\n      `Devtools holds no record of request ${requestId} (${method} ${url} answered ${response.status}). Keep http.requestId enabled so the id is echoed; paths under ${devtools.devtoolsPath} are never recorded.`,\n    );\n  }\n\n  return buildTraceReport({\n    requestId,\n    server: devtools.url,\n    request: { method, url, headers, body: options.body ?? null },\n    response: { status: response.status, headers: responseHeaders, text },\n    record,\n    clientMs,\n  });\n}\n"],"mappings":";;;;;;;AAgBA,MAAa,0BAA0B;;AAGvC,MAAa,mBAAmB;;AAGhC,MAAM,mCAAmB,IAAI,IAAI;CAAC;CAAiB;CAAU;AAAqB,CAAC;AAmDnF,SAAS,SAAS,OAAkD;CAClE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,cAAc,SAAyD;CAC9E,MAAM,SAAiC,CAAC;CAExC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAC/C,OAAO,IAAI,YAAY,KAAK;CAG9B,OAAO;AACT;;AAGA,SAAgB,cAAc,SAAyD;CACrF,MAAM,SAAiC,CAAC;CAExC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,GAC/C,OAAO,OAAO,iBAAiB,IAAI,IAAI,YAAY,CAAC,IAAI,eAAe;CAGzE,OAAO;AACT;;AAGA,SAAgB,iBACd,MACA,aACuC;CACvC,IAAI,KAAK,WAAW,GAAG,OAAO;EAAE,MAAM;EAAM,WAAW;CAAM;CAE7D,MAAM,YAAY,KAAK,SAAS;CAEhC,IAAI,CAAC,aAAa,gBAAgB,UAAa,YAAY,KAAK,WAAW,GACzE,IAAI;EACF,OAAO;GAAE,MAAM,KAAK,MAAM,IAAI;GAAG,WAAW;EAAM;CACpD,QAAQ,CAER;CAGF,OAAO;EAAE,MAAM,YAAY,KAAK,MAAM,GAAG,gBAAgB,IAAI;EAAM;CAAU;AAC/E;AAEA,SAAS,WAAW,OAA4C,KAA4B;CAC1F,MAAM,QAAQ,QAAQ;CAEtB,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAS,WAAW,OAA4C,KAA4B;CAC1F,MAAM,QAAQ,QAAQ;CAEtB,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;AAEA,SAAS,aACP,QACA,QACA,MACiB;CACjB,MAAM,SAAS,OAAO,OAAO,QAAQ,UAAU,MAAM,SAAS,YAAY;CAE1E,IAAI,OAAO,WAAW,GACpB,OAAO;EAAE,KAAK;EAAO,YAAY;EAAM,QAAQ;EAAM,QAAQ;CAAK;CAGpE,MAAM,aAAa,OAAO,QAAQ,OAAO,UAAU,QAAQ,MAAM,YAAY,CAAC;CAI9E,MAAM,SAHa,OAAO,OAAO,MAAM,UAAU,MAAM,SAAS,SAGxC,KAAK,SAAS;CAGtC,OAAO;EAAE,KAAK;EAAM;EAAY;EAAQ,QAFzB,SAAS,OAAO,SAAS,IAAI,KAAK,YAAY,OAAO,KAAK,SAAS;CAEnC;AACjD;AAEA,SAAS,SAAS,QAA+B,MAA6C;CAC5F,MAAM,SAAS,OAAO,OAAO,QAAQ,UAAU,MAAM,SAAS,IAAI;CAElE,IAAI,OAAO,WAAW,GAAG,OAAO;CAEhC,OAAO,EAAE,YAAY,OAAO,QAAQ,OAAO,UAAU,QAAQ,MAAM,YAAY,CAAC,EAAE;AACpF;;;;;AAMA,SAAgB,iBAAiB,OAA2C;CAC1E,MAAM,EAAE,QAAQ,aAAa;CAC7B,MAAM,kBAAkB,cAAc,SAAS,OAAO;CACtD,MAAM,EAAE,MAAM,cAAc,iBAAiB,SAAS,MAAM,gBAAgB,eAAe;CAE3F,MAAM,aAAgC,OAAO,OAC1C,QAAQ,UAAU,MAAM,SAAS,YAAY,CAAC,CAC9C,KAAK,WAAW;EACf,MAAM,WAAW,MAAM,OAAO,MAAM;EACpC,OAAO,WAAW,MAAM,OAAO,OAAO;EACtC,YAAY,MAAM;CACpB,EAAE;CAEJ,MAAM,iBAAiB,IAAI,IACzB,OAAO,SAAS,SAAS,YACvB,QAAQ,SAAS,SAAS,OAAO,QAAQ,UAAU,WAAW,CAAC,QAAQ,KAAK,IAAI,CAAC,CACnF,CACF;CACA,MAAM,UAAwB,OAAO,QAAQ,KAAK,WAAW;EAC3D,GAAG;EACH,UAAU,OAAO,MAAM,UAAU,YAAY,eAAe,IAAI,MAAM,KAAK;CAC7E,EAAE;CAEF,MAAM,WAAmC,CAAC;CAE1C,KAAK,MAAM,SAAS,OAAO,QACzB,SAAS,MAAM,SAAS,SAAS,MAAM,SAAS,KAAK,MAAM;CAG7D,OAAO;EACL;EACA,WAAW,MAAM;EACjB,QAAQ,MAAM;EACd,SAAS;GACP,QAAQ,MAAM,QAAQ;GACtB,KAAK,MAAM,QAAQ;GACnB,SAAS,cAAc,MAAM,QAAQ,OAAO;GAC5C,MAAM,MAAM,QAAQ;EACtB;EACA,UAAU;GACR,QAAQ,SAAS;GACjB,SAAS,cAAc,eAAe;GACtC;GACA;EACF;EACA,OAAO,OAAO,SAAS;EACvB,OAAO,OAAO,SAAS;EACvB,UAAU;GACR,QAAQ,OAAO;GACf,YAAY,SAAS,QAAQ,aAAa;GAC1C;GACA,YAAY,aAAa,QAAQ,SAAS,QAAQ,IAAI;GACtD,SAAS,SAAS,QAAQ,SAAS;EACrC;EACA;EACA,UAAU,OAAO;EACjB,MAAM,OAAO;EACb,OAAO,OAAO;EACd,OAAO,OAAO;EACd,SAAS;GACP,SAAS,OAAO,cAAc;GAC9B,UAAU,MAAM;GAChB;EACF;CACF;AACF;;AAGA,SAAgB,gBAAgB,QAAgB,KAAqB;CACnE,IAAI,gBAAgB,KAAK,GAAG,GAAG,OAAO;CAEtC,OAAO,GAAG,SAAS,IAAI,WAAW,GAAG,IAAI,MAAM,IAAI;AACrD;;AAGA,SAAS,WACP,MACA,SACkE;CAClE,IAAI,SAAS,QAAW,OAAO;EAAE,SAAS;EAAW;CAAQ;CAC7D,IAAI,OAAO,SAAS,UAAU,OAAO;EAAE,SAAS;EAAM;CAAQ;CAE9D,MAAM,iBAAiB,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,QAAQ,IAAI,YAAY,MAAM,cAAc;CAE9F,OAAO;EACL,SAAS,KAAK,UAAU,IAAI;EAC5B,SAAS,iBAAiB,UAAU;GAAE,GAAG;GAAS,gBAAgB;EAAmB;CACvF;AACF;AAEA,SAAS,YAAY,SAAiC,MAAkC;CACtF,MAAM,MAAM,OAAO,KAAK,OAAO,CAAC,CAAC,MAAM,cAAc,UAAU,YAAY,MAAM,IAAI;CAErF,OAAO,QAAQ,SAAY,SAAY,QAAQ;AACjD;;;;;;;;;;;;;;;;AAiBA,eAAsB,aAAa,SAAoD;CACrF,MAAM,UAAyB,QAAQ,WAAW,OAAO,SAAS,MAAM,OAAO,IAAI;CACnF,MAAM,WAAW,MAAM,gBAAgB;EACrC,KAAK,QAAQ;EACb,KAAK,QAAQ;EACb,cAAc,QAAQ;EACtB,OAAO;CACT,CAAC;CAED,MAAM,SAAS,QAAQ,OAAO,YAAY;CAC1C,MAAM,MAAM,gBAAgB,SAAS,KAAK,QAAQ,GAAG;CACrD,MAAM,YAAY,QAAQ,kCAA0C,CAAE,YAAY;CAClF,MAAM,QAAQ,YAAY,QAAQ,WAAW,CAAC,GAAG,QAAQ;CACzD,MAAM,SAAS,SAAS,WAAW;CACnC,MAAM,OACJ,UAAU,SAAY;EAAE,GAAG,QAAQ;GAAU,WAAW;CAAO,IAAI,EAAE,GAAG,QAAQ,QAAQ;CAC1F,MAAM,EAAE,SAAS,YAAY,WAAW,QAAQ,MAAM,IAAI;CAE1D,MAAM,YAAY,YAAY,IAAI;CAClC,IAAI;CAEJ,IAAI;EACF,WAAW,MAAM,QAAQ,KAAK;GAAE;GAAQ;GAAS,MAAM;EAAQ,CAAC;CAClE,SAAS,OAAO;EACd,MAAM,IAAI,aACR,UACA,qBAAqB,SAAS,IAAI,kBAAkB,OAAO,GAAG,IAAI,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,EAAE,IAC7H,EAAE,OAAO,MAAM,CACjB;CACF;CAEA,MAAM,OAAO,MAAM,SAAS,KAAK;CACjC,MAAM,WAAW,YAAY,IAAI,IAAI;CACrC,MAAM,kBAA0C,CAAC;CAEjD,SAAS,QAAQ,SAAS,OAAO,QAAQ;EACvC,gBAAgB,OAAO;CACzB,CAAC;CAED,MAAM,YAAY,gBAAgB,aAAa;CAC/C,MAAM,SAAS,MAAM,SAAS,eAAe,WAAW;EACtD,WAAW,QAAQ;EACnB,YAAY,QAAQ;CACtB,CAAC;CAED,IAAI,CAAC,QACH,MAAM,IAAI,aACR,UACA,uCAAuC,UAAU,IAAI,OAAO,GAAG,IAAI,YAAY,SAAS,OAAO,kEAAkE,SAAS,aAAa,qBACzL;CAGF,OAAO,iBAAiB;EACtB;EACA,QAAQ,SAAS;EACjB,SAAS;GAAE;GAAQ;GAAK;GAAS,MAAM,QAAQ,QAAQ;EAAK;EAC5D,UAAU;GAAE,QAAQ,SAAS;GAAQ,SAAS;GAAiB;EAAK;EACpE;EACA;CACF,CAAC;AACH"}

package/esm/tooling/typecheck/index.mjs

@@ -0,0 +1,3 @@
+import { DEFAULT_TYPECHECK_BUILD_INFO, diagnosticToProblem, directImporters, runTypecheck } from "./run-typecheck.mjs";
+
+export { DEFAULT_TYPECHECK_BUILD_INFO, diagnosticToProblem, directImporters, runTypecheck };

package/esm/tooling/typecheck/run-typecheck.d.mts

@@ -0,0 +1,26 @@
+import { ToolingProblem } from "../problem.mjs";
+import { CompilerDiagnostic, CompilerSession } from "../typescript/compiler.mjs";
+//#region ../../packages/core/src/tooling/typecheck/run-typecheck.d.ts
+export type TypecheckOptions = {
+  cwd?: string;
+  project?: string;
+  files?: readonly string[];
+  buildInfoFile?: string;
+};
+export type TypecheckResult = {
+  ok: boolean;
+  mode: "program" | "files";
+  files: string[] | null;
+  checkedFiles: number;
+  problems: ToolingProblem[];
+  durationMs: number;
+  buildInfoFile: string | null;
+};
+export declare const DEFAULT_TYPECHECK_BUILD_INFO: string;
+export declare function diagnosticToProblem(diagnostic: CompilerDiagnostic, cwd: string, code?: "WL7101" | "WL7102"): ToolingProblem;
+/** Resolve direct importers with the native checker, including package exports and aliases. */
+export declare function directImporters(session: CompilerSession, targets: ReadonlySet<string>, root: string): Set<string>;
+/** TypeScript 7's native incremental compiler owns build state; changed mode filters its diagnostics. */
+export declare function runTypecheck(options?: TypecheckOptions): TypecheckResult;
+//#endregion
+//# sourceMappingURL=run-typecheck.d.mts.map

package/esm/tooling/typecheck/run-typecheck.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-typecheck.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/typecheck/run-typecheck.ts"],"mappings":";;;YAKY;EACV;EACA;EACA;EACA;;YAEU;EACV;EACA;EACA;EACA;EACA,UAAU;EACV;EACA;;qBAEW;wBASG,oBACd,YAAY,oBACZ,aACA,6BACC;;wBAca,gBACd,SAAS,iBACT,SAAS,qBACT,eACC;;wBAWa,aAAa,UAAS,mBAAwB"}