@nestia/sdk 11.2.1 → 12.0.0-dev.20260521.1

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
+)

package/native/sdk/sdk_metadata_json.go

@@ -0,0 +1,327 @@
+package sdk
+
+import schemametadata "github.com/samchon/typia/packages/typia/native/core/schemas/metadata"
+
+func nestiaSDKMetadataComponentsLiteral(
+	components schemametadata.IMetadataComponents,
+) map[string]any {
+	return map[string]any{
+		"objects": nestiaSDKMetadataObjectTypes(components.Objects),
+		"aliases": nestiaSDKMetadataAliasTypes(components.Aliases),
+		"arrays":  nestiaSDKMetadataArrayTypes(components.Arrays),
+		"tuples":  nestiaSDKMetadataTupleTypes(components.Tuples),
+	}
+}
+
+func nestiaSDKMetadataSchemaLiteral(meta *schemametadata.IMetadataSchema) any {
+	if meta == nil {
+		return nestiaSDKLiteralNull
+	}
+	return map[string]any{
+		"any":       meta.Any,
+		"required":  meta.Required,
+		"optional":  meta.Optional,
+		"nullable":  meta.Nullable,
+		"functions": nestiaSDKMetadataFunctions(meta.Functions),
+		"atomics":   nestiaSDKMetadataAtomics(meta.Atomics),
+		"constants": nestiaSDKMetadataConstants(meta.Constants),
+		"templates": nestiaSDKMetadataTemplates(meta.Templates),
+		"escaped":   nestiaSDKMetadataEscaped(meta.Escaped),
+		"rest":      nestiaSDKMetadataSchemaLiteral(meta.Rest),
+		"arrays":    nestiaSDKMetadataReferences(meta.Arrays),
+		"tuples":    nestiaSDKMetadataReferences(meta.Tuples),
+		"objects":   nestiaSDKMetadataReferences(meta.Objects),
+		"aliases":   nestiaSDKMetadataReferences(meta.Aliases),
+		"natives":   nestiaSDKMetadataReferences(meta.Natives),
+		"sets":      nestiaSDKMetadataSets(meta.Sets),
+		"maps":      nestiaSDKMetadataMaps(meta.Maps),
+	}
+}
+
+func nestiaSDKMetadataFunctions(
+	input []*schemametadata.IMetadataSchema_IFunction,
+) []any {
+	output := []any{}
+	for _, fn := range input {
+		if fn == nil {
+			continue
+		}
+		output = append(output, map[string]any{
+			"parameters": nestiaSDKMetadataParameters(fn.Parameters),
+			"output":     nestiaSDKMetadataSchemaLiteral(fn.Output),
+			"async":      fn.Async,
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataParameters(
+	input []*schemametadata.IMetadataSchema_IParameter,
+) []any {
+	output := []any{}
+	for _, param := range input {
+		if param == nil {
+			continue
+		}
+		output = append(output, map[string]any{
+			"name":        param.Name,
+			"type":        nestiaSDKMetadataSchemaLiteral(param.Type),
+			"description": nestiaSDKOptionalString(param.Description),
+			"jsDocTags":   nestiaSDKJSDocTags(param.JsDocTags),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataAtomics(
+	input []schemametadata.IMetadataSchema_IAtomic,
+) []any {
+	output := []any{}
+	for _, atomic := range input {
+		output = append(output, map[string]any{
+			"type": atomic.Type,
+			"tags": nestiaSDKMetadataTagMatrix(atomic.Tags),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataConstants(
+	input []schemametadata.IMetadataSchema_IConstant,
+) []any {
+	output := []any{}
+	for _, constant := range input {
+		values := []any{}
+		for _, value := range constant.Values {
+			values = append(values, map[string]any{
+				"value":       value.Value,
+				"tags":        nestiaSDKMetadataTagMatrix(value.Tags),
+				"description": nestiaSDKOptionalString(value.Description),
+				"jsDocTags":   nestiaSDKJSDocTags(value.JsDocTags),
+			})
+		}
+		output = append(output, map[string]any{
+			"type":   constant.Type,
+			"values": values,
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataTemplates(
+	input []schemametadata.IMetadataSchema_ITemplate,
+) []any {
+	output := []any{}
+	for _, template := range input {
+		row := []any{}
+		for _, child := range template.Row {
+			row = append(row, nestiaSDKMetadataSchemaLiteral(child))
+		}
+		output = append(output, map[string]any{
+			"row":  row,
+			"tags": nestiaSDKMetadataTagMatrix(template.Tags),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataEscaped(
+	input *schemametadata.IMetadataSchema_IEscaped,
+) any {
+	if input == nil {
+		return nestiaSDKLiteralNull
+	}
+	return map[string]any{
+		"original": nestiaSDKMetadataSchemaLiteral(input.Original),
+		"returns":  nestiaSDKMetadataSchemaLiteral(input.Returns),
+	}
+}
+
+func nestiaSDKMetadataReferences(
+	input []schemametadata.IMetadataSchema_IReference,
+) []any {
+	output := []any{}
+	for _, ref := range input {
+		output = append(output, map[string]any{
+			"name": ref.Name,
+			"tags": nestiaSDKMetadataTagMatrix(ref.Tags),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataSets(input []schemametadata.IMetadataSchema_ISet) []any {
+	output := []any{}
+	for _, set := range input {
+		output = append(output, map[string]any{
+			"value": nestiaSDKMetadataSchemaLiteral(set.Value),
+			"tags":  nestiaSDKMetadataTagMatrix(set.Tags),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataMaps(input []schemametadata.IMetadataSchema_IMap) []any {
+	output := []any{}
+	for _, entry := range input {
+		output = append(output, map[string]any{
+			"key":   nestiaSDKMetadataSchemaLiteral(entry.Key),
+			"value": nestiaSDKMetadataSchemaLiteral(entry.Value),
+			"tags":  nestiaSDKMetadataTagMatrix(entry.Tags),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataObjectTypes(
+	input []schemametadata.IMetadataSchema_IObjectType,
+) []any {
+	output := []any{}
+	for _, object := range input {
+		properties := []any{}
+		for _, property := range object.Properties {
+			if property == nil {
+				continue
+			}
+			properties = append(properties, map[string]any{
+				"key":         nestiaSDKMetadataSchemaLiteral(property.Key),
+				"value":       nestiaSDKMetadataSchemaLiteral(property.Value),
+				"description": nestiaSDKOptionalString(property.Description),
+				"jsDocTags":   nestiaSDKJSDocTags(property.JsDocTags),
+				"mutability":  nestiaSDKOptionalString(property.Mutability),
+			})
+		}
+		output = append(output, map[string]any{
+			"name":        object.Name,
+			"properties":  properties,
+			"description": nestiaSDKOptionalString(object.Description),
+			"jsDocTags":   nestiaSDKJSDocTags(object.JsDocTags),
+			"index":       object.Index,
+			"recursive":   object.Recursive,
+			"nullables":   nestiaSDKBoolArray(object.Nullables),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataAliasTypes(
+	input []schemametadata.IMetadataSchema_IAliasType,
+) []any {
+	output := []any{}
+	for _, alias := range input {
+		output = append(output, map[string]any{
+			"name":        alias.Name,
+			"value":       nestiaSDKMetadataSchemaLiteral(alias.Value),
+			"description": nestiaSDKOptionalString(alias.Description),
+			"jsDocTags":   nestiaSDKJSDocTags(alias.JsDocTags),
+			"recursive":   alias.Recursive,
+			"nullables":   nestiaSDKBoolArray(alias.Nullables),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataArrayTypes(
+	input []schemametadata.IMetadataSchema_IArrayType,
+) []any {
+	output := []any{}
+	for _, array := range input {
+		output = append(output, map[string]any{
+			"name":      array.Name,
+			"value":     nestiaSDKMetadataSchemaLiteral(array.Value),
+			"nullables": nestiaSDKBoolArray(array.Nullables),
+			"recursive": array.Recursive,
+			"index":     nestiaSDKOptionalInt(array.Index),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataTupleTypes(
+	input []schemametadata.IMetadataSchema_ITupleType,
+) []any {
+	output := []any{}
+	for _, tuple := range input {
+		elements := []any{}
+		for _, elem := range tuple.Elements {
+			elements = append(elements, nestiaSDKMetadataSchemaLiteral(elem))
+		}
+		output = append(output, map[string]any{
+			"name":      tuple.Name,
+			"elements":  elements,
+			"index":     nestiaSDKOptionalInt(tuple.Index),
+			"recursive": tuple.Recursive,
+			"nullables": nestiaSDKBoolArray(tuple.Nullables),
+		})
+	}
+	return output
+}
+
+func nestiaSDKMetadataTagMatrix(
+	input [][]schemametadata.IMetadataTypeTag,
+) []any {
+	output := []any{}
+	for _, row := range input {
+		items := []any{}
+		for _, tag := range row {
+			items = append(items, nestiaSDKMetadataTypeTag(tag))
+		}
+		output = append(output, items)
+	}
+	return output
+}
+
+func nestiaSDKMetadataTypeTag(tag schemametadata.IMetadataTypeTag) map[string]any {
+	output := map[string]any{
+		"target":    tag.Target,
+		"name":      tag.Name,
+		"kind":      tag.Kind,
+		"exclusive": tag.Exclusive,
+		"value":     tag.Value,
+		"schema":    tag.Schema,
+	}
+	if tag.Validate != "" {
+		output["validate"] = tag.Validate
+	}
+	return output
+}
+
+func nestiaSDKJSDocTags(input []schemametadata.IJsDocTagInfo) []any {
+	output := []any{}
+	for _, tag := range input {
+		text := []any{}
+		for _, item := range tag.Text {
+			text = append(text, map[string]any{
+				"text": item.Text,
+				"kind": item.Kind,
+			})
+		}
+		output = append(output, map[string]any{
+			"name": tag.Name,
+			"text": text,
+		})
+	}
+	return output
+}
+
+func nestiaSDKBoolArray(input []bool) []any {
+	output := []any{}
+	for _, value := range input {
+		output = append(output, value)
+	}
+	return output
+}
+
+func nestiaSDKOptionalString(input *string) any {
+	if input == nil {
+		return nestiaSDKLiteralNull
+	}
+	return *input
+}
+
+func nestiaSDKOptionalInt(input *int) any {
+	if input == nil {
+		return nestiaSDKLiteralNull
+	}
+	return *input
+}