@nestia/core 12.0.0-dev.20260520.1 → 12.0.0-dev.20260521.1

package/native/transform/rewrite_unique_base_test.go

@@ -0,0 +1,48 @@
+package transform
+
+import "testing"
+
+func TestNativeRewriteSetFindSourceByUniqueBase(t *testing.T) {
+	set := newNativeRewriteSet()
+	set.Add(nativeRewrite{
+		FilePath: "/repo/tests/test-transform-options/src/validate.ts",
+		Method:   "TypedBody",
+	})
+
+	got, ok := set.findSourceForOutput(
+		"/repo/tests/test-transform-options/lib/validate-assert/validate.js",
+	)
+	if !ok {
+		t.Fatal("expected unique basename fallback to match source")
+	}
+	if got != "/repo/tests/test-transform-options/src/validate.ts" {
+		t.Fatalf("unexpected source match: %q", got)
+	}
+}
+
+// Verifies the unique-basename fallback does not match a sibling output that
+// lives inside the same `src/` tree as the registered source.
+//
+// Regression: the fallback used to match any output sharing a basename with
+// a registered source, so `src/index.ts` silently absorbed rewrites destined
+// for every `src/.../index.ts` neighbor produced by ttsc's virtual fs. The
+// symptom was `could not locate typia.*(...)` on unrelated generated files.
+//
+//  1. Register one rewrite for `/repo/tests/foo/src/index.ts`.
+//  2. Ask findSourceForOutput for a sibling output inside the same src tree.
+//  3. Expect no match.
+func TestNativeRewriteSetFindSourceByUniqueBaseSkipsSourceTreeSiblings(t *testing.T) {
+	set := newNativeRewriteSet()
+	set.Add(nativeRewrite{
+		FilePath: "/repo/tests/foo/src/index.ts",
+		Method:   "schemas",
+	})
+
+	// Output sits inside the same src/ tree, not in lib/dist/bin/build — it
+	// must not absorb the rewrite registered for src/index.ts.
+	if got, ok := set.findSourceForOutput(
+		"/cache/.ttsc/project/1/fs/posix/repo/tests/foo/src/api/functional/health/index.js",
+	); ok {
+		t.Fatalf("expected no match for source-tree sibling, got %q", got)
+	}
+}

package/native/transform/run.go

@@ -0,0 +1,72 @@
+package transform
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"runtime/debug"
+)
+
+var (
+	stdout io.Writer = os.Stdout
+	stderr io.Writer = os.Stderr
+)
+
+// Run wraps run() in a panic recovery envelope so that any unexpected
+// panic surfaces as a one-line transform-diagnostic on stderr instead of
+// a multi-line raw Go stack trace. The diagnostic uses the same `<file> -
+// error TS(code): message` shape as every other nestia / typia diagnostic;
+// ttsc reads it via `error.stderr` (`RuntimeCompiler.compile` at
+// `ConfigAnalyzer.ts:170-174`) rather than its structured-diagnostic regex,
+// which is a pre-existing protocol shared by all `nestia.*` codes. The
+// full stack is preserved behind NESTIA_NATIVE_DEBUG_STACK for triage.
+//
+// This is the `@nestia/core` plugin entry point — it performs the typia
+// and `@nestia/core` decorator transforms only. The `@nestia/sdk` metadata
+// transform lives in its own plugin (`packages/sdk/native`).
+func Run(args []string) (code int) {
+	defer func() {
+		if exp := recover(); exp != nil {
+			diag := Diagnostic{
+				Code:    "nestia.internal.panic",
+				Message: fmt.Sprintf("ttsc-nestia panicked: %v", exp),
+			}
+			WriteTypiaTransformDiagnostics(stderr, []Diagnostic{diag}, "")
+			if os.Getenv("NESTIA_NATIVE_DEBUG_STACK") != "" {
+				fmt.Fprintln(stderr, string(debug.Stack()))
+			}
+			code = 3
+		}
+	}()
+	return run(args)
+}
+
+func run(args []string) int {
+	if len(args) == 0 {
+		return runHelp(nil)
+	}
+	command := args[0]
+	rest := args[1:]
+	switch command {
+	case "build":
+		return runBuild(rest)
+	case "check":
+		return runCheck(rest)
+	case "transform":
+		return runTransform(rest)
+	case "version":
+		fmt.Fprintln(stdout, "ttsc-nestia 0.1.0")
+		return 0
+	case "help", "-h", "--help":
+		return runHelp(rest)
+	default:
+		fmt.Fprintf(stderr, "ttsc-nestia: unknown command %q\n", command)
+		return 2
+	}
+}
+
+func runHelp(args []string) int {
+	_ = args
+	fmt.Fprintln(stdout, "usage: ttsc-nestia <build|check|transform|version>")
+	return 0
+}

package/native/{cmd/ttsc-nestia → transform}/transform.go

@@ -1,4 +1,4 @@
-package main
+package transform
 
 import (
 	"bytes"
@@ -94,27 +94,21 @@ func runTransform(args []string) int {
 		readTypiaPluginOptions(cwd, *tsconfigPath),
 	)
 	if len(diagnostics) > 0 {
-		writeTypiaTransformDiagnostics(stderr, diagnostics, cwd)
+		WriteTypiaTransformDiagnostics(stderr, diagnostics, cwd)
 		return 3
 	}
 	coreRewriteMap, coreDiagnostics := collectNestiaCoreSourceRewriteMap(prog, plan, absFile)
 	if len(coreDiagnostics) > 0 {
-		writeTypiaTransformDiagnostics(stderr, coreDiagnostics, cwd)
+		WriteTypiaTransformDiagnostics(stderr, coreDiagnostics, cwd)
 		return 3
 	}
 	rewrites = append(rewrites, coreRewriteMap[filepath.ToSlash(absFile)]...)
-	sdkRewriteMap, sdkDiagnostics := collectNestiaSDKSourceRewriteMap(prog, plan, absFile)
-	if len(sdkDiagnostics) > 0 {
-		writeTypiaTransformDiagnostics(stderr, sdkDiagnostics, cwd)
-		return 3
-	}
-	rewrites = append(rewrites, sdkRewriteMap[filepath.ToSlash(absFile)]...)
-	source, ok := sourceFileText(target)
+	source, ok := SourceFileText(target)
 	if !ok {
 		fmt.Fprintf(stderr, "ttsc-nestia transform: source text is unavailable for %s\n", absFile)
 		return 3
 	}
-	source, err = applySourceRewrites(source, rewrites)
+	source, err = ApplySourceRewrites(source, rewrites)
 	if err != nil {
 		fmt.Fprintf(stderr, "ttsc-nestia transform: source rewrite: %v\n", err)
 		return 3
@@ -150,11 +144,6 @@ func runTransformProject(prog *driver.Program, cwd string, tsconfigPath string,
 		rewrites[file] = append(rewrites[file], entries...)
 	}
 	diags = append(diags, coreDiags...)
-	sdkRewriteMap, sdkDiags := collectNestiaSDKSourceRewriteMap(prog, plan, "")
-	for file, entries := range sdkRewriteMap {
-		rewrites[file] = append(rewrites[file], entries...)
-	}
-	diags = append(diags, sdkDiags...)
 	output := transformProjectOutput{
 		Diagnostics: make([]transformCompilerDiagnostic, 0, len(diags)),
 		TypeScript:  map[string]string{},
@@ -164,7 +153,7 @@ func runTransformProject(prog *driver.Program, cwd string, tsconfigPath string,
 	}
 	for _, file := range prog.SourceFiles() {
 		filename := filepath.ToSlash(file.FileName())
-		source, ok := sourceFileText(file)
+		source, ok := SourceFileText(file)
 		if !ok {
 			output.Diagnostics = append(
 				output.Diagnostics,
@@ -172,7 +161,7 @@ func runTransformProject(prog *driver.Program, cwd string, tsconfigPath string,
 			)
 			continue
 		}
-		transformed, err := applySourceRewrites(source, rewrites[filename])
+		transformed, err := ApplySourceRewrites(source, rewrites[filename])
 		if err != nil {
 			output.Diagnostics = append(
 				output.Diagnostics,
@@ -192,7 +181,7 @@ func runTransformProject(prog *driver.Program, cwd string, tsconfigPath string,
 	return 0
 }
 
-type transformSourceRewrite struct {
+type SourceRewrite struct {
 	start       int
 	end         int
 	replacement string
@@ -203,30 +192,30 @@ func collectTypiaSourceRewrites(
 	cwd string,
 	onlyFile string,
 	pluginOptions typiaadapter.PluginOptions,
-) ([]transformSourceRewrite, []typiaTransformDiagnostic) {
+) ([]SourceRewrite, []Diagnostic) {
 	sites := collectNestiaTypiaCallSites(prog.SourceFiles(), prog.Checker)
-	rewrites := []transformSourceRewrite{}
-	diagnostics := []typiaTransformDiagnostic{}
+	rewrites := []SourceRewrite{}
+	diagnostics := []Diagnostic{}
 	for _, site := range sites {
 		if filepath.ToSlash(site.FilePath) != filepath.ToSlash(onlyFile) {
 			continue
 		}
 		if reason := typiaadapter.UnsupportedReason(site); reason != "" {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, reason))
+			diagnostics = append(diagnostics, NewDiagnostic(site, reason))
 			continue
 		}
 		expr, handled, err := typiaadapter.EmitCallWithOptionsPreservingTypes(prog, site, pluginOptions)
 		if !handled {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, "method not covered"))
+			diagnostics = append(diagnostics, NewDiagnostic(site, "method not covered"))
 			continue
 		}
 		if err != nil {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, err.Error()))
+			diagnostics = append(diagnostics, NewDiagnostic(site, err.Error()))
 			continue
 		}
 		expr = parenthesizeTypiaReplacement(site, expr)
 		node := site.Call.AsNode()
-		rewrites = append(rewrites, transformSourceRewrite{
+		rewrites = append(rewrites, SourceRewrite{
 			start:       node.Pos(),
 			end:         node.End(),
 			replacement: expr,
@@ -239,28 +228,28 @@ func collectTypiaSourceRewrites(
 func collectTypiaSourceRewriteMap(
 	prog *driver.Program,
 	pluginOptions typiaadapter.PluginOptions,
-) (map[string][]transformSourceRewrite, []typiaTransformDiagnostic) {
+) (map[string][]SourceRewrite, []Diagnostic) {
 	sites := collectNestiaTypiaCallSites(prog.SourceFiles(), prog.Checker)
-	rewrites := map[string][]transformSourceRewrite{}
-	diagnostics := []typiaTransformDiagnostic{}
+	rewrites := map[string][]SourceRewrite{}
+	diagnostics := []Diagnostic{}
 	for _, site := range sites {
 		file := filepath.ToSlash(site.FilePath)
 		if reason := typiaadapter.UnsupportedReason(site); reason != "" {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, reason))
+			diagnostics = append(diagnostics, NewDiagnostic(site, reason))
 			continue
 		}
 		expr, handled, err := typiaadapter.EmitCallWithOptionsPreservingTypes(prog, site, pluginOptions)
 		if !handled {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, "method not covered"))
+			diagnostics = append(diagnostics, NewDiagnostic(site, "method not covered"))
 			continue
 		}
 		if err != nil {
-			diagnostics = append(diagnostics, newTypiaTransformDiagnostic(site, err.Error()))
+			diagnostics = append(diagnostics, NewDiagnostic(site, err.Error()))
 			continue
 		}
 		expr = parenthesizeTypiaReplacement(site, expr)
 		node := site.Call.AsNode()
-		rewrites[file] = append(rewrites[file], transformSourceRewrite{
+		rewrites[file] = append(rewrites[file], SourceRewrite{
 			start:       node.Pos(),
 			end:         node.End(),
 			replacement: expr,
@@ -269,7 +258,7 @@ func collectTypiaSourceRewriteMap(
 	return rewrites, diagnostics
 }
 
-func applySourceRewrites(source string, rewrites []transformSourceRewrite) (string, error) {
+func ApplySourceRewrites(source string, rewrites []SourceRewrite) (string, error) {
 	sort.SliceStable(rewrites, func(i, j int) bool {
 		return rewrites[i].start > rewrites[j].start
 	})
@@ -289,7 +278,7 @@ func applySourceRewrites(source string, rewrites []transformSourceRewrite) (stri
 	return output, nil
 }
 
-func sourceFileText(target any) (string, bool) {
+func SourceFileText(target any) (string, bool) {
 	type sourceText interface {
 		Text() string
 	}
@@ -369,7 +358,7 @@ func newTransformCompilerDiagnostic(
 }
 
 func transformDiagnosticToCompilerDiagnostic(
-	diag typiaTransformDiagnostic,
+	diag Diagnostic,
 ) transformCompilerDiagnostic {
 	var ptr *string
 	if diag.File != "" {

package/native/{cmd/ttsc-nestia → transform}/typia_fast.go

@@ -1,4 +1,4 @@
-package main
+package transform
 
 import (
 	"path/filepath"

package/native/{cmd/ttsc-nestia → transform}/typia_replacement.go

@@ -1,4 +1,4 @@
-package main
+package transform
 
 import (
 	"strings"

package/native/transform.cjs

@@ -1,20 +1,42 @@
+const fs = require("node:fs");
 const path = require("node:path");
 
+// `@nestia/core` ttsc plugin descriptor.
+//
+// `source` is the Go command package of the executable transform host
+// (`cmd/ttsc-nestia`, package `main`).
+//
+// `@nestia/sdk` is NOT a standalone ttsc plugin: its Go transform is declared
+// here as a `contributor`, discovered by resolving `@nestia/sdk` from the
+// project. ttsc statically links a contributor's Go source into this host
+// binary. Consequences:
+//
+//   - A project that depends on `@nestia/core` but not `@nestia/sdk` never
+//     links, compiles, or ships any SDK transform code.
+//   - When the `@nestia/core` plugin itself is disabled, this descriptor is
+//     never evaluated, so the SDK contributor is never linked either.
 function createTtscPlugin(context) {
-  const transform = context?.plugin?.transform;
-  const name =
-    typeof transform === "string" && transform.includes("@nestia/sdk")
-      ? "@nestia/sdk"
-      : "@nestia/core";
-  const peer =
-    name === "@nestia/sdk"
-      ? ["@nestia/core/lib/transform"]
-      : ["@nestia/sdk/lib/transform"];
-  return {
-    name,
+  const plugin = {
+    name: "@nestia/core",
     source: path.resolve(__dirname, "cmd", "ttsc-nestia"),
-    composes: ["typia/lib/transform", ...peer],
+    composes: ["typia/lib/transform"],
   };
+  const sdk = resolveSdkContributorSource(context);
+  if (sdk !== null) plugin.contributors = [{ name: "sdk", source: sdk }];
+  return plugin;
+}
+
+function resolveSdkContributorSource(context) {
+  const paths = [__dirname];
+  if (context && typeof context.projectRoot === "string")
+    paths.push(context.projectRoot);
+  try {
+    const manifest = require.resolve("@nestia/sdk/package.json", { paths });
+    const source = path.resolve(path.dirname(manifest), "native", "sdk");
+    return fs.existsSync(source) ? source : null;
+  } catch {
+    return null;
+  }
 }
 
 module.exports = createTtscPlugin;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestia/core",
-  "version": "12.0.0-dev.20260520.1",
+  "version": "12.0.0-dev.20260521.1",
   "description": "Super-fast validation decorators of NestJS",
   "types": "lib/index.d.ts",
   "main": "lib/index.js",
@@ -46,8 +46,8 @@
   },
   "homepage": "https://nestia.io",
   "dependencies": {
-    "@typia/interface": "13.0.0-dev.20260520.2",
-    "@typia/utils": "13.0.0-dev.20260520.2",
+    "@typia/interface": "13.0.0-dev.20260521.1",
+    "@typia/utils": "13.0.0-dev.20260521.1",
     "get-function-location": "^2.0.0",
     "glob": "^11.0.3",
     "path-parser": "^6.1.0",
@@ -55,17 +55,17 @@
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
     "tgrid": "^1.1.0",
-    "typia": "13.0.0-dev.20260520.2",
+    "typia": "13.0.0-dev.20260521.1",
     "ws": "^7.5.3",
-    "@nestia/fetcher": "^12.0.0-dev.20260520.1"
+    "@nestia/fetcher": "^12.0.0-dev.20260521.1"
   },
   "peerDependencies": {
     "@nestjs/common": ">=7.0.1",
     "@nestjs/core": ">=7.0.1",
     "reflect-metadata": ">=0.1.12",
     "rxjs": ">=6.0.3",
-    "typia": "13.0.0-dev.20260520.2",
-    "@nestia/fetcher": "^12.0.0-dev.20260520.1"
+    "typia": "13.0.0-dev.20260521.1",
+    "@nestia/fetcher": "^12.0.0-dev.20260521.1"
   },
   "devDependencies": {
     "@nestjs/common": "^11.1.6",
@@ -90,6 +90,7 @@
     "native/go.mod",
     "native/go.sum",
     "native/plugin",
+    "native/transform",
     "native/transform.cjs",
     "src"
   ],

package/src/transform.ts

@@ -1,3 +1,4 @@
+import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -6,53 +7,71 @@ interface ITtscPluginFactoryContext {
   projectRoot: string;
 }
 
-/**
- * @internal
- *
- * The `composes` array order is load-bearing: `typia/lib/transform` first
- * (host), then peers consumed by the Go binary's `plugin.ParsePlan`.
- */
+/** @internal */
 interface ITtscPlugin {
   name: string;
   source: string;
   composes: string[];
+  contributors?: { name: string; source: string }[];
 }
 
 const filename: string = currentFilename();
 const dirname: string = path.dirname(filename);
 
+/**
+ * `@nestia/core` ttsc plugin descriptor.
+ *
+ * `@nestia/sdk` is not a standalone plugin: its Go transform is declared here
+ * as a `contributor` that ttsc statically links into this host binary, and
+ * only when `@nestia/sdk` is actually resolvable from the project. A project
+ * depending on `@nestia/core` alone never compiles any SDK transform code.
+ */
 export function createTtscPlugin(
   context: ITtscPluginFactoryContext,
 ): ITtscPlugin {
-  const root: string =
-    resolvePackageRoot("@nestia/core/package.json", context.projectRoot) ??
-    inferPackageRoot();
-  return {
+  const plugin: ITtscPlugin = {
     name: "@nestia/core",
-    source: path.resolve(root, "native", "cmd", "ttsc-nestia"),
-    composes: [
-      "typia/lib/transform",
-      "@nestia/sdk/lib/transform",
-    ],
+    source: path.resolve(root(context), "native", "cmd", "ttsc-nestia"),
+    composes: ["typia/lib/transform"],
   };
+  const sdk: string | null = resolveSdkContributorSource(context);
+  if (sdk !== null) plugin.contributors = [{ name: "sdk", source: sdk }];
+  return plugin;
 }
 export default createTtscPlugin;
 
+function root(context: ITtscPluginFactoryContext): string {
+  return (
+    resolvePackageRoot("@nestia/core/package.json", context.projectRoot) ??
+    path.resolve(dirname, "..")
+  );
+}
+
+function resolveSdkContributorSource(
+  context: ITtscPluginFactoryContext,
+): string | null {
+  const manifest: string | null = resolvePackageRoot(
+    "@nestia/sdk/package.json",
+    context.projectRoot,
+  );
+  if (manifest === null) return null;
+  const source: string = path.resolve(manifest, "native", "sdk");
+  return fs.existsSync(source) ? source : null;
+}
+
 function resolvePackageRoot(
   packageJson: string,
   projectRoot: string,
 ): string | null {
   try {
-    return path.dirname(require.resolve(packageJson, { paths: [projectRoot] }));
+    return path.dirname(
+      require.resolve(packageJson, { paths: [dirname, projectRoot] }),
+    );
   } catch {
     return null;
   }
 }
 
-function inferPackageRoot(): string {
-  return path.resolve(dirname, "..");
-}
-
 function currentFilename(): string {
   if (
     typeof __filename === "string" &&