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

package/assets/bundle/distribute/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ORGANIZATION/PROJECT-api",
-  "version": "12.0.0-dev.20260520.1",
+  "version": "12.0.0-dev.20260521.1",
   "description": "SDK library generated by Nestia",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",

package/lib/decorators/OperationMetadata.d.ts

@@ -1,2 +1,12 @@
 import { IOperationMetadata } from "../structures/IOperationMetadata";
-export declare function OperationMetadata(metadata: IOperationMetadata): MethodDecorator;
+/**
+ * Carries the compile-time operation metadata the SDK / Swagger / e2e
+ * generators read through `Reflect.getMetadata("nestia/OperationMetadata")`.
+ *
+ * The `@nestia/sdk` native transform injects this decorator as a synthesized
+ * AST node, so its argument is a single JSON string literal rather than an
+ * object literal — keeping the constructed node tree minimal. The string is
+ * parsed once here at module-evaluation time. A pre-parsed `IOperationMetadata`
+ * object is still accepted for hand-written or test usage.
+ */
+export declare function OperationMetadata(metadata: IOperationMetadata | string): MethodDecorator;

package/lib/decorators/OperationMetadata.js

@@ -1,9 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OperationMetadata = OperationMetadata;
+/**
+ * Carries the compile-time operation metadata the SDK / Swagger / e2e
+ * generators read through `Reflect.getMetadata("nestia/OperationMetadata")`.
+ *
+ * The `@nestia/sdk` native transform injects this decorator as a synthesized
+ * AST node, so its argument is a single JSON string literal rather than an
+ * object literal — keeping the constructed node tree minimal. The string is
+ * parsed once here at module-evaluation time. A pre-parsed `IOperationMetadata`
+ * object is still accepted for hand-written or test usage.
+ */
 function OperationMetadata(metadata) {
+    const parsed = typeof metadata === "string"
+        ? JSON.parse(metadata)
+        : metadata;
     return function OperationMetadata(target, propertyKey, descriptor) {
-        Reflect.defineMetadata("nestia/OperationMetadata", metadata, target, propertyKey);
+        Reflect.defineMetadata("nestia/OperationMetadata", parsed, target, propertyKey);
         return descriptor;
     };
 }

package/lib/decorators/OperationMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"OperationMetadata.js","sourceRoot":"","sources":["../../src/decorators/OperationMetadata.ts"],"names":[],"mappings":";;;AAEA,2BACE,QAA4B;IAE5B,OAAO,SAAS,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU;QAC/D,OAAO,CAAC,cAAc,CACpB,0BAA0B,EAC1B,QAAQ,EACR,MAAM,EACN,WAAW,CACZ,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"OperationMetadata.js","sourceRoot":"","sources":["../../src/decorators/OperationMetadata.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;GASG;AACH,2BACE,QAAqC;IAErC,MAAM,MAAM,GACV,OAAO,QAAQ,KAAK,QAAQ;QAC1B,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAwB;QAC9C,CAAC,CAAC,QAAQ,CAAC;IACf,OAAO,SAAS,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU;QAC/D,OAAO,CAAC,cAAc,CACpB,0BAA0B,EAC1B,MAAM,EACN,MAAM,EACN,WAAW,CACZ,CAAC;QACF,OAAO,UAAU,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC"}

package/lib/transform.d.ts

@@ -1,9 +1,16 @@
-interface ITtscPluginFactoryContext {
-    projectRoot: string;
-}
 interface ITtscPlugin {
     name: string;
     source: string;
 }
-export declare function createTtscPlugin(context: ITtscPluginFactoryContext): ITtscPlugin;
+/**
+ * `@nestia/sdk` ttsc plugin descriptor.
+ *
+ * Points ttsc at this package's own Go source (`native/sdk`, package `sdk`).
+ * Because that package is not `package main`, ttsc classifies it as a linked
+ * transform and statically links it into the `@nestia/core` host binary as a
+ * contributor — but only for projects that actually depend on `@nestia/sdk`.
+ * A project depending on `@nestia/core` alone never links, compiles, or ships
+ * any of this SDK transform code.
+ */
+export declare function createTtscPlugin(): ITtscPlugin;
 export default createTtscPlugin;

package/lib/transform.js

@@ -8,26 +8,26 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_url_1 = require("node:url");
 const filename = currentFilename();
 const dirname = node_path_1.default.dirname(filename);
-function createTtscPlugin(context) {
-    var _a;
-    const root = (_a = resolvePackageRoot("@nestia/core/package.json", context.projectRoot)) !== null && _a !== void 0 ? _a : inferCorePackageRoot();
+/**
+ * `@nestia/sdk` ttsc plugin descriptor.
+ *
+ * Points ttsc at this package's own Go source (`native/sdk`, package `sdk`).
+ * Because that package is not `package main`, ttsc classifies it as a linked
+ * transform and statically links it into the `@nestia/core` host binary as a
+ * contributor — but only for projects that actually depend on `@nestia/sdk`.
+ * A project depending on `@nestia/core` alone never links, compiles, or ships
+ * any of this SDK transform code.
+ */
+function createTtscPlugin() {
+    // `<root>/lib/transform.js` (published) or `<root>/src/transform.ts` (dev)
+    // → `<root>` → the `native/sdk` linked-transform source package.
+    const root = node_path_1.default.resolve(dirname, "..");
     return {
         name: "@nestia/sdk",
-        source: node_path_1.default.resolve(root, "native", "cmd", "ttsc-nestia"),
+        source: node_path_1.default.resolve(root, "native", "sdk"),
     };
 }
 exports.default = createTtscPlugin;
-function resolvePackageRoot(packageJson, projectRoot) {
-    try {
-        return node_path_1.default.dirname(require.resolve(packageJson, { paths: [projectRoot] }));
-    }
-    catch (_a) {
-        return null;
-    }
-}
-function inferCorePackageRoot() {
-    return node_path_1.default.resolve(dirname, "..", "..", "core");
-}
 function currentFilename() {
     var _a;
     var _b, _c;

package/lib/transform.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,uCAAyC;AAWzC,MAAM,QAAQ,GAAW,eAAe,EAAE,CAAC;AAC3C,MAAM,OAAO,GAAW,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE/C,0BACE,OAAkC;;IAElC,MAAM,IAAI,SACR,kBAAkB,CAAC,2BAA2B,EAAE,OAAO,CAAC,WAAW,CAAC,mCACpE,oBAAoB,EAAE,CAAC;IACzB,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC;KAC3D,CAAC;AACJ,CAAC;kBACc,gBAAgB;AAE/B,SAAS,kBAAkB,CACzB,WAAmB,EACnB,WAAmB;IAEnB,IAAI,CAAC;QACH,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;eAAO,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO,mBAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,eAAe;;;IACtB,IACE,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,KAAK,SAAS;QACxB,UAAU,CAAC,MAAM,KAAK,CAAC;QAEvB,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAuB,MAAA,IAAI,KAAK,EAAE,CAAC,KAAK,0CAC9C,KAAK,CAAC,IAAI,EACX,IAAI,CACH,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CACvC,CAAC;IACJ,MAAM,OAAO,GAAwC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAC9D,4CAA4C,CAC7C,CAAC;IACF,MAAM,QAAQ,GAAW,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO,iBAAiB,aAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":";;;;;;AAAA,0DAA6B;AAC7B,uCAAyC;AAOzC,MAAM,QAAQ,GAAW,eAAe,EAAE,CAAC;AAC3C,MAAM,OAAO,GAAW,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE/C;;;;;;;;;GASG;AACH;IACE,2EAA2E;IAC3E,iEAAiE;IACjE,MAAM,IAAI,GAAW,mBAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC;kBACc,gBAAgB;AAE/B,SAAS,eAAe;;;IACtB,IACE,OAAO,UAAU,KAAK,QAAQ;QAC9B,UAAU,KAAK,SAAS;QACxB,UAAU,CAAC,MAAM,KAAK,CAAC;QAEvB,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEvC,MAAM,IAAI,GAAuB,MAAA,IAAI,KAAK,EAAE,CAAC,KAAK,0CAC9C,KAAK,CAAC,IAAI,EACX,IAAI,CACH,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QACnC,KAAK,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CACvC,CAAC;IACJ,MAAM,OAAO,GAAwC,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,KAAK,CAC9D,4CAA4C,CAC7C,CAAC;IACF,MAAM,QAAQ,GAAW,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO,iBAAiB,aAAC,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,CAAC,CAAC,mCAAI,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/native/go.mod

@@ -0,0 +1,52 @@
+module github.com/samchon/nestia/packages/sdk/native
+
+go 1.26
+
+require (
+	github.com/microsoft/typescript-go/shim/ast v0.0.0
+	github.com/microsoft/typescript-go/shim/checker v0.0.0
+	github.com/microsoft/typescript-go/shim/scanner v0.0.0
+	github.com/samchon/nestia/packages/core/native v0.0.0
+	github.com/samchon/ttsc/packages/ttsc v0.0.0
+	github.com/samchon/typia/packages/typia/native v0.0.0-20260510181336-5a7ad21c4d6f
+)
+
+require (
+	github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 // indirect
+	github.com/klauspost/cpuid/v2 v2.2.10 // indirect
+	github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 // indirect
+	github.com/microsoft/typescript-go/shim/bundled v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/compiler v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/core v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/diagnosticwriter v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/parser v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/printer v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/tsoptions v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/tspath v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/vfs v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/vfs/cachedvfs v0.0.0 // indirect
+	github.com/microsoft/typescript-go/shim/vfs/osvfs v0.0.0 // indirect
+	github.com/zeebo/xxh3 v1.1.0 // indirect
+	golang.org/x/sync v0.20.0 // indirect
+	golang.org/x/sys v0.43.0 // indirect
+	golang.org/x/text v0.36.0 // indirect
+)
+
+replace (
+	github.com/microsoft/typescript-go/shim/ast => github.com/samchon/ttsc/packages/ttsc/shim/ast v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/bundled => github.com/samchon/ttsc/packages/ttsc/shim/bundled v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/checker => github.com/samchon/ttsc/packages/ttsc/shim/checker v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/compiler => github.com/samchon/ttsc/packages/ttsc/shim/compiler v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/core => github.com/samchon/ttsc/packages/ttsc/shim/core v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/diagnosticwriter => github.com/samchon/ttsc/packages/ttsc/shim/diagnosticwriter v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/parser => github.com/samchon/ttsc/packages/ttsc/shim/parser v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/printer => github.com/samchon/ttsc/packages/ttsc/shim/printer v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/scanner => github.com/samchon/ttsc/packages/ttsc/shim/scanner v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/tsoptions => github.com/samchon/ttsc/packages/ttsc/shim/tsoptions v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/tspath => github.com/samchon/ttsc/packages/ttsc/shim/tspath v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/vfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/vfs/cachedvfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260519112110-ec1cdf69c509
+	github.com/microsoft/typescript-go/shim/vfs/osvfs => github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260519112110-ec1cdf69c509
+	github.com/samchon/nestia/packages/core/native => ../../core/native
+	github.com/samchon/ttsc/packages/ttsc v0.0.0 => github.com/samchon/ttsc/packages/ttsc v0.0.0-20260519112110-ec1cdf69c509
+)

package/native/go.sum

@@ -0,0 +1,54 @@
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433 h1:vymEbVwYFP/L05h5TKQxvkXoKxNvTpjxYKdF1Nlwuao=
+github.com/go-json-experiment/json v0.0.0-20260214004413-d219187c3433/go.mod h1:tphK2c80bpPhMOI4v6bIc2xWywPfbqi1Z06+RcrMkDg=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
+github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157 h1:llOMPhKDiQ+UEJiAaQuuWaJOTg5V7tNNTEf9JPWoYSY=
+github.com/microsoft/typescript-go v0.0.0-20260429010842-56ab4af42157/go.mod h1:m8YA0PMC7ti0GW0RI05D6fEcjQeu98XVS+FWF+VDW2k=
+github.com/peter-evans/patience v0.3.0 h1:rX0JdJeepqdQl1Sk9c9uvorjYYzL2TfgLX1adqYm9cA=
+github.com/peter-evans/patience v0.3.0/go.mod h1:Kmxu5sY1NmBLFSStvXjX1wS9mIv7wMcP/ubucyMOAu0=
+github.com/samchon/ttsc/packages/ttsc v0.0.0-20260519112110-ec1cdf69c509 h1:9XOcQrnIVJ9ZSS2COtZhVgRyMgNojuWV1x/775QXdYk=
+github.com/samchon/ttsc/packages/ttsc v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:V3pedIezHwCYObKxD174holEgc0yyMcGx+4eCI+dgRw=
+github.com/samchon/ttsc/packages/ttsc/shim/ast v0.0.0-20260519112110-ec1cdf69c509 h1:dPku/IntYFpiKuKpsM78WwwxyIdl1QeCRm5hYah7998=
+github.com/samchon/ttsc/packages/ttsc/shim/ast v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:BCVAEArtMC+X1laJmDwxlsRROIQIYvHeT7Dl0gNjT0A=
+github.com/samchon/ttsc/packages/ttsc/shim/bundled v0.0.0-20260519112110-ec1cdf69c509 h1:xo5hPei0KG1R0duQhs3R8ty3NeB/+uNKo8PfcRej/bI=
+github.com/samchon/ttsc/packages/ttsc/shim/bundled v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:0tz+Y8szXmEpXWHWVrLrv11ga1z6tQJQErkUyIWJ9RQ=
+github.com/samchon/ttsc/packages/ttsc/shim/checker v0.0.0-20260519112110-ec1cdf69c509 h1:NsY7Sx27yCLEiHAMQW/FZ9K08AeyfqCFfARbv3YW58Y=
+github.com/samchon/ttsc/packages/ttsc/shim/checker v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:4xfafgG/qosSp8f0tCf83assFoUKRdGHhvPD1EI9LKg=
+github.com/samchon/ttsc/packages/ttsc/shim/compiler v0.0.0-20260519112110-ec1cdf69c509 h1:P0842cLEeKSbUEcr02bojbFeejJNymsoybBvSQImpGc=
+github.com/samchon/ttsc/packages/ttsc/shim/compiler v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:e9awlg1eXjc1Hzx9waw6UEV/2qYJbgo8zFPwQ0mpzig=
+github.com/samchon/ttsc/packages/ttsc/shim/core v0.0.0-20260519112110-ec1cdf69c509 h1:CVP3DmC77r5Dei7YziDmwlb7h+h4Z7tUAi3sdHY3PQ0=
+github.com/samchon/ttsc/packages/ttsc/shim/core v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:DUewcVNEdXyDveQholE4GAsiqqA3C2+SJYqia3nCf00=
+github.com/samchon/ttsc/packages/ttsc/shim/diagnosticwriter v0.0.0-20260519112110-ec1cdf69c509 h1:pSweRJg4DabeOefKJks+adGJ6lvDfCS0GtaKEzUdOl8=
+github.com/samchon/ttsc/packages/ttsc/shim/diagnosticwriter v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:v86GtrD7qALo6Xkgz1MDomPMSV2D9NdniQWB5t8eY6k=
+github.com/samchon/ttsc/packages/ttsc/shim/parser v0.0.0-20260519112110-ec1cdf69c509 h1:+rhP0a1sNPduYsK1EbL88XFvfAEH3xwNPz04Bz50QGk=
+github.com/samchon/ttsc/packages/ttsc/shim/parser v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:inUjC/bNlCkO0zIzHZRXlHR/WgLcK0vi2KLc7tpQ1ek=
+github.com/samchon/ttsc/packages/ttsc/shim/printer v0.0.0-20260519112110-ec1cdf69c509 h1:jIEZj4iuDiSFGYQIcBfPTOEOKsw1OiFt1Mii4sDpwu0=
+github.com/samchon/ttsc/packages/ttsc/shim/printer v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:ESjhY+UiPRspef4JcXcUPNgt4ySQQrlVIUCLKaKeyEQ=
+github.com/samchon/ttsc/packages/ttsc/shim/scanner v0.0.0-20260519112110-ec1cdf69c509 h1:ojNRfmIQ6iRGixkd0UN5b9X4BIji7B2tvaC+U9DzezE=
+github.com/samchon/ttsc/packages/ttsc/shim/scanner v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:abIC7C28cUA5IQKmLJulsl2qOvmimhkMNOfjJhRm5jM=
+github.com/samchon/ttsc/packages/ttsc/shim/tsoptions v0.0.0-20260519112110-ec1cdf69c509 h1:A82Zh/CGlOrit4/tmWqiibutfI/ymj2q2U29rShOkLU=
+github.com/samchon/ttsc/packages/ttsc/shim/tsoptions v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:EQwrCr3nY0U1SZBNyp6cQSogAiXsjFxTuT8NlMit1lc=
+github.com/samchon/ttsc/packages/ttsc/shim/tspath v0.0.0-20260519112110-ec1cdf69c509 h1:0GpravTbiWFkotq0V5mCYf719slkFEiqdOJ//00NuGI=
+github.com/samchon/ttsc/packages/ttsc/shim/tspath v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:hsE2c1bZquSNlDLIkT3SfLH3MrDmMk1BLzWI/KomT1A=
+github.com/samchon/ttsc/packages/ttsc/shim/vfs v0.0.0-20260519112110-ec1cdf69c509 h1:H7ZPgQ8g8uAQrrzKnnYrpxNgUFV245r5ZiLcT5BCxRc=
+github.com/samchon/ttsc/packages/ttsc/shim/vfs v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:HoQcoC0FEG3iMI6zvjg8r6j/ves+RVH6SRn48VSi5H0=
+github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260519112110-ec1cdf69c509 h1:LpTjuXHHUWskujIXRrbYsuxVWTXHxGG732EheCOVBZ0=
+github.com/samchon/ttsc/packages/ttsc/shim/vfs/cachedvfs v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:XS3LhXkn5xadyRe3tW+9+suW/7gh7dPdL43Q+s/lUDo=
+github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260519112110-ec1cdf69c509 h1:ESHedCnmU7U9bhHD3o5DxWgE5QCOye4FW/TDw6MhXw8=
+github.com/samchon/ttsc/packages/ttsc/shim/vfs/osvfs v0.0.0-20260519112110-ec1cdf69c509/go.mod h1:otX+qw8aZLNCoBmCwMAn53Nw0RQTPzSoId3DxmE67So=
+github.com/samchon/typia/packages/typia/native v0.0.0-20260510181336-5a7ad21c4d6f h1:0y1cQPDK53apdqBmhaoYY1ceQ6JDAgmKwTdb/V9Rf9E=
+github.com/samchon/typia/packages/typia/native v0.0.0-20260510181336-5a7ad21c4d6f/go.mod h1:SJDrfiCEK5dtObhJeAl0iqelqmmFm/JIjfJ6z0kID60=
+github.com/zeebo/assert v1.3.0 h1:g7C04CbJuIDKNPFHmsk4hwZDO5O+kntRxzaUoNXj+IQ=
+github.com/zeebo/assert v1.3.0/go.mod h1:Pq9JiuJQpG8JLJdtkwrJESF0Foym2/D9XMU5ciN/wJ0=
+github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
+github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+golang.org/x/sync v0.20.0 h1:e0PTpb7pjO8GAtTs2dQ6jYa5BWYlMuX047Dco/pItO4=
+golang.org/x/sync v0.20.0/go.mod h1:9xrNwdLfx4jkKbNva9FpL6vEN7evnE43NNNJQ2LF3+0=
+golang.org/x/sys v0.43.0 h1:Rlag2XtaFTxp19wS8MXlJwTvoh8ArU6ezoyFsMyCTNI=
+golang.org/x/sys v0.43.0/go.mod h1:4GL1E5IUh+htKOUEOaiffhrAeqysfVGipDYzABqnCmw=
+golang.org/x/text v0.36.0 h1:JfKh3XmcRPqZPKevfXVpI1wXPTqbkE5f7JA92a55Yxg=
+golang.org/x/text v0.36.0/go.mod h1:NIdBknypM8iqVmPiuco0Dh6P5Jcdk8lJL0CUebqK164=
+gotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=
+gotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=

package/native/sdk/register.go

@@ -0,0 +1,130 @@
+package sdk
+
+import (
+	"fmt"
+	"strings"
+
+	shimast "github.com/microsoft/typescript-go/shim/ast"
+	"github.com/samchon/ttsc/packages/ttsc/driver"
+)
+
+// sdkMetadataNamespace is the import alias the injected decorator references.
+const sdkMetadataNamespace = "__OperationMetadata"
+
+// init registers the SDK metadata transform with the ttsc driver.
+//
+// ttsc classifies this package (name != "main") as a linked transform and
+// statically links it into the `@nestia/core` host binary — but only for
+// projects that depend on `@nestia/sdk`. A project depending on `@nestia/core`
+// alone never links, compiles, or ships any of this code. When linked, this
+// `init()` runs before the host's `main`; the driver then invokes
+// `ApplyProgram` once per build, after the host's own typia + core passes.
+func init() {
+	driver.RegisterPlugin(linkedPlugin{})
+}
+
+type linkedPlugin struct{}
+
+// ApplyProgram injects the `@OperationMetadata("<json>")` decorator that the
+// SDK / Swagger / e2e generators read at runtime, plus the namespace import it
+// references.
+//
+// Insertion is done with synthesized AST nodes (NodeFlagsSynthesized): ttsc's
+// emit prints those structurally, without slicing the original source text, so
+// no source-text rewrite is needed. The metadata is carried as a single JSON
+// string literal — the `OperationMetadata` decorator `JSON.parse`s it — which
+// keeps the constructed AST to one literal node instead of a deep object tree.
+func (linkedPlugin) ApplyProgram(prog *driver.Program, _ driver.PluginContext) error {
+	sites, diags := collectNestiaSDKSites(prog)
+	if len(diags) > 0 {
+		messages := make([]string, 0, len(diags))
+		for _, diag := range diags {
+			messages = append(messages, diag.String(""))
+		}
+		return fmt.Errorf("%s", strings.Join(messages, "\n"))
+	}
+	if len(sites) == 0 {
+		return nil
+	}
+	factory := shimast.NewNodeFactory(shimast.NodeFactoryHooks{})
+	touched := map[*shimast.SourceFile]bool{}
+	for _, site := range sites {
+		if site.Method == nil || site.File == nil {
+			continue
+		}
+		injectOperationMetadataDecorator(factory, site.Method, site.Metadata)
+		touched[site.File] = true
+	}
+	for file := range touched {
+		injectOperationMetadataImport(factory, file)
+	}
+	return nil
+}
+
+func synthesized(node *shimast.Node) *shimast.Node {
+	if node != nil {
+		node.Flags |= shimast.NodeFlagsSynthesized
+	}
+	return node
+}
+
+// injectOperationMetadataDecorator prepends a synthesized
+// `@__OperationMetadata.OperationMetadata("<json>")` decorator to a controller
+// method. Every site is a method that already carries `@nestia/core`
+// decorators, so its modifier list is non-nil and can be mutated in place.
+func injectOperationMetadataDecorator(
+	factory *shimast.NodeFactory,
+	method *shimast.Node,
+	metadataJSON string,
+) {
+	modifiers := method.Modifiers()
+	if modifiers == nil {
+		return
+	}
+	namespaceID := synthesized(factory.NewIdentifier(sdkMetadataNamespace))
+	memberID := synthesized(factory.NewIdentifier("OperationMetadata"))
+	access := synthesized(factory.NewPropertyAccessExpression(
+		namespaceID,
+		nil,
+		memberID,
+		shimast.NodeFlagsNone,
+	))
+	namespaceID.Parent = access
+	memberID.Parent = access
+	argument := synthesized(factory.NewStringLiteral(metadataJSON, shimast.TokenFlagsNone))
+	call := synthesized(factory.NewCallExpression(
+		access,
+		nil,
+		nil,
+		factory.NewNodeList([]*shimast.Node{argument}),
+		shimast.NodeFlagsNone,
+	))
+	access.Parent = call
+	argument.Parent = call
+	decorator := synthesized(factory.NewDecorator(call))
+	call.Parent = decorator
+	decorator.Parent = method
+	modifiers.Nodes = append([]*shimast.Node{decorator}, modifiers.Nodes...)
+}
+
+// injectOperationMetadataImport prepends a synthesized
+// `import * as __OperationMetadata from "@nestia/sdk"` to a touched file.
+func injectOperationMetadataImport(
+	factory *shimast.NodeFactory,
+	file *shimast.SourceFile,
+) {
+	if file == nil || file.Statements == nil {
+		return
+	}
+	namespaceID := synthesized(factory.NewIdentifier(sdkMetadataNamespace))
+	namespace := synthesized(factory.NewNamespaceImport(namespaceID))
+	namespaceID.Parent = namespace
+	clause := synthesized(factory.NewImportClause(shimast.KindUnknown, nil, namespace))
+	namespace.Parent = clause
+	specifier := synthesized(factory.NewStringLiteral("@nestia/sdk", shimast.TokenFlagsNone))
+	declaration := synthesized(factory.NewImportDeclaration(nil, clause, specifier, nil))
+	clause.Parent = declaration
+	specifier.Parent = declaration
+	declaration.Parent = file.AsNode()
+	file.Statements.Nodes = append([]*shimast.Node{declaration}, file.Statements.Nodes...)
+}

package/native/sdk/sdk.go

@@ -0,0 +1,17 @@
+// Package sdk implements the `@nestia/sdk` ttsc transform plugin: it injects
+// the `@OperationMetadata({...})` decorator the SDK / Swagger / e2e generators
+// read at runtime. It is a separate plugin from `@nestia/core` so that a
+// project depending only on `@nestia/core` never compiles this code — see
+// `packages/core/native/transform` for the shared transform infrastructure
+// this package imports.
+package sdk
+
+import (
+	"io"
+	"os"
+)
+
+var (
+	stdout io.Writer = os.Stdout
+	stderr io.Writer = os.Stderr
+)