@tailor-platform/sdk-codemod 0.3.0-next.3 → 0.3.0-next.5

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @tailor-platform/sdk-codemod
 
+## 0.3.0-next.5
+
+### Patch Changes
+
+- [#1719](https://github.com/tailor-platform/sdk/pull/1719) [`4a05aec`](https://github.com/tailor-platform/sdk/commit/4a05aecfb100a1ea7292a6ae5809a2d1e6eddbfe) Thanks [@dqn](https://github.com/dqn)! - Derive default TailorDB forward relation names from the relation field name by removing a trailing `ID`, `Id`, or `id`, instead of deriving them from the target table name.
+  
+  The v2 migration review identifies non-self relations without `toward.as`. Add an explicit name to preserve the v1 GraphQL field name, or update consumers to use the new field-based name.
+
+- [#1678](https://github.com/tailor-platform/sdk/pull/1678) [`e0e768d`](https://github.com/tailor-platform/sdk/commit/e0e768d77470d13806ed7b2ee2117fe374d51d40) Thanks [@toiroakr](https://github.com/toiroakr)! - Redesign TailorDB hooks and validators with several breaking changes:
+  
+  - Add shared `now` timestamp to all hooks — multiple fields stamped with the same `Date`
+  - Field-level hooks: `{ value, data, invoker }` → create `{ input, invoker, now }` / update `{ input, oldValue, invoker, now }` (`data` removed, `oldValue` added for update only)
+  - Type-level hooks: per-field mapping (`Hooks<F>`) → single `{ create, update }` object (`TypeHook<F>`) returning partial field overrides
+  - Type-level create hooks no longer receive `oldRecord`; update hooks receive non-nullable `oldRecord`
+  - Field-level validators: return type changed from `boolean` to `string | void` (return error message or void to pass); `[fn, message]` tuple form removed
+  - Type-level validators: `Validators<F>` per-field record → `TypeValidateFn<F>` single function with `issues(field, message)` callback
+  - Add `.default(value)` on fields to set a create-time default (makes required fields optional in create input)
+  - Remove exported types: `Hooks<F>`, `Validators<F>`, `ValidateConfig`
+
+## 0.3.0-next.4
+
+### Patch Changes
+
+- [#1693](https://github.com/tailor-platform/sdk/pull/1693) [`4751214`](https://github.com/tailor-platform/sdk/commit/4751214c0923e094a844f9ce322279a47e871075) Thanks [@dqn](https://github.com/dqn)! - Rename the TailorDB schema builder from `db.type()` to `db.table()`.
+  
+  Update TailorDB definitions:
+  
+  ```diff
+   import { db } from "@tailor-platform/sdk";
+  
+  -export const user = db.type("User", {
+  +export const user = db.table("User", {
+     name: db.string(),
+   });
+  ```
+
+- [#1704](https://github.com/tailor-platform/sdk/pull/1704) [`9c81d9c`](https://github.com/tailor-platform/sdk/commit/9c81d9c18b1d29b3e9307ea17fe54c8ce55f4dda) Thanks [@dqn](https://github.com/dqn)! - Remove flat value and default exports from `@tailor-platform/sdk/runtime/*` subpath modules. Import each subpath through its self-named namespace export instead, for example `import { iconv } from "@tailor-platform/sdk/runtime/iconv"`.
+  
+  The aggregate `@tailor-platform/sdk/runtime` entry remains named-only, and its deprecated `file.deleteFile` alias is removed in favor of `file.delete`. The v2 codemod rewrites straightforward namespace-star subpath imports, flat named value imports, and aggregate `file.deleteFile` calls to the new namespace-object style.
+  
+  `TailorContextAPI` and `TailorWorkflowAPI` now describe the SDK wrapper objects. Code that types the platform-provided `globalThis.tailor.context` or `globalThis.tailor.workflow` objects directly must use `PlatformContextAPI` or `PlatformWorkflowAPI` instead.
+
 ## 0.3.0-next.3
 
 ### Patch Changes
@@ -152,6 +194,18 @@
 
 - [#1435](https://github.com/tailor-platform/sdk/pull/1435) [`49c0cc9`](https://github.com/tailor-platform/sdk/commit/49c0cc99171d7e317a50a18804a21067d89f9493) Thanks [@dqn](https://github.com/dqn)! - Add the `v2/plugin-cli-import` codemod so `tailor-sdk upgrade` rewrites deprecated plugin imports from `@tailor-platform/sdk/cli` (`kyselyTypePlugin`, `enumConstantsPlugin`, `fileUtilsPlugin`, `seedPlugin`) to their dedicated `@tailor-platform/sdk/plugin/*` subpaths, splitting any non-plugin specifiers onto a separate import.
 
+## 0.3.7
+
+### Patch Changes
+
+- [#1744](https://github.com/tailor-platform/sdk/pull/1744) [`3ca5b48`](https://github.com/tailor-platform/sdk/commit/3ca5b48fca4e8e1f0878350afc11d42d36bf3cab) Thanks [@renovate](https://github.com/apps/renovate)! - fix(deps): update dependency politty to v0.11.2
+
+## 0.3.6
+
+### Patch Changes
+
+- [#1688](https://github.com/tailor-platform/sdk/pull/1688) [`7f67996`](https://github.com/tailor-platform/sdk/commit/7f679963adc1df438e49200f1170415629817f44) Thanks [@renovate](https://github.com/apps/renovate)! - fix(deps): update dependency @ast-grep/napi to v0.44.1
+
 ## 0.3.5
 
 ### Patch Changes

package/dist/codemods/{ast-grep-helpers-Bfn39biW.js → ast-grep-helpers-CXtWn3RB.js}

@@ -168,4 +168,4 @@ function localDeclarationNames(root) {
 	return names;
 }
 //#endregion
-export { importSpecNames as a, importSource as i, findImportStatements as n, isTypeOnlyImport as o, importBindings as r, localDeclarationNames as s, buildAddNamedImportEdit as t };
+export { importSource as a, localDeclarationNames as c, importBindings as i, stringValue as l, collectBindingNames as n, importSpecNames as o, findImportStatements as r, isTypeOnlyImport as s, buildAddNamedImportEdit as t };

package/dist/codemods/v2/auth-connection-token-helper/scripts/transform.js

@@ -1,4 +1,4 @@
-import { a as importSpecNames, i as importSource, n as findImportStatements, o as isTypeOnlyImport, r as importBindings, s as localDeclarationNames, t as buildAddNamedImportEdit } from "../../../ast-grep-helpers-Bfn39biW.js";
+import { a as importSource, c as localDeclarationNames, i as importBindings, o as importSpecNames, r as findImportStatements, s as isTypeOnlyImport, t as buildAddNamedImportEdit } from "../../../ast-grep-helpers-CXtWn3RB.js";
 import { Lang, parse } from "@ast-grep/napi";
 //#region codemods/v2/auth-connection-token-helper/scripts/transform.ts
 const RUNTIME_MODULE = "@tailor-platform/sdk/runtime";

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/forward-relation-name/scripts/transform.js

@@ -0,0 +1,115 @@
+import { l as stringValue } from "../../../ast-grep-helpers-CXtWn3RB.js";
+import { Lang, parse } from "@ast-grep/napi";
+//#region codemods/v2/forward-relation-name/scripts/transform.ts
+function sourceLang(filePath, source) {
+	const lowerPath = filePath.toLowerCase();
+	if (/\.(?:ts|mts|cts)$/u.test(lowerPath)) return Lang.TypeScript;
+	if (/\.(?:tsx|jsx|js)$/u.test(lowerPath)) return Lang.Tsx;
+	return source.includes("</") ? Lang.Tsx : Lang.TypeScript;
+}
+function isRelationCall(call, aliases) {
+	const callee = call.children()[0];
+	if (!callee) return false;
+	if (callee.kind() === "identifier") return aliases.has(callee.text());
+	if (callee.kind() === "subscript_expression") {
+		const property = literalStringValue(callee.field("index"));
+		return property === null || property === "relation";
+	}
+	if (callee.kind() !== "member_expression") return false;
+	return callee.children().findLast((child) => child.kind() === "property_identifier" || child.kind() === "identifier")?.text() === "relation";
+}
+function relationBindingName(pattern) {
+	if (pattern.kind() !== "object_pattern") return null;
+	for (const child of pattern.children()) {
+		if (child.kind() === "shorthand_property_identifier_pattern" && child.text() === "relation") return child.text();
+		if (child.kind() === "pair_pattern" && stringValue(child.field("key")) === "relation") {
+			const value = child.field("value");
+			return value?.kind() === "identifier" ? value.text() : null;
+		}
+		if (child.kind() === "object_assignment_pattern") {
+			const binding = child.children().find((node) => node.kind() === "shorthand_property_identifier_pattern");
+			if (binding?.text() === "relation") return binding.text();
+		}
+	}
+	return null;
+}
+function relationAliases(root) {
+	const aliases = /* @__PURE__ */ new Set();
+	for (const pattern of root.findAll({ rule: { kind: "object_pattern" } })) {
+		const name = relationBindingName(pattern);
+		if (name) aliases.add(name);
+	}
+	return aliases;
+}
+function callArgument(call) {
+	const args = call.children().find((child) => child.kind() === "arguments");
+	if (!args) return null;
+	const values = args.children().filter((child) => {
+		const kind = child.kind();
+		return kind !== "(" && kind !== ")" && kind !== "," && kind !== "comment";
+	});
+	return values.length === 1 ? values[0] : null;
+}
+function pairKey(pair) {
+	const key = pair.children()[0];
+	return stringValue(key ?? null);
+}
+function pairValue(pair) {
+	const children = pair.children();
+	const colonIndex = children.findIndex((child) => child.kind() === ":");
+	if (colonIndex === -1) return null;
+	return children.slice(colonIndex + 1).find((child) => child.kind() !== "comment") ?? null;
+}
+function objectPair(object, key) {
+	return object.children().find((child) => child.kind() === "pair" && pairKey(child) === key) ?? null;
+}
+function literalStringValue(node) {
+	if (node?.kind() !== "string") return null;
+	return stringValue(node);
+}
+function hasDynamicProperties(object) {
+	return object.children().some((child) => {
+		const kind = child.kind();
+		if (kind === "{" || kind === "}" || kind === "," || kind === "comment") return false;
+		if (kind !== "pair") return true;
+		const keyKind = child.children()[0]?.kind();
+		return keyKind !== "property_identifier" && keyKind !== "string";
+	});
+}
+function needsReview(call) {
+	const config = callArgument(call);
+	if (config?.kind() !== "object") return config != null;
+	if (hasDynamicProperties(config)) return true;
+	const relationType = objectPair(config, "type");
+	const toward = objectPair(config, "toward");
+	if (!relationType || !toward) return false;
+	if (literalStringValue(pairValue(relationType)) === "keyOnly") return false;
+	const towardConfig = pairValue(toward);
+	if (towardConfig?.kind() !== "object") return towardConfig != null;
+	if (hasDynamicProperties(towardConfig)) return true;
+	const targetType = objectPair(towardConfig, "type");
+	if (targetType && literalStringValue(pairValue(targetType)) === "self") return false;
+	const as = objectPair(towardConfig, "as");
+	if (as) {
+		const explicitName = literalStringValue(pairValue(as));
+		return explicitName === null || explicitName.length === 0;
+	}
+	if (!targetType) return false;
+	return true;
+}
+function transform(_source, _filePath) {
+	return null;
+}
+function reviewFindings(source, filePath, relativePath) {
+	if (!source.includes("relation")) return [];
+	const root = parse(sourceLang(filePath, source), source).root();
+	const aliases = relationAliases(root);
+	return root.findAll({ rule: { kind: "call_expression" } }).filter((call) => isRelationCall(call, aliases) && needsReview(call)).map((call) => ({
+		file: relativePath,
+		line: call.range().start.line + 1,
+		message: "Review the v2 forward GraphQL field name or add an explicit toward.as.",
+		excerpt: call.text().split("\n", 1)[0].trim()
+	}));
+}
+//#endregion
+export { transform as default, reviewFindings };

package/dist/codemods/v2/runtime-globals-opt-in/scripts/transform.js

@@ -1,4 +1,4 @@
-import { n as findImportStatements, r as importBindings, s as localDeclarationNames, t as buildAddNamedImportEdit } from "../../../ast-grep-helpers-Bfn39biW.js";
+import { c as localDeclarationNames, i as importBindings, r as findImportStatements, t as buildAddNamedImportEdit } from "../../../ast-grep-helpers-CXtWn3RB.js";
 import { Lang, parse } from "@ast-grep/napi";
 //#region codemods/v2/runtime-globals-opt-in/scripts/transform.ts
 const RUNTIME_MODULE = "@tailor-platform/sdk/runtime";