@nestia/sdk 14.0.0 → 14.0.2

package/lib/generates/internal/SdkAliasCollection.d.ts

@@ -6,18 +6,138 @@ import { ITypedHttpRoute } from "../../structures/ITypedHttpRoute";
 import { ITypedHttpRouteParameter } from "../../structures/ITypedHttpRouteParameter";
 import { ITypedWebSocketRoute } from "../../structures/ITypedWebSocketRoute";
 import { ImportDictionary } from "./ImportDictionary";
+import type { SdkWebSocketParameterProgrammer } from "./SdkWebSocketParameterProgrammer";
+/**
+ * Type nodes of the SDK: the named types of routes, and the request and
+ * response aliases.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace builds each type as the syntax tree that the printer writes, from the reflected names or from the metadata when `clone` is on.
+ * @evidence contracts/common.md#clear-and-simple-design Several small builders.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The builders depend on the project configuration for the choice of source.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 export declare namespace SdkAliasCollection {
+    /**
+     * Returns the type reference of a reflected type, with its type arguments.
+     *
+     * @evidence contracts/common.md#principled-implementation The arguments are built recursively.
+     * @evidence contracts/common.md#clear-and-simple-design One recursion.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It writes the name as reflected.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.name composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const name: ({ type }: {
         type: IReflectType;
     }) => TypeNode;
+    /**
+     * Returns the type of one chunk of a binary response:
+     * `Uint8Array<ArrayBufferLike>`.
+     *
+     * @evidence contracts/common.md#principled-implementation The chunk type of the platform stream is a byte array.
+     * @evidence contracts/common.md#clear-and-simple-design One node.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The type is fixed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.binaryChunk composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const binaryChunk: () => TypeNode;
+    /**
+     * Returns the type of a binary response: `ReadableStream` of its chunks.
+     *
+     * @evidence contracts/common.md#principled-implementation A binary response is streamed, not read into memory.
+     * @evidence contracts/common.md#clear-and-simple-design One node.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The chunk type is shared.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.binaryResponse composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const binaryResponse: () => TypeNode;
+    /**
+     * Returns the type node of a metadata.
+     *
+     * @evidence contracts/common.md#principled-implementation The metadata is written by the type programmer, so the result is the DTO the clone declares.
+     * @evidence contracts/common.md#clear-and-simple-design One delegation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It shares the type writer.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.from composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const from: (project: INestiaProject) => (importer: ImportDictionary) => (metadata: MetadataSchema) => TypeNode;
+    /**
+     * Returns the object type of a route's keyword parameters, each with the
+     * description of its parameter or its `@param` tag.
+     *
+     * @evidence contracts/common.md#principled-implementation The entries are the route's path, query, and body parameters, optional where the metadata is, without prefix.
+     * @evidence contracts/common.md#clear-and-simple-design One map over the entries.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts A parameter with a description carries it as a comment.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.httpProps composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const httpProps: (project: INestiaProject) => (importer: ImportDictionary) => (route: ITypedHttpRoute) => TypeNode;
-    const websocketProps: (route: ITypedWebSocketRoute) => TypeNode;
+    /**
+     * Returns the object type of a WebSocket route's keyword parameters: its path
+     * parameters, its query, and its provider.
+     *
+     * @evidence contracts/common.md#principled-implementation The keys are the names decided by the parameter programmer, so the type and the function agree.
+     * @evidence contracts/common.md#clear-and-simple-design One literal.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names are shared.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.websocketProps composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    const websocketProps: (route: ITypedWebSocketRoute, names: SdkWebSocketParameterProgrammer.INames) => TypeNode;
+    /**
+     * Returns the type of a route's headers: its reflected name, or the
+     * metadata's type under `clone`.
+     *
+     * @evidence contracts/common.md#principled-implementation The source follows the `clone` setting.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The choice is made on one flag.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.headers composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const headers: (project: INestiaProject) => (importer: ImportDictionary) => (param: ITypedHttpRouteParameter.IHeaders) => TypeNode;
+    /**
+     * Returns the type of a route's query: its metadata under `clone`, otherwise
+     * its reflected type wrapped in Resolved unless primitive conversion is off.
+     *
+     * @evidence contracts/common.md#principled-implementation Clone mode uses the resolved metadata graph; source mode uses the declared type with the configured Resolved conversion.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The choice is made on one flag.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.query composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const query: (project: INestiaProject) => (importer: ImportDictionary) => (param: ITypedHttpRouteParameter.IQuery) => TypeNode;
+    /**
+     * Returns the type of a route's body: a form data input for a multipart body,
+     * and otherwise the reflected name or the metadata's type under `clone`.
+     *
+     * @evidence contracts/common.md#principled-implementation The multipart body is an input of files and fields, not the declared class.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The cases are the content types.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.body composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const body: (project: INestiaProject) => (importer: ImportDictionary) => (param: ITypedHttpRouteParameter.IBody) => TypeNode;
+    /**
+     * Returns the type of a route's output: the success and every exception as a
+     * union of `IPropagation` members, or the success body alone when propagation
+     * is off.
+     *
+     * @evidence contracts/common.md#principled-implementation Status keys retain their declared numeric or range spelling for IPropagation to expand. Source success types follow their content type, while declared exceptions use JSON Primitive conversion independently of the success media type; primitive:false preserves declared source types.
+     * @evidence contracts/common.md#clear-and-simple-design One function of two branches.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The exceptions are the declared ones.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.response composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const response: (project: INestiaProject) => (importer: ImportDictionary) => (route: ITypedHttpRoute) => TypeNode;
+    /**
+     * Returns the type of the success body: a stream for a binary response, the
+     * reflected type for a plain one, and its primitive form for a JSON
+     * response.
+     *
+     * @evidence contracts/common.md#principled-implementation The route's metadata decides between the branches.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The branches are the response kinds.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.responseBody composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     const responseBody: (project: INestiaProject) => (importer: ImportDictionary) => (route: ITypedHttpRoute) => TypeNode;
 }

package/lib/generates/internal/SdkAliasCollection.js

@@ -7,16 +7,73 @@ const legacy_1 = require("../../internal/legacy");
 const FilePrinter_1 = require("./FilePrinter");
 const SdkHttpParameterProgrammer_1 = require("./SdkHttpParameterProgrammer");
 const SdkTypeProgrammer_1 = require("./SdkTypeProgrammer");
+/**
+ * Type nodes of the SDK: the named types of routes, and the request and
+ * response aliases.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace builds each type as the syntax tree that the printer writes, from the reflected names or from the metadata when `clone` is on.
+ * @evidence contracts/common.md#clear-and-simple-design Several small builders.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts The builders depend on the project configuration for the choice of source.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+ */
 var SdkAliasCollection;
 (function (SdkAliasCollection) {
+    /**
+     * Returns the type reference of a reflected type, with its type arguments.
+     *
+     * @evidence contracts/common.md#principled-implementation The arguments are built recursively.
+     * @evidence contracts/common.md#clear-and-simple-design One recursion.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It writes the name as reflected.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.name composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.name = ({ type }) => factory_1.factory.createTypeReferenceNode(type.name, type.typeArguments
         ? type.typeArguments.map((a) => SdkAliasCollection.name({ type: a }))
         : undefined);
+    /**
+     * Returns the type of one chunk of a binary response:
+     * `Uint8Array<ArrayBufferLike>`.
+     *
+     * @evidence contracts/common.md#principled-implementation The chunk type of the platform stream is a byte array.
+     * @evidence contracts/common.md#clear-and-simple-design One node.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The type is fixed.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.binaryChunk composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.binaryChunk = () => factory_1.factory.createTypeReferenceNode("Uint8Array", [
         factory_1.factory.createTypeReferenceNode("ArrayBufferLike"),
     ]);
+    /**
+     * Returns the type of a binary response: `ReadableStream` of its chunks.
+     *
+     * @evidence contracts/common.md#principled-implementation A binary response is streamed, not read into memory.
+     * @evidence contracts/common.md#clear-and-simple-design One node.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The chunk type is shared.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.binaryResponse composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.binaryResponse = () => factory_1.factory.createTypeReferenceNode("ReadableStream", [SdkAliasCollection.binaryChunk()]);
+    /**
+     * Returns the type node of a metadata.
+     *
+     * @evidence contracts/common.md#principled-implementation The metadata is written by the type programmer, so the result is the DTO the clone declares.
+     * @evidence contracts/common.md#clear-and-simple-design One delegation.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts It shares the type writer.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.from composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.from = (project) => (importer) => (metadata) => SdkTypeProgrammer_1.SdkTypeProgrammer.write(project)(importer)(metadata);
+    /**
+     * Returns the object type of a route's keyword parameters, each with the
+     * description of its parameter or its `@param` tag.
+     *
+     * @evidence contracts/common.md#principled-implementation The entries are the route's path, query, and body parameters, optional where the metadata is, without prefix.
+     * @evidence contracts/common.md#clear-and-simple-design One map over the entries.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts A parameter with a description carries it as a comment.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.httpProps composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.httpProps = (project) => (importer) => (route) => factory_1.factory.createTypeLiteralNode(SdkHttpParameterProgrammer_1.SdkHttpParameterProgrammer.getEntries({
         project,
         importer,
@@ -41,15 +98,35 @@ var SdkAliasCollection;
             : [signature];
     })
         .flat());
-    SdkAliasCollection.websocketProps = (route) => factory_1.factory.createTypeLiteralNode([
+    /**
+     * Returns the object type of a WebSocket route's keyword parameters: its path
+     * parameters, its query, and its provider.
+     *
+     * @evidence contracts/common.md#principled-implementation The keys are the names decided by the parameter programmer, so the type and the function agree.
+     * @evidence contracts/common.md#clear-and-simple-design One literal.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The names are shared.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.websocketProps composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
+    SdkAliasCollection.websocketProps = (route, names) => factory_1.factory.createTypeLiteralNode([
         ...route.pathParameters.map((p) => factory_1.factory.createPropertySignature(undefined, p.name, undefined, SdkAliasCollection.name(p))),
         ...(route.query
             ? [
-                factory_1.factory.createPropertySignature(undefined, "query", undefined, factory_1.factory.createTypeReferenceNode("Query")),
+                factory_1.factory.createPropertySignature(undefined, names.query, undefined, factory_1.factory.createTypeReferenceNode("Query")),
             ]
             : []),
-        factory_1.factory.createPropertySignature(undefined, "provider", undefined, factory_1.factory.createTypeReferenceNode("Provider")),
+        factory_1.factory.createPropertySignature(undefined, names.provider, undefined, factory_1.factory.createTypeReferenceNode("Provider")),
     ]);
+    /**
+     * Returns the type of a route's headers: its reflected name, or the
+     * metadata's type under `clone`.
+     *
+     * @evidence contracts/common.md#principled-implementation The source follows the `clone` setting.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The choice is made on one flag.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.headers composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.headers = (project) => (importer) => (param) => {
         if (project.config.clone === true)
             return SdkAliasCollection.from(project)(importer)(param.metadata);
@@ -63,6 +140,16 @@ var SdkAliasCollection;
             name: "Resolved",
         }), [type]);
     };
+    /**
+     * Returns the type of a route's query: its metadata under `clone`, otherwise
+     * its reflected type wrapped in Resolved unless primitive conversion is off.
+     *
+     * @evidence contracts/common.md#principled-implementation Clone mode uses the resolved metadata graph; source mode uses the declared type with the configured Resolved conversion.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The choice is made on one flag.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.query composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.query = (project) => (importer) => (param) => {
         if (project.config.clone === true)
             return SdkAliasCollection.from(project)(importer)(param.metadata);
@@ -76,6 +163,16 @@ var SdkAliasCollection;
             name: "Resolved",
         }), [type]);
     };
+    /**
+     * Returns the type of a route's body: a form data input for a multipart body,
+     * and otherwise the reflected name or the metadata's type under `clone`.
+     *
+     * @evidence contracts/common.md#principled-implementation The multipart body is an input of files and fields, not the declared class.
+     * @evidence contracts/common.md#clear-and-simple-design One conditional.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The cases are the content types.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.body composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.body = (project) => (importer) => (param) => {
         if (project.config.clone === true) {
             const type = SdkAliasCollection.from(project)(importer)(param.metadata);
@@ -97,9 +194,20 @@ var SdkAliasCollection;
                 : "Resolved",
         }), [type]);
     };
+    /**
+     * Returns the type of a route's output: the success and every exception as a
+     * union of `IPropagation` members, or the success body alone when propagation
+     * is off.
+     *
+     * @evidence contracts/common.md#principled-implementation Status keys retain their declared numeric or range spelling for IPropagation to expand. Source success types follow their content type, while declared exceptions use JSON Primitive conversion independently of the success media type; primitive:false preserves declared source types.
+     * @evidence contracts/common.md#clear-and-simple-design One function of two branches.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The exceptions are the declared ones.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.response composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.response = (project) => (importer) => (route) => {
         var _a;
-        const schema = (p) => (0, legacy_1.sizeOf)(p.metadata) === 0
+        const schema = (p, json) => (0, legacy_1.sizeOf)(p.metadata) === 0
             ? TypeFactory_1.TypeFactory.keyword("void")
             : project.config.clone === true
                 ? SdkAliasCollection.from(project)(importer)(p.metadata)
@@ -108,15 +216,13 @@ var SdkAliasCollection;
                         file: "typia",
                         declaration: true,
                         type: "element",
-                        name: route.success.contentType === "application/json" ||
-                            route.success.encrypted === true
-                            ? "Primitive"
-                            : "Resolved",
+                        name: json ? "Primitive" : "Resolved",
                     }), [SdkAliasCollection.name(p)])
                     : SdkAliasCollection.name(p);
         const success = route.success.binary === true
             ? SdkAliasCollection.binaryResponse()
-            : schema(route.success);
+            : schema(route.success, route.success.contentType === "application/json" ||
+                route.success.encrypted === true);
         if (project.config.propagate !== true)
             return success;
         const branches = [
@@ -126,7 +232,7 @@ var SdkAliasCollection;
             },
             ...Object.entries(route.exceptions).map(([status, value]) => ({
                 status,
-                type: schema(value),
+                type: schema(value, true),
             })),
         ];
         return factory_1.factory.createTypeReferenceNode(importer.external({
@@ -135,7 +241,11 @@ var SdkAliasCollection;
             type: "element",
             name: "IPropagation",
         }), [
-            factory_1.factory.createTypeLiteralNode(branches.map((b) => factory_1.factory.createPropertySignature(undefined, factory_1.factory.createNumericLiteral(b.status), undefined, b.type))),
+            factory_1.factory.createTypeLiteralNode(branches.map((b) => factory_1.factory.createPropertySignature(undefined, 
+            // a status range like "4XX" is no numeric literal
+            /^\d+$/.test(b.status)
+                ? factory_1.factory.createNumericLiteral(b.status)
+                : factory_1.factory.createStringLiteral(b.status), undefined, b.type))),
             ...(route.success.status
                 ? [
                     factory_1.factory.createLiteralTypeNode(factory_1.factory.createNumericLiteral(route.success.status)),
@@ -143,6 +253,17 @@ var SdkAliasCollection;
                 : []),
         ]);
     };
+    /**
+     * Returns the type of the success body: a stream for a binary response, the
+     * reflected type for a plain one, and its primitive form for a JSON
+     * response.
+     *
+     * @evidence contracts/common.md#principled-implementation The route's metadata decides between the branches.
+     * @evidence contracts/common.md#clear-and-simple-design One function.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts The branches are the response kinds.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidenceExclude contracts/portability.md#os-neutral-implementation SdkAliasCollection.responseBody composes SDK syntax, identifiers or import bindings; it does not resolve native file identity or launch a process. Source resolution and file emission belong to their filesystem owners.
+     */
     SdkAliasCollection.responseBody = (project) => (importer) => (route) => SdkAliasCollection.response(Object.assign(Object.assign({}, project), { config: Object.assign(Object.assign({}, project.config), { propagate: false }) }))(importer)(route);
     const formDataInput = (importer) => (type) => factory_1.factory.createTypeReferenceNode(importer.external({
         file: "@nestia/fetcher",

package/lib/generates/internal/SdkAliasCollection.js.map

@@ -1 +1 @@
-{"version":3,"file":"SdkAliasCollection.js","sourceRoot":"","sources":["../../../src/generates/internal/SdkAliasCollection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SdkAliasCollection.js","sourceRoot":"","sources":["../../../src/generates/internal/SdkAliasCollection.ts"],"names":[],"mappings":"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"}

package/lib/generates/internal/SdkDistributionComposer.d.ts

@@ -1,5 +1,24 @@
 import { INestiaConfig } from "../../INestiaConfig";
+/**
+ * Composes the npm package of the SDK in the distribution directory.
+ *
+ * @evidence contracts/common.md#principled-implementation The namespace copies the bundle, fills its paths in, and installs the dependencies at the versions the project uses.
+ * @evidence contracts/common.md#clear-and-simple-design One public function and the private steps.
+ * @evidence contracts/common.md#prohibited-implementation-shortcuts Each filesystem step resolves against the distribution directory; no process-global directory or foreign method is changed.
+ * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+ * @evidence contracts/portability.md#os-neutral-implementation Native paths use path.relative/path.join and generated paths use slash separators. npm receives an argument vector and an explicit cwd. POSIX launches npm directly; Windows launches the npm-cli.js shipped beside the first npm.cmd on PATH through Node because a cmd shim itself requires shell interpretation. A nonstandard Windows npm shim lacking that adjacent npm installation is rejected explicitly.
+ */
 export declare namespace SdkDistributionComposer {
+    /**
+     * Prepares the distribution package once: files, paths, and dependencies, and
+     * does nothing when the package is already configured.
+     *
+     * @evidence contracts/common.md#principled-implementation The package counts as configured when it holds `@nestia/fetcher`, which is installed last with its peers, so an interrupted setup runs again. The caller directory is captured once, and every output path and package-manager cwd is explicit.
+     * @evidence contracts/common.md#clear-and-simple-design One function of sequential steps.
+     * @evidence contracts/common.md#prohibited-implementation-shortcuts No process-global directory is changed, so independent compositions retain their own destinations.
+     * @evidence contracts/common.md#meaningful-documentation The comment states what the declaration produces and its result.
+     * @evidence contracts/portability.md#os-neutral-implementation Existence of the two package files is the filesystem's own answer, and the bundle files are copied over any file of the same name in a distribution directory that is not yet configured, so an interrupted setup repeats the copy.
+     */
     const compose: (props: {
         config: INestiaConfig;
         mcp: boolean;