@tailor-platform/sdk-codemod 0.3.9 → 0.4.0-next.10

package/dist/codemods/v2/db-type-to-table/scripts/transform.js

@@ -0,0 +1,383 @@
+import { a as importSource, i as importBindings, r as findImportStatements } from "../../../ast-grep-helpers-CXtWn3RB.js";
+import { Lang, parse } from "@ast-grep/napi";
+//#region codemods/v2/db-type-to-table/scripts/transform.ts
+const SDK_MODULE = "@tailor-platform/sdk";
+function sourceLang(filePath, source) {
+	return filePath.endsWith(".tsx") || filePath.endsWith(".jsx") || source.includes("</") ? Lang.Tsx : Lang.TypeScript;
+}
+function namespaceImportNames(importStmt) {
+	return importStmt.findAll({ rule: { kind: "namespace_import" } }).flatMap((node) => node.children().filter((child) => child.kind() === "identifier")).map((node) => node.text());
+}
+function isInsideImportStatement(node) {
+	let current = node.parent();
+	while (current) {
+		if (current.kind() === "import_statement") return true;
+		current = current.parent();
+	}
+	return false;
+}
+function isBindingLeafKind(kind) {
+	return kind === "identifier" || kind === "shorthand_property_identifier_pattern";
+}
+function isBindingPatternKind(kind) {
+	return isBindingLeafKind(kind) || kind === "object_pattern" || kind === "array_pattern" || kind === "rest_pattern";
+}
+function collectBindingNodes(node, names, result) {
+	if (isBindingLeafKind(node.kind())) {
+		if (names.has(node.text())) result.push(node);
+		return;
+	}
+	for (const child of node.children()) {
+		if (child.kind() === "property_identifier") continue;
+		if (child.kind() === "=") break;
+		collectBindingNodes(child, names, result);
+	}
+}
+function bindingNodes(node, names) {
+	const result = [];
+	collectBindingNodes(node, names, result);
+	return result;
+}
+function directBindingNodes(node, names) {
+	const result = [];
+	for (const child of node.children()) {
+		if (child.kind() === "=") break;
+		if (isBindingPatternKind(child.kind())) collectBindingNodes(child, names, result);
+	}
+	return result;
+}
+function firstDeclaratorChild(node) {
+	return node.children().find((child) => child.kind() !== "=") ?? null;
+}
+function declaratorValue(node) {
+	const children = node.children();
+	const equalsIndex = children.findIndex((child) => child.kind() === "=");
+	if (equalsIndex === -1) return null;
+	return children.slice(equalsIndex + 1).find((child) => child.kind() !== "comment") ?? null;
+}
+function assignmentTarget(node) {
+	const children = node.children();
+	const equalsIndex = children.findIndex((child) => child.kind() === "=");
+	if (equalsIndex === -1) return null;
+	return children.slice(0, equalsIndex).find((child) => child.kind() !== "comment") ?? null;
+}
+function assignmentValue(node) {
+	const children = node.children();
+	const equalsIndex = children.findIndex((child) => child.kind() === "=");
+	if (equalsIndex === -1) return null;
+	return children.slice(equalsIndex + 1).find((child) => child.kind() !== "comment") ?? null;
+}
+function parameterDefaultTarget(node) {
+	const children = node.children();
+	const equalsIndex = children.findIndex((child) => child.kind() === "=");
+	if (equalsIndex === -1) return null;
+	return children.slice(0, equalsIndex).find((child) => isBindingPatternKind(child.kind())) ?? null;
+}
+function parameterDefaultValue(node) {
+	const children = node.children();
+	const equalsIndex = children.findIndex((child) => child.kind() === "=");
+	if (equalsIndex === -1) return null;
+	return children.slice(equalsIndex + 1).find((child) => child.kind() !== "comment") ?? null;
+}
+function addShadowedRange(shadowedRanges, name, scopeNode) {
+	const range = scopeNode.range();
+	if (!shadowedRanges.has(name)) shadowedRanges.set(name, []);
+	shadowedRanges.get(name).push({
+		start: range.start.index,
+		end: range.end.index
+	});
+}
+function nearestScope(node) {
+	let current = node.parent();
+	while (current) {
+		const kind = current.kind();
+		if (kind === "statement_block" || kind === "program" || kind === "switch_body" || kind === "for_statement" || kind === "for_in_statement") return current;
+		current = current.parent();
+	}
+	return node;
+}
+function functionScope(node) {
+	let current = node.parent();
+	while (current) {
+		const kind = current.kind();
+		if (kind === "function_declaration" || kind === "function_expression" || kind === "arrow_function" || kind === "method_definition" || kind === "program") return current;
+		current = current.parent();
+	}
+	return node;
+}
+function variableDeclarationScope(node) {
+	const declaration = node.parent();
+	if (/^var\b/.test(declaration?.text().trimStart() ?? "")) return functionScope(node);
+	return nearestScope(node);
+}
+function parameterScope(node) {
+	let current = node.parent();
+	while (current) {
+		const kind = current.kind();
+		if (kind === "formal_parameters") {
+			current = current.parent();
+			continue;
+		}
+		if (kind === "function_declaration" || kind === "function_expression" || kind === "arrow_function" || kind === "method_definition") return current;
+		break;
+	}
+	return nearestScope(node);
+}
+function buildShadowedRanges(root, names) {
+	const shadowedRanges = /* @__PURE__ */ new Map();
+	for (const decl of root.findAll({ rule: { kind: "variable_declarator" } })) {
+		if (isInsideImportStatement(decl)) continue;
+		const binding = firstDeclaratorChild(decl);
+		if (!binding) continue;
+		for (const name of bindingNodes(binding, names)) addShadowedRange(shadowedRanges, name.text(), variableDeclarationScope(decl));
+	}
+	for (const decl of root.findAll({ rule: { any: [
+		{ kind: "function_declaration" },
+		{ kind: "class_declaration" },
+		{ kind: "enum_declaration" }
+	] } })) {
+		const name = decl.children().find((child) => child.kind() === "identifier" && names.has(child.text()));
+		if (name) addShadowedRange(shadowedRanges, name.text(), nearestScope(decl));
+	}
+	for (const param of root.findAll({ rule: { any: [{ kind: "required_parameter" }, { kind: "optional_parameter" }] } })) for (const name of directBindingNodes(param, names)) addShadowedRange(shadowedRanges, name.text(), parameterScope(param));
+	for (const arrow of root.findAll({ rule: { kind: "arrow_function" } })) {
+		const children = arrow.children();
+		const arrowIndex = children.findIndex((child) => child.kind() === "=>");
+		if (arrowIndex === -1) continue;
+		for (const child of children.slice(0, arrowIndex)) {
+			if (child.kind() === "=") break;
+			if (!isBindingPatternKind(child.kind())) continue;
+			for (const name of bindingNodes(child, names)) addShadowedRange(shadowedRanges, name.text(), arrow);
+		}
+	}
+	for (const catchClause of root.findAll({ rule: { kind: "catch_clause" } })) for (const name of directBindingNodes(catchClause, names)) addShadowedRange(shadowedRanges, name.text(), catchClause);
+	for (const loop of root.findAll({ rule: { kind: "for_in_statement" } })) {
+		const children = loop.children();
+		const keywordIndex = children.findIndex((child) => child.kind() === "in" || child.kind() === "of");
+		if (keywordIndex === -1) continue;
+		for (const child of children.slice(0, keywordIndex)) for (const name of bindingNodes(child, names)) addShadowedRange(shadowedRanges, name.text(), loop);
+	}
+	return shadowedRanges;
+}
+function isShadowed(node, shadowedRanges) {
+	const ranges = shadowedRanges.get(node.text());
+	if (!ranges) return false;
+	const position = node.range().start.index;
+	return ranges.some((range) => position >= range.start && position < range.end);
+}
+function unwrapExpression(node) {
+	let current = node;
+	while (current) {
+		const kind = current.kind();
+		if (kind === "parenthesized_expression") {
+			current = current.children().find((child) => child.kind() !== "(" && child.kind() !== ")") ?? null;
+			continue;
+		}
+		if (kind === "as_expression" || kind === "satisfies_expression" || kind === "non_null_expression") {
+			current = current.children()[0] ?? null;
+			continue;
+		}
+		if (kind === "type_assertion") {
+			current = current.children().find((child) => child.kind() !== "type_arguments") ?? null;
+			continue;
+		}
+		return current;
+	}
+	return null;
+}
+function isSdkDbMember(object, dbNames, namespaceNames, shadowedRanges) {
+	const unwrapped = unwrapExpression(object);
+	if (!unwrapped) return false;
+	if (unwrapped.kind() === "identifier") return dbNames.has(unwrapped.text()) && !isShadowed(unwrapped, shadowedRanges);
+	if (unwrapped.kind() !== "member_expression") return false;
+	const base = unwrapExpression(unwrapped.field("object"));
+	const property = memberProperty(unwrapped);
+	return base?.kind() === "identifier" && namespaceNames.has(base.text()) && !isShadowed(base, shadowedRanges) && property?.text() === "db";
+}
+function memberProperty(member) {
+	const children = member.children();
+	for (let index = children.length - 1; index >= 0; index -= 1) {
+		const child = children[index];
+		if (child.kind() === "property_identifier") return child;
+	}
+	return member.field("property");
+}
+function typeStringLiteral(node) {
+	if (!node) return null;
+	const kind = node.kind();
+	if (kind !== "string" && kind !== "template_string") return null;
+	const fragments = node.children().filter((child) => child.kind() === "string_fragment");
+	return fragments.length === 1 && fragments[0].text() === "type" ? node : null;
+}
+function replaceStringLiteralValue(node, value) {
+	const text = node.text();
+	const quote = text.startsWith("'") ? "'" : text.startsWith("`") ? "`" : "\"";
+	return node.replace(`${quote}${value}${quote}`);
+}
+function hasTypeBuilderUse(root, name, afterIndex) {
+	for (const member of root.findAll({ rule: { kind: "member_expression" } })) {
+		if (member.range().start.index <= afterIndex) continue;
+		if (memberProperty(member)?.text() !== "type") continue;
+		const object = unwrapExpression(member.field("object"));
+		if (object?.kind() === "identifier" && object.text() === name) return true;
+	}
+	for (const subscript of root.findAll({ rule: { kind: "subscript_expression" } })) {
+		if (subscript.range().start.index <= afterIndex) continue;
+		if (!typeStringLiteral(subscript.field("index"))) continue;
+		const object = unwrapExpression(subscript.field("object"));
+		if (object?.kind() === "identifier" && object.text() === name) return true;
+	}
+	return false;
+}
+function transform(source, filePath) {
+	if (!source.includes("type") || !source.includes(SDK_MODULE)) return null;
+	let root;
+	try {
+		root = parse(sourceLang(filePath, source), source).root();
+	} catch {
+		return null;
+	}
+	const imports = findImportStatements(root).filter((importStmt) => importSource(importStmt) === SDK_MODULE);
+	if (imports.length === 0) return null;
+	const dbNames = /* @__PURE__ */ new Set();
+	const namespaceNames = /* @__PURE__ */ new Set();
+	for (const importStmt of imports) {
+		for (const binding of importBindings(importStmt)) if (binding.importedName === "db") dbNames.add(binding.localName);
+		for (const name of namespaceImportNames(importStmt)) namespaceNames.add(name);
+	}
+	if (dbNames.size === 0 && namespaceNames.size === 0) return null;
+	const shadowedRanges = buildShadowedRanges(root, /* @__PURE__ */ new Set([...dbNames, ...namespaceNames]));
+	const edits = [];
+	for (const member of root.findAll({ rule: { kind: "member_expression" } })) {
+		const property = memberProperty(member);
+		if (property?.text() !== "type") continue;
+		if (!isSdkDbMember(member.field("object"), dbNames, namespaceNames, shadowedRanges)) continue;
+		edits.push(property.replace("table"));
+	}
+	for (const subscript of root.findAll({ rule: { kind: "subscript_expression" } })) {
+		const index = typeStringLiteral(subscript.field("index"));
+		if (!index) continue;
+		if (!isSdkDbMember(subscript.field("object"), dbNames, namespaceNames, shadowedRanges)) continue;
+		edits.push(replaceStringLiteralValue(index, "table"));
+	}
+	return edits.length > 0 ? root.commitEdits(edits) : null;
+}
+function lineForIndex(source, index) {
+	return source.slice(0, index).split(/\r\n|\r|\n/).length;
+}
+function excerptAtIndex(source, index) {
+	const lineStart = Math.max(source.lastIndexOf("\n", index - 1) + 1, 0);
+	const lineEnd = source.indexOf("\n", index);
+	return source.slice(lineStart, lineEnd === -1 ? source.length : lineEnd).trim();
+}
+function objectPatternHasTypeProperty(pattern) {
+	return pattern.findAll({ rule: { any: [{
+		kind: "property_identifier",
+		regex: "^type$"
+	}, {
+		kind: "shorthand_property_identifier_pattern",
+		regex: "^type$"
+	}] } }).some((node) => node.text() === "type");
+}
+function namespaceDbAliasBindings(pattern) {
+	const aliases = [];
+	for (const child of pattern.children()) {
+		if (child.kind() === "shorthand_property_identifier_pattern" && child.text() === "db") {
+			aliases.push(child);
+			continue;
+		}
+		if (child.kind() !== "pair_pattern") continue;
+		if (child.field("key")?.text() !== "db") continue;
+		const value = child.field("value");
+		if (value?.kind() === "identifier") aliases.push(value);
+	}
+	return aliases;
+}
+function isSdkNamespaceMember(node, namespaceNames, shadowedRanges) {
+	const unwrapped = unwrapExpression(node);
+	return unwrapped?.kind() === "identifier" && namespaceNames.has(unwrapped.text()) && !isShadowed(unwrapped, shadowedRanges);
+}
+function reviewFindings(source, filePath, relativePath) {
+	if (!source.includes("type") || !source.includes(SDK_MODULE)) return [];
+	let root;
+	try {
+		root = parse(sourceLang(filePath, source), source).root();
+	} catch {
+		return [];
+	}
+	const imports = findImportStatements(root).filter((importStmt) => importSource(importStmt) === SDK_MODULE);
+	if (imports.length === 0) return [];
+	const dbNames = /* @__PURE__ */ new Set();
+	const namespaceNames = /* @__PURE__ */ new Set();
+	for (const importStmt of imports) {
+		for (const binding of importBindings(importStmt)) if (binding.importedName === "db") dbNames.add(binding.localName);
+		for (const name of namespaceImportNames(importStmt)) namespaceNames.add(name);
+	}
+	if (dbNames.size === 0 && namespaceNames.size === 0) return [];
+	const shadowedRanges = buildShadowedRanges(root, /* @__PURE__ */ new Set([...dbNames, ...namespaceNames]));
+	const findings = [];
+	for (const decl of root.findAll({ rule: { kind: "variable_declarator" } })) {
+		const binding = firstDeclaratorChild(decl);
+		if (binding?.kind() !== "object_pattern" || !objectPatternHasTypeProperty(binding)) continue;
+		if (!isSdkDbMember(declaratorValue(decl), dbNames, namespaceNames, shadowedRanges)) continue;
+		findings.push({
+			file: relativePath,
+			line: lineForIndex(source, binding.range().start.index),
+			message: "Review destructured db.type builder usage and migrate it to db.table.",
+			excerpt: excerptAtIndex(source, binding.range().start.index)
+		});
+	}
+	for (const decl of root.findAll({ rule: { kind: "variable_declarator" } })) {
+		const binding = firstDeclaratorChild(decl);
+		if (binding?.kind() !== "object_pattern") continue;
+		if (!isSdkNamespaceMember(declaratorValue(decl), namespaceNames, shadowedRanges)) continue;
+		for (const alias of namespaceDbAliasBindings(binding)) {
+			if (!hasTypeBuilderUse(root, alias.text(), decl.range().end.index)) continue;
+			findings.push({
+				file: relativePath,
+				line: lineForIndex(source, binding.range().start.index),
+				message: "Review SDK db alias usage and migrate db.type builder calls to db.table.",
+				excerpt: excerptAtIndex(source, binding.range().start.index)
+			});
+		}
+	}
+	for (const decl of root.findAll({ rule: { kind: "variable_declarator" } })) {
+		const binding = firstDeclaratorChild(decl);
+		if (binding?.kind() !== "identifier") continue;
+		if (!isSdkDbMember(declaratorValue(decl), dbNames, namespaceNames, shadowedRanges)) continue;
+		if (!hasTypeBuilderUse(root, binding.text(), decl.range().end.index)) continue;
+		findings.push({
+			file: relativePath,
+			line: lineForIndex(source, binding.range().start.index),
+			message: "Review SDK db alias usage and migrate db.type builder calls to db.table.",
+			excerpt: excerptAtIndex(source, binding.range().start.index)
+		});
+	}
+	for (const assignment of root.findAll({ rule: { kind: "assignment_expression" } })) {
+		const target = assignmentTarget(assignment);
+		if (target?.kind() !== "identifier") continue;
+		if (!isSdkDbMember(assignmentValue(assignment), dbNames, namespaceNames, shadowedRanges)) continue;
+		if (!hasTypeBuilderUse(root, target.text(), assignment.range().end.index)) continue;
+		findings.push({
+			file: relativePath,
+			line: lineForIndex(source, assignment.range().start.index),
+			message: "Review SDK db alias usage and migrate db.type builder calls to db.table.",
+			excerpt: excerptAtIndex(source, assignment.range().start.index)
+		});
+	}
+	for (const param of root.findAll({ rule: { any: [{ kind: "required_parameter" }, { kind: "optional_parameter" }] } })) {
+		const target = parameterDefaultTarget(param);
+		if (target?.kind() !== "identifier") continue;
+		if (!isSdkDbMember(parameterDefaultValue(param), dbNames, namespaceNames, shadowedRanges)) continue;
+		if (!hasTypeBuilderUse(root, target.text(), param.range().end.index)) continue;
+		findings.push({
+			file: relativePath,
+			line: lineForIndex(source, param.range().start.index),
+			message: "Review SDK db alias usage and migrate db.type builder calls to db.table.",
+			excerpt: excerptAtIndex(source, param.range().start.index)
+		});
+	}
+	return findings;
+}
+//#endregion
+export { transform as default, reviewFindings };

package/dist/codemods/v2/env-var-rename/scripts/transform.js

@@ -0,0 +1,88 @@
+import { Lang, parse } from "@ast-grep/napi";
+import * as path from "pathe";
+//#region codemods/v2/env-var-rename/scripts/transform.ts
+const ENV_RENAMES = [
+	["TAILOR_PLATFORM_SDK_CONFIG_PATH", "TAILOR_CONFIG_PATH"],
+	["TAILOR_PLATFORM_SDK_DTS_PATH", "TAILOR_DTS_PATH"],
+	["TAILOR_PLATFORM_SDK_ALLOW_CI_ID_INJECTION", "TAILOR_CI_ALLOW_ID_INJECTION"],
+	["TAILOR_PLATFORM_SDK_BUILD_ONLY", "TAILOR_DEPLOY_BUILD_ONLY"],
+	["TAILOR_SDK_OUTPUT_DIR", "TAILOR_BUILD_OUTPUT_DIR"],
+	["TAILOR_SDK_SKILLS_SOURCE", "TAILOR_SKILLS_SOURCE"],
+	["TAILOR_SDK_VERSION", "TAILOR_TEMPLATE_SDK_VERSION"],
+	["TAILOR_ENABLE_INLINE_SOURCEMAP", "TAILOR_INLINE_SOURCEMAP"],
+	["TAILOR_PLATFORM_QUERY_NEWLINE_ON_ENTER", "TAILOR_QUERY_NEWLINE_ON_ENTER"],
+	["TAILOR_TOKEN", "TAILOR_PLATFORM_TOKEN"]
+];
+const SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([
+	".ts",
+	".tsx",
+	".mts",
+	".cts",
+	".js",
+	".jsx",
+	".mjs",
+	".cjs"
+]);
+const ENV_BOUNDARY = "[A-Za-z0-9_]";
+const RENAME_PATTERNS = ENV_RENAMES.map(([from, to]) => ({
+	pattern: new RegExp(`(?<!${ENV_BOUNDARY})${from}(?!${ENV_BOUNDARY})`, "g"),
+	to
+}));
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function replaceTextTokens(source) {
+	let updated = source;
+	for (const { pattern, to } of RENAME_PATTERNS) updated = updated.replace(pattern, to);
+	return updated;
+}
+function sourceLang(filePath) {
+	const ext = path.extname(filePath).toLowerCase();
+	return ext === ".tsx" || ext === ".jsx" ? Lang.Tsx : Lang.TypeScript;
+}
+function collectStringFragmentEdits(root, source) {
+	const edits = [];
+	const visit = (node) => {
+		if (node.kind() === "string_fragment") {
+			const range = node.range();
+			const text = source.slice(range.start.index, range.end.index);
+			const replacement = replaceTextTokens(text);
+			if (replacement !== text) edits.push([
+				range.start.index,
+				range.end.index,
+				replacement
+			]);
+			return;
+		}
+		for (const child of node.children()) visit(child);
+	};
+	visit(root);
+	return edits;
+}
+function replaceSourceStringFragments(source, filePath) {
+	let root;
+	try {
+		root = parse(sourceLang(filePath), source).root();
+	} catch {
+		return source;
+	}
+	let updated = source;
+	const edits = collectStringFragmentEdits(root, source).toSorted(([a], [b]) => b - a);
+	for (const [start, end, replacement] of edits) updated = `${updated.slice(0, start)}${replacement}${updated.slice(end)}`;
+	return updated;
+}
+function replaceSourceTokens(source, filePath) {
+	let updated = source;
+	for (const [from, to] of ENV_RENAMES) {
+		const escaped = escapeRegExp(from);
+		updated = updated.replace(new RegExp(`\\bprocess\\.env\\.${escaped}(?![A-Za-z0-9_$])`, "g"), `process.env.${to}`).replace(new RegExp(`\\bprocess\\.env\\[(["'\`])${escaped}\\1\\]`, "g"), `process.env[$1${to}$1]`).replace(new RegExp(`([,{]\\s*)${escaped}(?=\\s*:)`, "g"), `$1${to}`);
+	}
+	return replaceSourceStringFragments(updated, filePath);
+}
+function transform(source, filePath) {
+	const ext = path.extname(filePath).toLowerCase();
+	const updated = SOURCE_EXTENSIONS.has(ext) ? replaceSourceTokens(source, filePath) : replaceTextTokens(source);
+	return updated === source ? null : updated;
+}
+//#endregion
+export { transform as default };

package/dist/codemods/v2/erd-site-to-plugin/scripts/transform.js

@@ -0,0 +1,195 @@
+import { Lang, parse } from "@ast-grep/napi";
+//#region codemods/v2/erd-site-to-plugin/scripts/transform.ts
+const PLUGIN_IMPORT = "import { tailordbErdPlugin } from \"@tailor-platform/sdk-plugin-tailordb-erd\";";
+const DEFINE_PLUGINS_IMPORT = "import { definePlugins } from \"@tailor-platform/sdk\";";
+const SDK_VALUE_IMPORT_REGEX = /(^|\n)import\s*\{[^}\n]*\}\s*from\s*["']@tailor-platform\/sdk["'];?/;
+const FUNCTION_KINDS = /* @__PURE__ */ new Set([
+	"arrow_function",
+	"function_declaration",
+	"function_expression",
+	"generator_function",
+	"generator_function_declaration",
+	"method_definition"
+]);
+function unquote(text) {
+	return text.replace(/^["']|["']$/g, "");
+}
+function propertyName(pair) {
+	const key = pair.field("key");
+	if (!key || key.kind() === "computed_property_name") return null;
+	return unquote(key.text());
+}
+function insideFunction(node) {
+	for (let current = node.parent(); current; current = current.parent()) if (FUNCTION_KINDS.has(current.kind())) return true;
+	return false;
+}
+/**
+* Resolve the local binding name of `definePlugins` imported from
+* `@tailor-platform/sdk`, honoring `import { definePlugins as alias }`.
+* @param tree - Parsed source tree root.
+* @returns Local binding name, or null when it is not imported.
+*/
+function definePluginsLocalName(tree) {
+	const importStatements = tree.findAll({ rule: {
+		kind: "import_statement",
+		has: {
+			kind: "string",
+			regex: "^[\"']@tailor-platform/sdk[\"']$"
+		}
+	} });
+	for (const statement of importStatements) for (const specifier of statement.findAll({ rule: { kind: "import_specifier" } })) {
+		const name = specifier.field("name");
+		if (name?.text() !== "definePlugins") continue;
+		return (specifier.field("alias") ?? name).text();
+	}
+	return null;
+}
+/**
+* Build an edit that removes a property pair from an object literal, cleaning
+* up the separating comma, an inline line comment that documented the removed
+* property, and the removed line's indentation.
+* @param objectNode - Object literal containing the pair.
+* @param pairNode - Property pair to remove.
+* @returns Edit replacing the object literal with the pair removed.
+*/
+function removePairEdit(objectNode, pairNode) {
+	const objText = objectNode.text();
+	const objStart = objectNode.range().start.index;
+	const start = pairNode.range().start.index - objStart;
+	const end = pairNode.range().end.index - objStart;
+	const before = objText.slice(0, start);
+	const after = objText.slice(end);
+	let removeFrom = start;
+	let removeTo = end;
+	const trailing = after.match(/^[ \t]*,[ \t]*(?:\/\/[^\n]*)?\n?/);
+	if (trailing) {
+		removeTo = end + trailing[0].length;
+		const indent = before.match(/\n[ \t]*$/);
+		if (indent) removeFrom = start - (indent[0].length - 1);
+	} else {
+		const leading = before.match(/,\s*$/);
+		if (leading) removeFrom = start - leading[0].length;
+		const inlineComment = after.match(/^[ \t]*\/\/[^\n]*/);
+		if (inlineComment) removeTo = end + inlineComment[0].length;
+	}
+	return objectNode.replace(objText.slice(0, removeFrom) + objText.slice(removeTo));
+}
+/**
+* Build an edit that appends an argument to a call expression, preserving the
+* call's single-line or multi-line formatting. Insertion points are derived
+* from argument-list AST nodes so a trailing line comment after the last
+* argument cannot swallow the separating comma.
+* @param callNode - Call expression to extend.
+* @param arg - Argument expression to append.
+* @returns Edit replacing the call expression with the argument appended.
+*/
+function appendArgEdit(callNode, arg) {
+	const callText = callNode.text();
+	const base = callNode.range().start.index;
+	const children = callNode.field("arguments").children();
+	const args = children.filter((child) => child.isNamed() && child.kind() !== "comment");
+	const closeOffset = children.at(-1).range().start.index - base;
+	const multiline = callText.includes("\n");
+	const closeIndent = callText.slice(0, closeOffset).match(/\n([ \t]*)$/)?.[1] ?? "";
+	const argIndent = `${closeIndent}  `;
+	if (args.length === 0) {
+		const head = callText.slice(0, closeOffset).replace(/[ \t]*$/, "");
+		const rewritten = multiline ? `${head}${argIndent}${arg},\n${closeIndent})` : `${head}${arg})`;
+		return callNode.replace(rewritten);
+	}
+	const lastArg = args.at(-1);
+	const followers = children.slice(children.indexOf(lastArg) + 1);
+	const trailingComma = followers.find((child) => !child.isNamed() && child.text() === ",");
+	const anchor = trailingComma ?? lastArg;
+	if (!multiline) {
+		const insertAt = anchor.range().end.index - base;
+		const insertion = `${trailingComma ? "" : ","} ${arg}`;
+		return callNode.replace(callText.slice(0, insertAt) + insertion + callText.slice(insertAt));
+	}
+	const argInsertAt = (followers.findLast((child) => child.kind() === "comment" && child.range().start.index >= anchor.range().end.index && child.range().start.line === anchor.range().end.line) ?? anchor).range().end.index - base;
+	let rewritten = callText.slice(0, argInsertAt) + `\n${argIndent}${arg},` + callText.slice(argInsertAt);
+	if (!trailingComma) {
+		const commaAt = lastArg.range().end.index - base;
+		rewritten = rewritten.slice(0, commaAt) + "," + rewritten.slice(commaAt);
+	}
+	return callNode.replace(rewritten);
+}
+/**
+* Add `definePlugins` to an existing single-line value import from
+* `@tailor-platform/sdk`, or return null when no such import exists.
+* @param source - Source code to modify.
+* @returns Modified source, or null when a separate import line is needed.
+*/
+function addDefinePluginsSpecifier(source) {
+	const match = source.match(SDK_VALUE_IMPORT_REGEX);
+	if (!match) return null;
+	const updated = match[0].replace(/,?\s*\}/, ", definePlugins }");
+	return source.replace(match[0], updated);
+}
+function insertImports(source, importLines) {
+	const sdkImportRegex = /^import\s+.*from\s+["']@tailor-platform\/sdk[^"']*["'];?$/gm;
+	let lastMatch = null;
+	for (let match = sdkImportRegex.exec(source); match; match = sdkImportRegex.exec(source)) lastMatch = match;
+	const block = importLines.join("\n");
+	if (lastMatch) {
+		const insertPos = lastMatch.index + lastMatch[0].length;
+		return source.slice(0, insertPos) + "\n" + block + source.slice(insertPos);
+	}
+	return block + "\n" + source;
+}
+/**
+* Move `db.<namespace>.erdSite` entries in defineConfig() into a
+* `tailordbErdPlugin({ sites })` argument of definePlugins():
+*
+* 1. Remove each `erdSite` property from `db.<namespace>` objects of
+*    top-level defineConfig() calls (factory-wrapped configs are left for
+*    manual review, since their erdSite values may reference local bindings)
+* 2. Append `tailordbErdPlugin({ sites: { <namespace>: <value> } })` to the
+*    existing definePlugins() call (honoring an import alias), or add a
+*    `plugins` export when none exists
+* 3. Add the plugin import (and a definePlugins import when newly needed)
+* @param source - Source code to transform
+* @returns Transformed source or null if no changes needed
+*/
+function transform(source) {
+	if (!source.includes("erdSite") || !source.includes("@tailor-platform/sdk")) return null;
+	if (source.includes("tailordbErdPlugin")) return null;
+	const tree = parse(Lang.TypeScript, source).root();
+	const edits = [];
+	const siteEntries = [];
+	for (const call of tree.findAll({ rule: { pattern: "defineConfig($CONFIG)" } })) {
+		if (insideFunction(call)) continue;
+		const config = call.getMatch("CONFIG");
+		if (!config || config.kind() !== "object") continue;
+		const dbObject = config.children().find((child) => child.kind() === "pair" && propertyName(child) === "db")?.field("value");
+		if (!dbObject || dbObject.kind() !== "object") continue;
+		for (const nsPair of dbObject.children().filter((child) => child.kind() === "pair")) {
+			const nsKey = nsPair.field("key");
+			const nsObject = nsPair.field("value");
+			if (!nsKey || nsKey.kind() === "computed_property_name") continue;
+			if (!nsObject || nsObject.kind() !== "object") continue;
+			const erdPair = nsObject.children().find((child) => child.kind() === "pair" && propertyName(child) === "erdSite");
+			const valueNode = erdPair?.field("value");
+			if (!erdPair || !valueNode) continue;
+			siteEntries.push(`${nsKey.text()}: ${valueNode.text()}`);
+			edits.push(removePairEdit(nsObject, erdPair));
+		}
+	}
+	if (siteEntries.length === 0) return null;
+	const pluginExpr = `tailordbErdPlugin({ sites: { ${siteEntries.join(", ")} } })`;
+	const localDefinePlugins = definePluginsLocalName(tree);
+	const pluginsCall = tree.find({ rule: { pattern: `${localDefinePlugins ?? "definePlugins"}($$$ARGS)` } });
+	if (pluginsCall) edits.push(appendArgEdit(pluginsCall, pluginExpr));
+	let result = tree.commitEdits(edits);
+	const importLines = [PLUGIN_IMPORT];
+	if (!pluginsCall && !localDefinePlugins) {
+		const merged = addDefinePluginsSpecifier(result);
+		if (merged !== null) result = merged;
+		else importLines.push(DEFINE_PLUGINS_IMPORT);
+	}
+	result = insertImports(result, importLines);
+	if (!pluginsCall) result = result.replace(/\s*$/, "\n\n") + `export const plugins = ${localDefinePlugins ?? "definePlugins"}(\n  ${pluginExpr},\n);\n`;
+	return result;
+}
+//#endregion
+export { transform as default };