@warlock.js/core 5.30.0 → 5.32.0

package/esm/upgrade/codemods/logger-sync-calls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-sync-calls.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/logger-sync-calls.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\nconst SYNC_METHODS = new Set([\n  \"info\",\n  \"warn\",\n  \"error\",\n  \"debug\",\n  \"success\",\n  \"fatal\",\n  \"log\",\n  \"assert\",\n]);\n\n/**\n * 5.30: `log.info()` and its siblings return the logger instead of a promise.\n * Removes `await` in front of them; a `.then()` chained on one is listed for\n * review (code that must wait for delivery calls `await log.flush()`).\n */\nexport const loggerSyncCalls: Codemod = {\n  id: \"logger-sync-calls\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/logger\",\n  title: \"Remove `await` from synchronous log calls\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      const loggers = importedLocalNames(sourceFile, \"@warlock.js/logger\", \"log\");\n      if (loggers.size === 0) continue;\n\n      const isLogCall = (node: import(\"ts-morph\").Node): boolean => {\n        if (!Node.isCallExpression(node)) return false;\n        const callee = node.getExpression();\n        if (!Node.isPropertyAccessExpression(callee)) return false;\n        const owner = callee.getExpression();\n        return (\n          Node.isIdentifier(owner) &&\n          loggers.has(owner.getText()) &&\n          SYNC_METHODS.has(callee.getName())\n        );\n      };\n\n      for (const awaitExpression of sourceFile.getDescendantsOfKind(SyntaxKind.AwaitExpression)) {\n        const argument = awaitExpression.getExpression();\n        if (!isLogCall(argument)) continue;\n        output.edits.push(\n          replaceNode(\n            context,\n            awaitExpression,\n            argument.getText(),\n            `removed await before ${argument.getText().split(\"(\")[0]}()`,\n          ),\n        );\n      }\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        if (access.getName() !== \"then\" || !isLogCall(access.getExpression())) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            access,\n            \"`.then()` on a log call: log calls return the logger now. Run the callback directly, or `await log.flush()` first if it must wait for delivery.\",\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n"],"mappings":";;;AAGA,MAAM,+BAAe,IAAI,IAAI;CAC3B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;;;;;AAOD,MAAa,kBAA2B;CACtC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,MAAM,UAAU,mBAAmB,YAAY,sBAAsB,KAAK;GAC1E,IAAI,QAAQ,SAAS,GAAG;GAExB,MAAM,aAAa,SAA2C;IAC5D,IAAI,CAAC,KAAK,iBAAiB,IAAI,GAAG,OAAO;IACzC,MAAM,SAAS,KAAK,cAAc;IAClC,IAAI,CAAC,KAAK,2BAA2B,MAAM,GAAG,OAAO;IACrD,MAAM,QAAQ,OAAO,cAAc;IACnC,OACE,KAAK,aAAa,KAAK,KACvB,QAAQ,IAAI,MAAM,QAAQ,CAAC,KAC3B,aAAa,IAAI,OAAO,QAAQ,CAAC;GAErC;GAEA,KAAK,MAAM,mBAAmB,WAAW,qBAAqB,WAAW,eAAe,GAAG;IACzF,MAAM,WAAW,gBAAgB,cAAc;IAC/C,IAAI,CAAC,UAAU,QAAQ,GAAG;IAC1B,OAAO,MAAM,KACX,YACE,SACA,iBACA,SAAS,QAAQ,GACjB,wBAAwB,SAAS,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAC3D,CACF;GACF;GAEA,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,IAAI,OAAO,QAAQ,MAAM,UAAU,CAAC,UAAU,OAAO,cAAc,CAAC,GAAG;IACvE,OAAO,OAAO,KACZ,SACE,SACA,QACA,iJACF,CACF;GACF;EACF;EAEA,OAAO;CACT;AACF"}

package/esm/upgrade/codemods/package-json.mjs

@@ -0,0 +1,122 @@
+import { compareVersions, parseVersion } from "../version.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/package-json.ts
+const NODE_MINIMUM = "22.15.0";
+/** Keep the file's indentation and trailing newline when rewriting JSON. */
+function serialize(original, value) {
+	const indent = /^[ \t]+(?=")/m.exec(original)?.[0];
+	return (indent ? JSON.stringify(value, null, indent) : JSON.stringify(value)) + (original.endsWith("\n") ? "\n" : "");
+}
+function lineOf(source, needle) {
+	const index = source.indexOf(needle);
+	return index < 0 ? 1 : source.slice(0, index).split("\n").length;
+}
+/**
+* 5.31: the CLI needs Node.js 22.15 or newer. Raises `engines.node` in
+* package.json and the version in `.nvmrc` / `.node-version` when they allow
+* an older Node.
+*/
+const node2215 = {
+	id: "node-22-15",
+	version: "5.31.0",
+	package: "@warlock.js/core",
+	title: "Require Node.js 22.15 or newer",
+	skill: "run-app",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const source = context.text.read("package.json");
+		if (source !== void 0) {
+			const pkg = JSON.parse(source);
+			const current = pkg.engines?.node;
+			if (typeof current === "string") {
+				const minimum = parseVersion(current);
+				if (minimum && compareVersions(minimum.join("."), NODE_MINIMUM) < 0) {
+					const line = lineOf(source, "\"node\"");
+					pkg.engines = {
+						...pkg.engines,
+						node: ">=22.15"
+					};
+					context.text.write("package.json", serialize(source, pkg), {
+						line,
+						description: `engines.node "${current}" → ">=22.15"`
+					});
+				}
+			}
+		}
+		for (const file of [".nvmrc", ".node-version"]) {
+			const content = context.text.read(file);
+			if (content === void 0) continue;
+			const value = content.trim();
+			const parsed = /^v?\d/.test(value) ? parseVersion(value) : void 0;
+			if (!parsed) {
+				if (value !== "" && !/^lts\/|^node$|^latest$/i.test(value)) output.manual.push({
+					file,
+					line: 1,
+					hint: `Make sure "${value}" resolves to Node.js 22.15 or newer.`
+				});
+				continue;
+			}
+			if (compareVersions(parsed.join("."), NODE_MINIMUM) >= 0) continue;
+			const next = `${value.startsWith("v") ? "v" : ""}22.15.0`;
+			context.text.write(file, `${next}\n`, {
+				line: 1,
+				description: `Node ${value} → ${next}`
+			});
+		}
+		return output;
+	}
+};
+/** Version specs that are not a plain range and must not be rewritten. */
+const NON_REGISTRY_SPEC = /^(workspace:|file:|link:|portal:|git|github:|https?:|npm:)|^\*$|^latest$/;
+/**
+* Every upgrade: set each `@warlock.js/*` (and `create-warlock`) dependency to
+* the target version, keeping its `^`/`~`/exact style. The family is
+* released in lockstep, so mixed versions are not supported.
+*/
+const warlockVersions = {
+	id: "warlock-versions",
+	version: "target",
+	package: "@warlock.js/core",
+	title: "Move the @warlock.js packages to the target version",
+	skill: "update-packages",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const source = context.text.read("package.json");
+		if (source === void 0) return output;
+		const pkg = JSON.parse(source);
+		const changes = [];
+		for (const field of ["dependencies", "devDependencies"]) {
+			const dependencies = pkg[field];
+			if (!dependencies) continue;
+			for (const [name, spec] of Object.entries(dependencies)) {
+				if (!name.startsWith("@warlock.js/") && name !== "create-warlock") continue;
+				if (typeof spec !== "string" || NON_REGISTRY_SPEC.test(spec)) continue;
+				const next = `${/^[\^~]/.exec(spec)?.[0] ?? (/^\d/.test(spec) ? "" : "^")}${context.targetVersion}`;
+				if (next === spec) continue;
+				dependencies[name] = next;
+				changes.push({
+					name,
+					from: spec,
+					to: next
+				});
+			}
+		}
+		if (changes.length === 0) return output;
+		const first = changes[0];
+		context.text.write("package.json", serialize(source, pkg), {
+			line: first ? lineOf(source, `"${first.name}"`) : 1,
+			description: changes.map((change) => `${change.name} ${change.from} → ${change.to}`).join(", ")
+		});
+		return output;
+	}
+};
+
+//#endregion
+export { node2215, warlockVersions };
+//# sourceMappingURL=package-json.mjs.map

package/esm/upgrade/codemods/package-json.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-json.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/package-json.ts"],"sourcesContent":["import type { Codemod, CodemodOutput } from \"../types\";\nimport { compareVersions, parseVersion } from \"../version\";\n\nconst NODE_MINIMUM = \"22.15.0\";\n\ntype PackageJson = {\n  engines?: Record<string, unknown>;\n  dependencies?: Record<string, unknown>;\n  devDependencies?: Record<string, unknown>;\n};\n\n/** Keep the file's indentation and trailing newline when rewriting JSON. */\nfunction serialize(original: string, value: unknown): string {\n  const indent = /^[ \\t]+(?=\")/m.exec(original)?.[0];\n  // A one-line (minified) manifest stays on one line.\n  const json = indent ? JSON.stringify(value, null, indent) : JSON.stringify(value);\n  return json + (original.endsWith(\"\\n\") ? \"\\n\" : \"\");\n}\n\nfunction lineOf(source: string, needle: string): number {\n  const index = source.indexOf(needle);\n  return index < 0 ? 1 : source.slice(0, index).split(\"\\n\").length;\n}\n\n/**\n * 5.31: the CLI needs Node.js 22.15 or newer. Raises `engines.node` in\n * package.json and the version in `.nvmrc` / `.node-version` when they allow\n * an older Node.\n */\nexport const node2215: Codemod = {\n  id: \"node-22-15\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/core\",\n  title: \"Require Node.js 22.15 or newer\",\n  skill: \"run-app\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    const source = context.text.read(\"package.json\");\n    if (source !== undefined) {\n      const pkg = JSON.parse(source) as PackageJson;\n      const current = pkg.engines?.node;\n      if (typeof current === \"string\") {\n        const minimum = parseVersion(current);\n        if (minimum && compareVersions(minimum.join(\".\"), NODE_MINIMUM) < 0) {\n          const line = lineOf(source, '\"node\"');\n          pkg.engines = { ...pkg.engines, node: \">=22.15\" };\n          context.text.write(\"package.json\", serialize(source, pkg), {\n            line,\n            description: `engines.node \"${current}\" → \">=22.15\"`,\n          });\n        }\n      }\n    }\n\n    for (const file of [\".nvmrc\", \".node-version\"]) {\n      const content = context.text.read(file);\n      if (content === undefined) continue;\n      const value = content.trim();\n      const parsed = /^v?\\d/.test(value) ? parseVersion(value) : undefined;\n      if (!parsed) {\n        if (value !== \"\" && !/^lts\\/|^node$|^latest$/i.test(value)) {\n          output.manual.push({\n            file,\n            line: 1,\n            hint: `Make sure \"${value}\" resolves to Node.js 22.15 or newer.`,\n          });\n        }\n        continue;\n      }\n      if (compareVersions(parsed.join(\".\"), NODE_MINIMUM) >= 0) continue;\n      const next = `${value.startsWith(\"v\") ? \"v\" : \"\"}22.15.0`;\n      context.text.write(file, `${next}\\n`, { line: 1, description: `Node ${value} → ${next}` });\n    }\n\n    return output;\n  },\n};\n\n/** Version specs that are not a plain range and must not be rewritten. */\nconst NON_REGISTRY_SPEC =\n  /^(workspace:|file:|link:|portal:|git|github:|https?:|npm:)|^\\*$|^latest$/;\n\n/**\n * Every upgrade: set each `@warlock.js/*` (and `create-warlock`) dependency to\n * the target version, keeping its `^`/`~`/exact style. The family is\n * released in lockstep, so mixed versions are not supported.\n */\nexport const warlockVersions: Codemod = {\n  id: \"warlock-versions\",\n  version: \"target\",\n  package: \"@warlock.js/core\",\n  title: \"Move the @warlock.js packages to the target version\",\n  skill: \"update-packages\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    const source = context.text.read(\"package.json\");\n    if (source === undefined) return output;\n\n    const pkg = JSON.parse(source) as PackageJson;\n    const changes: { name: string; from: string; to: string }[] = [];\n\n    for (const field of [\"dependencies\", \"devDependencies\"] as const) {\n      const dependencies = pkg[field];\n      if (!dependencies) continue;\n      for (const [name, spec] of Object.entries(dependencies)) {\n        if (!name.startsWith(\"@warlock.js/\") && name !== \"create-warlock\") continue;\n        if (typeof spec !== \"string\" || NON_REGISTRY_SPEC.test(spec)) continue;\n        const prefix = /^[\\^~]/.exec(spec)?.[0] ?? (/^\\d/.test(spec) ? \"\" : \"^\");\n        const next = `${prefix}${context.targetVersion}`;\n        if (next === spec) continue;\n        dependencies[name] = next;\n        changes.push({ name, from: spec, to: next });\n      }\n    }\n\n    if (changes.length === 0) return output;\n\n    const first = changes[0];\n    context.text.write(\"package.json\", serialize(source, pkg), {\n      line: first ? lineOf(source, `\"${first.name}\"`) : 1,\n      description: changes\n        .map((change) => `${change.name} ${change.from} → ${change.to}`)\n        .join(\", \"),\n    });\n\n    return output;\n  },\n};\n"],"mappings":"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"}

package/esm/upgrade/codemods/request-log-snapshot.mjs

@@ -0,0 +1,82 @@
+import { importedLocalNames, manualAt, replaceNode } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/request-log-snapshot.ts
+/** Fields of the `RequestLogSnapshot` a log channel now receives. */
+const SNAPSHOT_FIELDS = /* @__PURE__ */ new Set([
+	"id",
+	"method",
+	"url",
+	"route",
+	"name",
+	"ip",
+	"userAgent",
+	"query",
+	"body",
+	"statusCode"
+]);
+/** `request.<a>.<b>` reads with a snapshot equivalent. */
+const REWRITES = {
+	"baseRequest.url": "url",
+	"baseRequest.method": "method",
+	"baseRequest.ip": "ip",
+	"route.path": "route",
+	"route.name": "name"
+};
+/**
+* 5.30: request log entries carry a plain `RequestLogSnapshot` in
+* `context.request`, not the `Request` instance. Inside custom log channels,
+* rewrites the reads that have a direct snapshot field and lists the rest.
+*/
+const requestLogSnapshot = {
+	id: "request-log-snapshot",
+	version: "5.30.0",
+	package: "@warlock.js/core",
+	title: "Read request log snapshots in custom log channels",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			if (importedLocalNames(sourceFile, "@warlock.js/logger", "LogChannel").size === 0) continue;
+			for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {
+				const owner = access.getExpression();
+				if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== "context") continue;
+				const target = access.getName();
+				if (target !== "request" && target !== "response") continue;
+				const chain = memberChain(Node, access);
+				if (chain.length === 0) continue;
+				const first = chain[0];
+				const second = chain[1];
+				const pair = second ? `${first.getName()}.${second.getName()}` : void 0;
+				const replacement = pair ? REWRITES[pair] : void 0;
+				if (target === "request" && replacement && second) {
+					output.edits.push(replaceNode(context, second, `${access.getText()}.${replacement}`, `context.request.${pair} → context.request.${replacement}`));
+					continue;
+				}
+				const field = first.getName();
+				const isCall = Node.isCallExpression(first.getParent());
+				const readsRouteObject = target === "request" && field === "route" && second !== void 0;
+				if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) output.manual.push(manualAt(context, first, `\`context.${target}.${field}\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \`request.toLogSnapshot()\` where the entry is logged.`));
+			}
+		}
+		return output;
+	}
+};
+/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */
+function memberChain(Node, start) {
+	const chain = [];
+	let current = start;
+	for (;;) {
+		const parent = current.getParent();
+		if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) return chain;
+		chain.push(parent);
+		current = parent;
+	}
+}
+
+//#endregion
+export { requestLogSnapshot };
+//# sourceMappingURL=request-log-snapshot.mjs.map

package/esm/upgrade/codemods/request-log-snapshot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-log-snapshot.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/request-log-snapshot.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { Codemod, CodemodOutput } from \"../types\";\nimport { importedLocalNames, manualAt, replaceNode } from \"./helpers\";\n\n/** Fields of the `RequestLogSnapshot` a log channel now receives. */\nconst SNAPSHOT_FIELDS = new Set([\n  \"id\",\n  \"method\",\n  \"url\",\n  \"route\",\n  \"name\",\n  \"ip\",\n  \"userAgent\",\n  \"query\",\n  \"body\",\n  \"statusCode\",\n]);\n\n/** `request.<a>.<b>` reads with a snapshot equivalent. */\nconst REWRITES: Record<string, string> = {\n  \"baseRequest.url\": \"url\",\n  \"baseRequest.method\": \"method\",\n  \"baseRequest.ip\": \"ip\",\n  \"route.path\": \"route\",\n  \"route.name\": \"name\",\n};\n\n/**\n * 5.30: request log entries carry a plain `RequestLogSnapshot` in\n * `context.request`, not the `Request` instance. Inside custom log channels,\n * rewrites the reads that have a direct snapshot field and lists the rest.\n */\nexport const requestLogSnapshot: Codemod = {\n  id: \"request-log-snapshot\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/core\",\n  title: \"Read request log snapshots in custom log channels\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (importedLocalNames(sourceFile, \"@warlock.js/logger\", \"LogChannel\").size === 0) continue;\n\n      for (const access of sourceFile.getDescendantsOfKind(SyntaxKind.PropertyAccessExpression)) {\n        const owner = access.getExpression();\n        // `<anything>.context.request` / `.context.response`\n        if (!Node.isPropertyAccessExpression(owner) || owner.getName() !== \"context\") continue;\n        const target = access.getName();\n        if (target !== \"request\" && target !== \"response\") continue;\n\n        const chain = memberChain(Node, access);\n        if (chain.length === 0) continue;\n\n        const first = chain[0] as TsMorph.PropertyAccessExpression;\n        const second = chain[1];\n        const pair = second ? `${first.getName()}.${second.getName()}` : undefined;\n        const replacement = pair ? REWRITES[pair] : undefined;\n\n        if (target === \"request\" && replacement && second) {\n          output.edits.push(\n            replaceNode(\n              context,\n              second,\n              `${access.getText()}.${replacement}`,\n              `context.request.${pair} → context.request.${replacement}`,\n            ),\n          );\n          continue;\n        }\n\n        const field = first.getName();\n        const isCall = Node.isCallExpression(first.getParent());\n        // `route` is the matched pattern string now, not the route object.\n        const readsRouteObject = target === \"request\" && field === \"route\" && second !== undefined;\n        if (!SNAPSHOT_FIELDS.has(field) || isCall || readsRouteObject) {\n          output.manual.push(\n            manualAt(\n              context,\n              first,\n              `\\`context.${target}.${field}\\` is not on the log snapshot ({ id, method, url, route, name, ip, userAgent, query?, body? }). Read a snapshot field, or call \\`request.toLogSnapshot()\\` where the entry is logged.`,\n            ),\n          );\n        }\n      }\n    }\n\n    return output;\n  },\n};\n\n/** `x.context.request.a.b` → [`…request.a`, `…request.a.b`]. */\nfunction memberChain(\n  Node: typeof TsMorph.Node,\n  start: TsMorph.PropertyAccessExpression,\n): TsMorph.PropertyAccessExpression[] {\n  const chain: TsMorph.PropertyAccessExpression[] = [];\n  let current: TsMorph.Node = start;\n\n  for (;;) {\n    const parent = current.getParent();\n    if (!parent || !Node.isPropertyAccessExpression(parent) || parent.getExpression() !== current) {\n      return chain;\n    }\n    chain.push(parent);\n    current = parent;\n  }\n}\n"],"mappings":";;;;AAKA,MAAM,kCAAkB,IAAI,IAAI;CAC9B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC;;AAGD,MAAM,WAAmC;CACvC,mBAAmB;CACnB,sBAAsB;CACtB,kBAAkB;CAClB,cAAc;CACd,cAAc;AAChB;;;;;;AAOA,MAAa,qBAA8B;CACzC,IAAI;CACJ,SAAS;CACT,SAAS;CACT,OAAO;CACP,OAAO;CACP,IAAI,SAAS;EACX,MAAM,EAAE,MAAM,eAAe,QAAQ;EACrC,MAAM,SAAwB;GAAE,OAAO,CAAC;GAAG,QAAQ,CAAC;EAAE;EAEtD,KAAK,MAAM,cAAc,QAAQ,aAAa;GAC5C,IAAI,mBAAmB,YAAY,sBAAsB,YAAY,CAAC,CAAC,SAAS,GAAG;GAEnF,KAAK,MAAM,UAAU,WAAW,qBAAqB,WAAW,wBAAwB,GAAG;IACzF,MAAM,QAAQ,OAAO,cAAc;IAEnC,IAAI,CAAC,KAAK,2BAA2B,KAAK,KAAK,MAAM,QAAQ,MAAM,WAAW;IAC9E,MAAM,SAAS,OAAO,QAAQ;IAC9B,IAAI,WAAW,aAAa,WAAW,YAAY;IAEnD,MAAM,QAAQ,YAAY,MAAM,MAAM;IACtC,IAAI,MAAM,WAAW,GAAG;IAExB,MAAM,QAAQ,MAAM;IACpB,MAAM,SAAS,MAAM;IACrB,MAAM,OAAO,SAAS,GAAG,MAAM,QAAQ,EAAE,GAAG,OAAO,QAAQ,MAAM;IACjE,MAAM,cAAc,OAAO,SAAS,QAAQ;IAE5C,IAAI,WAAW,aAAa,eAAe,QAAQ;KACjD,OAAO,MAAM,KACX,YACE,SACA,QACA,GAAG,OAAO,QAAQ,EAAE,GAAG,eACvB,mBAAmB,KAAK,qBAAqB,aAC/C,CACF;KACA;IACF;IAEA,MAAM,QAAQ,MAAM,QAAQ;IAC5B,MAAM,SAAS,KAAK,iBAAiB,MAAM,UAAU,CAAC;IAEtD,MAAM,mBAAmB,WAAW,aAAa,UAAU,WAAW,WAAW;IACjF,IAAI,CAAC,gBAAgB,IAAI,KAAK,KAAK,UAAU,kBAC3C,OAAO,OAAO,KACZ,SACE,SACA,OACA,aAAa,OAAO,GAAG,MAAM,sLAC/B,CACF;GAEJ;EACF;EAEA,OAAO;CACT;AACF;;AAGA,SAAS,YACP,MACA,OACoC;CACpC,MAAM,QAA4C,CAAC;CACnD,IAAI,UAAwB;CAE5B,SAAS;EACP,MAAM,SAAS,QAAQ,UAAU;EACjC,IAAI,CAAC,UAAU,CAAC,KAAK,2BAA2B,MAAM,KAAK,OAAO,cAAc,MAAM,SACpF,OAAO;EAET,MAAM,KAAK,MAAM;EACjB,UAAU;CACZ;AACF"}

package/esm/upgrade/codemods/review-sites.mjs

@@ -0,0 +1,262 @@
+import { importedLocalNames, importsFrom, manualAt, objectProperty, objectPropertyNames } from "./helpers.mjs";
+
+//#region ../../packages/core/src/upgrade/codemods/review-sites.ts
+/**
+* Breaking changes that are behavioural decisions, not mechanical edits. These
+* codemods change nothing; they list every call site to review with the
+* reason, so nothing is missed.
+*/
+/** Call expressions in files that import from `moduleName`. */
+function callsIn(context, moduleName) {
+	const { SyntaxKind } = context.tsMorph;
+	return context.sourceFiles.filter((sourceFile) => importsFrom(sourceFile, moduleName)).flatMap((sourceFile) => sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression));
+}
+function calleeName(context, call) {
+	const { Node } = context.tsMorph;
+	const callee = call.getExpression();
+	if (Node.isIdentifier(callee)) return callee.getText();
+	if (Node.isPropertyAccessExpression(callee)) return callee.getName();
+}
+/** `v.object(...)....catch(` → whether the chain starts at a container factory. */
+function chainRoot(context, call) {
+	const { Node } = context.tsMorph;
+	let current = call.getExpression();
+	let root;
+	for (;;) {
+		if (Node.isPropertyAccessExpression(current)) {
+			current = current.getExpression();
+			continue;
+		}
+		if (Node.isCallExpression(current)) {
+			const callee = current.getExpression();
+			if (Node.isPropertyAccessExpression(callee)) root = callee.getText();
+			current = callee;
+			continue;
+		}
+		return root;
+	}
+}
+const sealValidateResult = {
+	id: "seal-validate-result",
+	version: "5.30.0",
+	package: "@warlock.js/seal",
+	title: "Check `isValid` before reading `validate()` data",
+	skill: "seal-basics",
+	run(context) {
+		const { Node } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			const validators = importedLocalNames(sourceFile, "@warlock.js/seal", "validate");
+			if (validators.size === 0) continue;
+			const text = sourceFile.getFullText();
+			for (const call of sourceFile.getDescendantsOfKind(context.tsMorph.SyntaxKind.CallExpression)) {
+				const callee = call.getExpression();
+				if (!Node.isIdentifier(callee) || !validators.has(callee.getText())) continue;
+				const name = call.getFirstAncestorByKind(context.tsMorph.SyntaxKind.VariableDeclaration)?.getNameNode();
+				if (!name || !Node.isIdentifier(name)) continue;
+				const variable = name.getText();
+				if (!text.includes(`${variable}.data`) || text.includes(`${variable}.isValid`)) continue;
+				output.manual.push(manualAt(context, call, `\`${variable}.data\` is \`undefined\` when validation fails and typed only after \`if (${variable}.isValid)\`. Check it before reading the data.`));
+			}
+		}
+		return output;
+	}
+};
+const aiToolDispatch = {
+	id: "ai-tool-dispatch",
+	version: "5.30.0",
+	package: "@warlock.js/ai",
+	title: "Review agents whose tools now run concurrently",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const call of callsIn(context, "@warlock.js/ai")) {
+			const name = calleeName(context, call);
+			if (name !== "agent" && name !== "spawnSubAgent") continue;
+			const options = call.getArguments()[0];
+			if (!options || !Node.isObjectLiteralExpression(options)) continue;
+			const keys = objectPropertyNames(context.tsMorph, options);
+			if (!keys.has("tools") || keys.has("toolDispatch") || keys.has("maxConcurrentTools")) continue;
+			output.manual.push(manualAt(context, call, `\`${name}()\` with tools now runs one trip's tools concurrently (up to 4). If a tool depends on another's side effects, set \`toolDispatch: "sequential"\`.`));
+		}
+		return output;
+	}
+};
+const RESERVED_ANTHROPIC_BODY_KEYS = [
+	"model",
+	"messages",
+	"system",
+	"tools",
+	"mcp_servers",
+	"stream"
+];
+const aiAnthropicBody = {
+	id: "ai-anthropic-body",
+	version: "5.30.0",
+	package: "@warlock.js/ai-anthropic",
+	title: "Move reserved keys out of `providerOptions.anthropic.body`",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node, SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) for (const literal of sourceFile.getDescendantsOfKind(SyntaxKind.ObjectLiteralExpression)) {
+			const anthropic = objectProperty(context.tsMorph, literal, "anthropic");
+			if (!anthropic || !Node.isObjectLiteralExpression(anthropic)) continue;
+			const parent = literal.getParent();
+			if (!parent || !Node.isPropertyAssignment(parent) || parent.getName() !== "providerOptions") continue;
+			const body = objectProperty(context.tsMorph, anthropic, "body");
+			if (!body || !Node.isObjectLiteralExpression(body)) continue;
+			const reserved = RESERVED_ANTHROPIC_BODY_KEYS.filter((key) => objectPropertyNames(context.tsMorph, body).has(key));
+			if (reserved.length === 0) continue;
+			output.manual.push(manualAt(context, body, `\`providerOptions.anthropic.body\` can no longer set ${reserved.map((key) => `\`${key}\``).join(", ")} (it throws InvalidRequestError). Use the normal model/messages/tools options.`));
+		}
+		return output;
+	}
+};
+const aiFinishReason = {
+	id: "ai-finish-reason",
+	version: "5.30.0",
+	package: "@warlock.js/ai",
+	title: "Handle the new finish reasons",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { SyntaxKind } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const sourceFile of context.sourceFiles) {
+			if (!importsFrom(sourceFile, "@warlock.js/ai")) continue;
+			for (const statement of sourceFile.getDescendantsOfKind(SyntaxKind.SwitchStatement)) {
+				if (!/finishReason$/.test(statement.getExpression().getText())) continue;
+				output.manual.push(manualAt(context, statement, "A `finishReason` switch: 5.30 adds \"context_exceeded\", \"pause_turn\" and \"refusal\" (Anthropic used to report them as \"length\"/\"error\"). Handle each."));
+			}
+		}
+		return output;
+	}
+};
+const sealRefineOutput = {
+	id: "seal-refine-output",
+	version: "5.31.0",
+	package: "@warlock.js/seal",
+	title: "Review `.refine()` callbacks",
+	skill: "seal-basics",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const call of callsIn(context, "@warlock.js/seal")) {
+			if (calleeName(context, call) !== "refine") continue;
+			output.manual.push(manualAt(context, call, "`.refine()` now runs on the validated output, after child rules and transforms, and skips absent/null/invalid values. Move checks that need the raw input to `.addRule()`."));
+		}
+		return output;
+	}
+};
+const CONTAINERS = /^v\.(object|array|record|tuple)$/;
+const sealContainerCatch = {
+	id: "seal-container-catch",
+	version: "5.31.0",
+	package: "@warlock.js/seal",
+	title: "Move `.catch()` off container validators",
+	skill: "seal-basics",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const call of callsIn(context, "@warlock.js/seal")) {
+			if (calleeName(context, call) !== "catch") continue;
+			const root = chainRoot(context, call);
+			if (!root || !CONTAINERS.test(root)) continue;
+			output.manual.push(manualAt(context, call, `\`.catch()\` on \`${root}()\` is now a no-op, including for the container's own rules. Put the catch on the child validators, or handle the failed result.`));
+		}
+		return output;
+	}
+};
+const sealUnionOutput = {
+	id: "seal-union-output",
+	version: "5.31.0",
+	package: "@warlock.js/seal",
+	title: "Review `v.union()` output",
+	skill: "seal-basics",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const call of callsIn(context, "@warlock.js/seal")) {
+			if (call.getExpression().getText() !== "v.union") continue;
+			output.manual.push(manualAt(context, call, "`v.union()` now returns the matched branch's validated output (trimmed strings, parsed dates, defaults, stripped keys). Check code that persists or compares it."));
+		}
+		return output;
+	}
+};
+const aiCompactionOptIn = {
+	id: "ai-compaction-opt-in",
+	version: "5.31.0",
+	package: "@warlock.js/ai",
+	title: "Give agent compaction its required settings",
+	skill: "upgrade-from-5-29",
+	run(context) {
+		const { Node } = context.tsMorph;
+		const output = {
+			edits: [],
+			manual: []
+		};
+		for (const call of callsIn(context, "@warlock.js/ai")) {
+			if (calleeName(context, call) !== "agent") continue;
+			const options = call.getArguments()[0];
+			if (!options || !Node.isObjectLiteralExpression(options)) continue;
+			const compaction = objectProperty(context.tsMorph, options, "compaction");
+			if (!compaction) continue;
+			const keys = Node.isObjectLiteralExpression(compaction) ? objectPropertyNames(context.tsMorph, compaction) : /* @__PURE__ */ new Set();
+			if (keys.has("afterTokens") && keys.has("summarize")) continue;
+			output.manual.push(manualAt(context, compaction, "`compaction` is opt-in in 5.31 and needs `afterTokens` and a `summarize` callback (optional `keep`, `countTokens`)."));
+		}
+		return output;
+	}
+};
+const rateLimitDefaults = {
+	id: "rate-limit-defaults",
+	version: "5.31.0",
+	package: "@warlock.js/core",
+	title: "Review the rate limit that now applies everywhere",
+	skill: "configure-app",
+	run(context) {
+		const output = {
+			edits: [],
+			manual: []
+		};
+		const hint = "Rate limits now apply in production and development to every route, page and static asset: 60 requests/minute per IP by default, shared. Review `http.rateLimit.max`, set `trustProxy` or a `keyGenerator` behind a proxy, or `global: false` to keep only per-route limits.";
+		const httpConfig = context.sourceFiles.find((sourceFile) => context.relativePath(sourceFile).match(/^src\/config\/http\.tsx?$/));
+		if (!httpConfig) {
+			output.manual.push({
+				file: "src/config/http.ts",
+				line: 1,
+				hint
+			});
+			return output;
+		}
+		if (!/\brateLimit\s*:/.test(httpConfig.getFullText())) output.manual.push({
+			file: context.relativePath(httpConfig),
+			line: 1,
+			hint
+		});
+		return output;
+	}
+};
+
+//#endregion
+export { aiAnthropicBody, aiCompactionOptIn, aiFinishReason, aiToolDispatch, rateLimitDefaults, sealContainerCatch, sealRefineOutput, sealUnionOutput, sealValidateResult };
+//# sourceMappingURL=review-sites.mjs.map

package/esm/upgrade/codemods/review-sites.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-sites.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/upgrade/codemods/review-sites.ts"],"sourcesContent":["import type * as TsMorph from \"ts-morph\";\nimport type { Codemod, CodemodContext, CodemodOutput } from \"../types\";\nimport {\n  importedLocalNames,\n  importsFrom,\n  manualAt,\n  objectProperty,\n  objectPropertyNames,\n} from \"./helpers\";\n\n/**\n * Breaking changes that are behavioural decisions, not mechanical edits. These\n * codemods change nothing; they list every call site to review with the\n * reason, so nothing is missed.\n */\n\n/** Call expressions in files that import from `moduleName`. */\nfunction callsIn(context: CodemodContext, moduleName: string): TsMorph.CallExpression[] {\n  const { SyntaxKind } = context.tsMorph;\n  return context.sourceFiles\n    .filter((sourceFile) => importsFrom(sourceFile, moduleName))\n    .flatMap((sourceFile) => sourceFile.getDescendantsOfKind(SyntaxKind.CallExpression));\n}\n\nfunction calleeName(context: CodemodContext, call: TsMorph.CallExpression): string | undefined {\n  const { Node } = context.tsMorph;\n  const callee = call.getExpression();\n  if (Node.isIdentifier(callee)) return callee.getText();\n  if (Node.isPropertyAccessExpression(callee)) return callee.getName();\n  return undefined;\n}\n\n/** `v.object(...)....catch(` → whether the chain starts at a container factory. */\nfunction chainRoot(context: CodemodContext, call: TsMorph.CallExpression): string | undefined {\n  const { Node } = context.tsMorph;\n  let current: TsMorph.Node = call.getExpression();\n  let root: string | undefined;\n  for (;;) {\n    if (Node.isPropertyAccessExpression(current)) {\n      current = current.getExpression();\n      continue;\n    }\n    if (Node.isCallExpression(current)) {\n      const callee = current.getExpression();\n      if (Node.isPropertyAccessExpression(callee)) root = callee.getText();\n      current = callee;\n      continue;\n    }\n    return root;\n  }\n}\n\nexport const sealValidateResult: Codemod = {\n  id: \"seal-validate-result\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/seal\",\n  title: \"Check `isValid` before reading `validate()` data\",\n  skill: \"seal-basics\",\n  run(context) {\n    const { Node } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      const validators = importedLocalNames(sourceFile, \"@warlock.js/seal\", \"validate\");\n      if (validators.size === 0) continue;\n      const text = sourceFile.getFullText();\n\n      for (const call of sourceFile.getDescendantsOfKind(\n        context.tsMorph.SyntaxKind.CallExpression,\n      )) {\n        const callee = call.getExpression();\n        if (!Node.isIdentifier(callee) || !validators.has(callee.getText())) continue;\n        const declaration = call.getFirstAncestorByKind(\n          context.tsMorph.SyntaxKind.VariableDeclaration,\n        );\n        const name = declaration?.getNameNode();\n        if (!name || !Node.isIdentifier(name)) continue;\n        const variable = name.getText();\n        if (!text.includes(`${variable}.data`) || text.includes(`${variable}.isValid`)) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            call,\n            `\\`${variable}.data\\` is \\`undefined\\` when validation fails and typed only after \\`if (${variable}.isValid)\\`. Check it before reading the data.`,\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n\nexport const aiToolDispatch: Codemod = {\n  id: \"ai-tool-dispatch\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/ai\",\n  title: \"Review agents whose tools now run concurrently\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const call of callsIn(context, \"@warlock.js/ai\")) {\n      const name = calleeName(context, call);\n      if (name !== \"agent\" && name !== \"spawnSubAgent\") continue;\n      const options = call.getArguments()[0];\n      if (!options || !Node.isObjectLiteralExpression(options)) continue;\n      const keys = objectPropertyNames(context.tsMorph, options);\n      if (!keys.has(\"tools\") || keys.has(\"toolDispatch\") || keys.has(\"maxConcurrentTools\"))\n        continue;\n      output.manual.push(\n        manualAt(\n          context,\n          call,\n          `\\`${name}()\\` with tools now runs one trip's tools concurrently (up to 4). If a tool depends on another's side effects, set \\`toolDispatch: \"sequential\"\\`.`,\n        ),\n      );\n    }\n\n    return output;\n  },\n};\n\nconst RESERVED_ANTHROPIC_BODY_KEYS = [\n  \"model\",\n  \"messages\",\n  \"system\",\n  \"tools\",\n  \"mcp_servers\",\n  \"stream\",\n];\n\nexport const aiAnthropicBody: Codemod = {\n  id: \"ai-anthropic-body\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/ai-anthropic\",\n  title: \"Move reserved keys out of `providerOptions.anthropic.body`\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node, SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      for (const literal of sourceFile.getDescendantsOfKind(SyntaxKind.ObjectLiteralExpression)) {\n        const anthropic = objectProperty(context.tsMorph, literal, \"anthropic\");\n        if (!anthropic || !Node.isObjectLiteralExpression(anthropic)) continue;\n        const parent = literal.getParent();\n        if (\n          !parent ||\n          !Node.isPropertyAssignment(parent) ||\n          parent.getName() !== \"providerOptions\"\n        ) {\n          continue;\n        }\n        const body = objectProperty(context.tsMorph, anthropic, \"body\");\n        if (!body || !Node.isObjectLiteralExpression(body)) continue;\n        const reserved = RESERVED_ANTHROPIC_BODY_KEYS.filter((key) =>\n          objectPropertyNames(context.tsMorph, body).has(key),\n        );\n        if (reserved.length === 0) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            body,\n            `\\`providerOptions.anthropic.body\\` can no longer set ${reserved.map((key) => `\\`${key}\\``).join(\", \")} (it throws InvalidRequestError). Use the normal model/messages/tools options.`,\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n\nexport const aiFinishReason: Codemod = {\n  id: \"ai-finish-reason\",\n  version: \"5.30.0\",\n  package: \"@warlock.js/ai\",\n  title: \"Handle the new finish reasons\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { SyntaxKind } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n\n    for (const sourceFile of context.sourceFiles) {\n      if (!importsFrom(sourceFile, \"@warlock.js/ai\")) continue;\n      for (const statement of sourceFile.getDescendantsOfKind(SyntaxKind.SwitchStatement)) {\n        if (!/finishReason$/.test(statement.getExpression().getText())) continue;\n        output.manual.push(\n          manualAt(\n            context,\n            statement,\n            'A `finishReason` switch: 5.30 adds \"context_exceeded\", \"pause_turn\" and \"refusal\" (Anthropic used to report them as \"length\"/\"error\"). Handle each.',\n          ),\n        );\n      }\n    }\n\n    return output;\n  },\n};\n\nexport const sealRefineOutput: Codemod = {\n  id: \"seal-refine-output\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/seal\",\n  title: \"Review `.refine()` callbacks\",\n  skill: \"seal-basics\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    for (const call of callsIn(context, \"@warlock.js/seal\")) {\n      if (calleeName(context, call) !== \"refine\") continue;\n      output.manual.push(\n        manualAt(\n          context,\n          call,\n          \"`.refine()` now runs on the validated output, after child rules and transforms, and skips absent/null/invalid values. Move checks that need the raw input to `.addRule()`.\",\n        ),\n      );\n    }\n    return output;\n  },\n};\n\nconst CONTAINERS = /^v\\.(object|array|record|tuple)$/;\n\nexport const sealContainerCatch: Codemod = {\n  id: \"seal-container-catch\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/seal\",\n  title: \"Move `.catch()` off container validators\",\n  skill: \"seal-basics\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    for (const call of callsIn(context, \"@warlock.js/seal\")) {\n      if (calleeName(context, call) !== \"catch\") continue;\n      const root = chainRoot(context, call);\n      if (!root || !CONTAINERS.test(root)) continue;\n      output.manual.push(\n        manualAt(\n          context,\n          call,\n          `\\`.catch()\\` on \\`${root}()\\` is now a no-op, including for the container's own rules. Put the catch on the child validators, or handle the failed result.`,\n        ),\n      );\n    }\n    return output;\n  },\n};\n\nexport const sealUnionOutput: Codemod = {\n  id: \"seal-union-output\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/seal\",\n  title: \"Review `v.union()` output\",\n  skill: \"seal-basics\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    for (const call of callsIn(context, \"@warlock.js/seal\")) {\n      if (call.getExpression().getText() !== \"v.union\") continue;\n      output.manual.push(\n        manualAt(\n          context,\n          call,\n          \"`v.union()` now returns the matched branch's validated output (trimmed strings, parsed dates, defaults, stripped keys). Check code that persists or compares it.\",\n        ),\n      );\n    }\n    return output;\n  },\n};\n\nexport const aiCompactionOptIn: Codemod = {\n  id: \"ai-compaction-opt-in\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/ai\",\n  title: \"Give agent compaction its required settings\",\n  skill: \"upgrade-from-5-29\",\n  run(context) {\n    const { Node } = context.tsMorph;\n    const output: CodemodOutput = { edits: [], manual: [] };\n    for (const call of callsIn(context, \"@warlock.js/ai\")) {\n      if (calleeName(context, call) !== \"agent\") continue;\n      const options = call.getArguments()[0];\n      if (!options || !Node.isObjectLiteralExpression(options)) continue;\n      const compaction = objectProperty(context.tsMorph, options, \"compaction\");\n      if (!compaction) continue;\n      const keys = Node.isObjectLiteralExpression(compaction)\n        ? objectPropertyNames(context.tsMorph, compaction)\n        : new Set<string>();\n      if (keys.has(\"afterTokens\") && keys.has(\"summarize\")) continue;\n      output.manual.push(\n        manualAt(\n          context,\n          compaction,\n          \"`compaction` is opt-in in 5.31 and needs `afterTokens` and a `summarize` callback (optional `keep`, `countTokens`).\",\n        ),\n      );\n    }\n    return output;\n  },\n};\n\nexport const rateLimitDefaults: Codemod = {\n  id: \"rate-limit-defaults\",\n  version: \"5.31.0\",\n  package: \"@warlock.js/core\",\n  title: \"Review the rate limit that now applies everywhere\",\n  skill: \"configure-app\",\n  run(context) {\n    const output: CodemodOutput = { edits: [], manual: [] };\n    const hint =\n      \"Rate limits now apply in production and development to every route, page and static asset: 60 requests/minute per IP by default, shared. Review `http.rateLimit.max`, set `trustProxy` or a `keyGenerator` behind a proxy, or `global: false` to keep only per-route limits.\";\n\n    const httpConfig = context.sourceFiles.find((sourceFile) =>\n      context.relativePath(sourceFile).match(/^src\\/config\\/http\\.tsx?$/),\n    );\n    if (!httpConfig) {\n      output.manual.push({ file: \"src/config/http.ts\", line: 1, hint });\n      return output;\n    }\n    if (!/\\brateLimit\\s*:/.test(httpConfig.getFullText())) {\n      output.manual.push({ file: context.relativePath(httpConfig), line: 1, hint });\n    }\n    return output;\n  },\n};\n"],"mappings":"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"}