@rexeus/typeweaver-gen 0.10.5 → 0.12.0

package/dist/index.cjs

@@ -124,6 +124,175 @@ var PathParameterMismatchError = class extends Error {
 	}
 };
 //#endregion
+//#region src/bodyNormalization.ts
+const JSON_BODY_SCHEMA_TYPES = new Set([
+	"array",
+	"boolean",
+	"enum",
+	"intersection",
+	"literal",
+	"null",
+	"number",
+	"object",
+	"record",
+	"tuple",
+	"union"
+]);
+const normalizeBody = (input) => {
+	if (input.bodySchema === void 0) return { warnings: [] };
+	const warnings = [];
+	const contentTypeHeader = extractContentTypeHeader(input.headerSchema);
+	if (contentTypeHeader.kind === "literal") return {
+		body: createNormalizedBody({
+			schema: input.bodySchema,
+			mediaType: contentTypeHeader.value,
+			mediaTypeSource: "content-type-header"
+		}),
+		warnings
+	};
+	if (contentTypeHeader.kind === "ambiguous") warnings.push({
+		code: "ambiguous-content-type-header",
+		message: "Content-Type header is present but does not have one unambiguous literal value; inferred body media type instead.",
+		location: input.location
+	});
+	else warnings.push({
+		code: "missing-content-type-header",
+		message: "Body schema is present without a Content-Type header; inferred body media type from schema.",
+		location: input.location
+	});
+	const inferred = inferBodyMediaType(input.bodySchema);
+	if (inferred.mediaTypeSource === "raw-fallback") warnings.push({
+		code: "raw-body-media-type-fallback",
+		message: "Body schema does not imply a concrete media type; used application/octet-stream raw transport fallback.",
+		location: input.location
+	});
+	return {
+		body: createNormalizedBody({
+			schema: input.bodySchema,
+			...inferred
+		}),
+		warnings
+	};
+};
+const createNormalizedBody = (input) => {
+	return {
+		schema: input.schema,
+		mediaType: input.mediaType,
+		mediaTypeSource: input.mediaTypeSource,
+		transport: resolveTransport(input.mediaType)
+	};
+};
+const extractContentTypeHeader = (headerSchema) => {
+	const headerObject = unwrapOptional(headerSchema);
+	if (headerObject === void 0 || !isZodObject$1(headerObject)) return { kind: "absent" };
+	const contentTypeEntries = Object.entries(headerObject.shape).filter(([headerName]) => headerName.toLowerCase() === "content-type");
+	if (contentTypeEntries.length === 0) return { kind: "absent" };
+	const literalValues = contentTypeEntries.flatMap(([, schema]) => extractStringLiteralValues(schema));
+	const distinctValues = new Set(literalValues);
+	if (contentTypeEntries.length === 1 && distinctValues.size === 1) {
+		const [value] = distinctValues;
+		return value === void 0 ? { kind: "ambiguous" } : {
+			kind: "literal",
+			value
+		};
+	}
+	return { kind: "ambiguous" };
+};
+const inferBodyMediaType = (schema) => {
+	const inferenceSchema = unwrapMediaInferenceSchema(schema);
+	const schemaType = getSchemaType(inferenceSchema);
+	if (isTextBodySchema(inferenceSchema)) return {
+		mediaType: "text/plain",
+		mediaTypeSource: "body-schema"
+	};
+	if (schemaType === "any" || schemaType === "unknown") return {
+		mediaType: "application/octet-stream",
+		mediaTypeSource: "raw-fallback"
+	};
+	if (schemaType !== void 0 && JSON_BODY_SCHEMA_TYPES.has(schemaType)) return {
+		mediaType: "application/json",
+		mediaTypeSource: "body-schema"
+	};
+	return {
+		mediaType: "application/octet-stream",
+		mediaTypeSource: "raw-fallback"
+	};
+};
+const isTextBodySchema = (schema) => {
+	const schemaType = getSchemaType(schema);
+	if (schemaType === "string") return true;
+	if (schemaType === "literal") {
+		const values = literalSchemaValues(schema);
+		return values.length > 0 && values.every((value) => typeof value === "string");
+	}
+	if (schemaType === "enum") {
+		const values = enumSchemaValues(schema);
+		return values.length > 0 && values.every((value) => typeof value === "string");
+	}
+	return false;
+};
+const resolveTransport = (mediaType) => {
+	const normalizedMediaType = mediaType.split(";")[0]?.trim().toLowerCase();
+	if (normalizedMediaType === "application/json" || normalizedMediaType?.endsWith("+json") === true) return "json";
+	if (normalizedMediaType?.startsWith("text/") === true) return "text";
+	if (normalizedMediaType === "application/x-www-form-urlencoded") return "form-url-encoded";
+	if (normalizedMediaType === "multipart/form-data") return "multipart";
+	return "raw";
+};
+const unwrapMediaInferenceSchema = (schema) => {
+	const visitedSchemas = /* @__PURE__ */ new Set();
+	let current = schema;
+	while (current !== void 0 && !visitedSchemas.has(current)) {
+		visitedSchemas.add(current);
+		const definition = getSchemaDefinition(current);
+		const schemaType = definition?.type;
+		if (schemaType === "optional" || schemaType === "nullable" || schemaType === "default" || schemaType === "catch" || schemaType === "prefault" || schemaType === "readonly") {
+			current = definition?.innerType;
+			continue;
+		}
+		if (schemaType === "pipe") {
+			const outputType = getSchemaType(definition?.out);
+			if (outputType === void 0 || outputType === "transform") return;
+			current = definition?.out;
+			continue;
+		}
+		if (schemaType === "effects") {
+			current = definition?.schema;
+			continue;
+		}
+		return current;
+	}
+	return current;
+};
+const unwrapOptional = (schema) => {
+	return schema instanceof zod.z.ZodOptional ? schema.unwrap() : schema;
+};
+const isZodObject$1 = (schema) => {
+	return getSchemaType(schema) === "object" && "shape" in schema;
+};
+const extractStringLiteralValues = (schema) => {
+	const unwrappedSchema = unwrapOptional(schema);
+	if (unwrappedSchema === void 0) return [];
+	if (getSchemaType(unwrappedSchema) === "literal") return literalSchemaValues(unwrappedSchema).filter((value) => typeof value === "string");
+	if (getSchemaType(unwrappedSchema) === "enum") return enumSchemaValues(unwrappedSchema).filter((value) => typeof value === "string");
+	return [];
+};
+const literalSchemaValues = (schema) => {
+	const literalSchema = schema;
+	return Array.from(literalSchema?.values ?? []);
+};
+const enumSchemaValues = (schema) => {
+	const enumSchema = schema;
+	return enumSchema?.options ?? enumSchema?.def?.values ?? Object.values(enumSchema?.def?.entries ?? enumSchema?.enum ?? {});
+};
+const getSchemaType = (schema) => {
+	return getSchemaDefinition(schema)?.type;
+};
+const getSchemaDefinition = (schema) => {
+	const schemaWithDefinition = schema;
+	return schemaWithDefinition?.def ?? schemaWithDefinition?._def;
+};
+//#endregion
 //#region src/helpers/namingUtils.ts
 const startsWithDigit = (value) => /^[0-9]/u.test(value);
 const isSupportedIdentifierName = (value) => {
@@ -198,25 +367,49 @@ const validateInlineDerivedResponses = (definition, canonicalResponses) => {
 		validateDerivedResponseAgainstCanonicalGraph(response, canonicalResponses);
 	}
 };
-const normalizeResponseDefinition = (response) => {
+const normalizeResponseDefinition = (response, location) => {
+	const body = normalizeBody({
+		bodySchema: response.body,
+		headerSchema: response.header,
+		location: {
+			...location,
+			part: "response.body"
+		}
+	});
 	return {
-		name: response.name,
-		statusCode: response.statusCode,
-		statusCodeName: _rexeus_typeweaver_core.HttpStatusCodeNameMap[response.statusCode],
-		description: response.description,
-		header: response.header,
-		body: response.body,
-		kind: response.derived === void 0 ? "response" : "derived-response",
-		derivedFrom: response.derived?.parentName,
-		lineage: response.derived?.lineage,
-		depth: response.derived?.depth
+		response: {
+			name: response.name,
+			statusCode: response.statusCode,
+			statusCodeName: _rexeus_typeweaver_core.HttpStatusCodeNameMap[response.statusCode],
+			description: response.description,
+			header: response.header,
+			body: body.body,
+			kind: response.derived === void 0 ? "response" : "derived-response",
+			derivedFrom: response.derived?.parentName,
+			lineage: response.derived?.lineage,
+			depth: response.derived?.depth
+		},
+		warnings: body.warnings
 	};
 };
 const collectCanonicalResponses = (definition) => {
 	const canonicalResponseDefinitions = collectCanonicalResponseDefinitions(definition);
+	const warnings = [];
 	validateDerivedResponseGraph(canonicalResponseDefinitions);
 	validateInlineDerivedResponses(definition, canonicalResponseDefinitions);
-	return new Map(Array.from(canonicalResponseDefinitions.entries(), ([responseName, response]) => [responseName, normalizeResponseDefinition(response)]));
+	const responses = /* @__PURE__ */ new Map();
+	for (const [responseName, response] of canonicalResponseDefinitions) {
+		const normalized = normalizeResponseDefinition(response, {
+			responseName,
+			statusCode: response.statusCode
+		});
+		responses.set(responseName, normalized.response);
+		warnings.push(...normalized.warnings);
+	}
+	return {
+		responses,
+		warnings
+	};
 };
 //#endregion
 //#region src/normalizeSpec.ts
@@ -230,7 +423,7 @@ const validateRequestSchema = (operationId, requestPart, schema) => {
 	if (!isZodType(schema)) throw new InvalidRequestSchemaError(operationId, requestPart);
 	if (requestPart === "param" && !isZodObject(schema)) throw new InvalidRequestSchemaError(operationId, requestPart);
 };
-const validateRequest = (operationId, path, request) => {
+const validateRequest = (resourceName, operationId, path, request) => {
 	if (request.header !== void 0) validateRequestSchema(operationId, "header", request.header);
 	if (request.param !== void 0) validateRequestSchema(operationId, "param", request.param);
 	if (request.query !== void 0) validateRequestSchema(operationId, "query", request.query);
@@ -238,28 +431,51 @@ const validateRequest = (operationId, path, request) => {
 	const pathParams = getPathParameterNames(path);
 	const requestParams = request.param === void 0 ? [] : Object.keys(request.param.shape);
 	if (pathParams.length !== requestParams.length || pathParams.some((pathParam) => !requestParams.includes(pathParam))) throw new PathParameterMismatchError(operationId, path, pathParams, requestParams);
-	if (request.header === void 0 && request.param === void 0 && request.query === void 0 && request.body === void 0) return;
+	if (request.header === void 0 && request.param === void 0 && request.query === void 0 && request.body === void 0) return { warnings: [] };
+	const body = normalizeBody({
+		bodySchema: request.body,
+		headerSchema: request.header,
+		location: {
+			resourceName,
+			operationId,
+			part: "request.body"
+		}
+	});
 	return {
-		header: request.header,
-		param: request.param,
-		query: request.query,
-		body: request.body
+		request: {
+			header: request.header,
+			param: request.param,
+			query: request.query,
+			body: body.body
+		},
+		warnings: body.warnings
 	};
 };
-const normalizeOperationResponses = (responses) => {
-	return responses.map((response) => {
-		if ((0, _rexeus_typeweaver_core.isNamedResponseDefinition)(response)) return {
-			responseName: response.name,
-			source: "canonical"
-		};
-		return {
-			responseName: response.name,
-			source: "inline",
-			response: normalizeResponseDefinition(response)
-		};
-	});
+const normalizeOperationResponses = (resourceName, operationId, responses) => {
+	const warnings = [];
+	return {
+		responses: responses.map((response) => {
+			if ((0, _rexeus_typeweaver_core.isNamedResponseDefinition)(response)) return {
+				responseName: response.name,
+				source: "canonical"
+			};
+			const normalized = normalizeResponseDefinition(response, {
+				resourceName,
+				operationId,
+				responseName: response.name,
+				statusCode: response.statusCode
+			});
+			warnings.push(...normalized.warnings);
+			return {
+				responseName: response.name,
+				source: "inline",
+				response: normalized.response
+			};
+		}),
+		warnings
+	};
 };
-const normalizeOperation = (operationIds, routeKeys, operation) => {
+const normalizeOperation = (resourceName, operationIds, routeKeys, operation) => {
 	if (!isSupportedOperationId(operation.operationId)) throw new InvalidOperationIdError(operation.operationId);
 	if (operationIds.has(operation.operationId)) throw new DuplicateOperationIdError(operation.operationId);
 	operationIds.add(operation.operationId);
@@ -268,13 +484,18 @@ const normalizeOperation = (operationIds, routeKeys, operation) => {
 	if (routeKeys.has(routeKey)) throw new DuplicateRouteError(operation.method, operation.path, normalizedPath);
 	routeKeys.add(routeKey);
 	if (operation.responses.length === 0) throw new EmptyOperationResponsesError(operation.operationId);
+	const request = validateRequest(resourceName, operation.operationId, operation.path, operation.request);
+	const responses = normalizeOperationResponses(resourceName, operation.operationId, operation.responses);
 	return {
-		operationId: operation.operationId,
-		method: operation.method,
-		path: operation.path,
-		summary: operation.summary,
-		request: validateRequest(operation.operationId, operation.path, operation.request),
-		responses: normalizeOperationResponses(operation.responses)
+		operation: {
+			operationId: operation.operationId,
+			method: operation.method,
+			path: operation.path,
+			summary: operation.summary,
+			request: request.request,
+			responses: responses.responses
+		},
+		warnings: [...request.warnings, ...responses.warnings]
 	};
 };
 const normalizeSpec = (definition) => {
@@ -284,16 +505,22 @@ const normalizeSpec = (definition) => {
 	const canonicalResponses = collectCanonicalResponses(definition);
 	const operationIds = /* @__PURE__ */ new Set();
 	const routeKeys = /* @__PURE__ */ new Set();
+	const warnings = [...canonicalResponses.warnings];
 	return {
 		resources: resourceEntries.map(([resourceName, resource]) => {
 			if (!isSupportedResourceName(resourceName)) throw new InvalidResourceNameError(resourceName);
 			if (resource.operations.length === 0) throw new EmptyResourceOperationsError(resourceName);
 			return {
 				name: resourceName,
-				operations: resource.operations.map((operation) => normalizeOperation(operationIds, routeKeys, operation))
+				operations: resource.operations.map((operation) => {
+					const normalized = normalizeOperation(resourceName, operationIds, routeKeys, operation);
+					warnings.push(...normalized.warnings);
+					return normalized.operation;
+				})
 			};
 		}),
-		responses: Array.from(canonicalResponses.values())
+		responses: Array.from(canonicalResponses.responses.values()),
+		warnings
 	};
 };
 //#endregion
@@ -478,6 +705,112 @@ var MissingCanonicalResponseError = class extends Error {
 };
 //#endregion
 //#region src/plugins/pluginContext.ts
+const WINDOWS_DRIVE_PREFIX_PATTERN = /^[a-zA-Z]:/;
+function pathContainsParentTraversal(projectPath) {
+	return projectPath.split("/").includes("..");
+}
+function pathEndsWithDirectorySeparator(projectPath) {
+	return projectPath.endsWith("/");
+}
+function pathNamesCurrentDirectory(projectPath) {
+	return projectPath === "." || projectPath.endsWith("/.");
+}
+function resolveSafeGeneratedFilePath(outputDir, requestedPath) {
+	if (requestedPath.length === 0) throwUnsafeGeneratedFilePath(requestedPath, "path must not be empty");
+	const projectPath = requestedPath.replace(/\\/g, "/");
+	if (node_path.default.isAbsolute(requestedPath) || node_path.default.posix.isAbsolute(projectPath) || node_path.default.win32.isAbsolute(requestedPath) || node_path.default.win32.isAbsolute(projectPath) || WINDOWS_DRIVE_PREFIX_PATTERN.test(requestedPath)) throwUnsafeGeneratedFilePath(requestedPath, "absolute paths are not allowed");
+	if (pathContainsParentTraversal(projectPath)) throwUnsafeGeneratedFilePath(requestedPath, "path contains parent-directory traversal");
+	if (pathEndsWithDirectorySeparator(projectPath)) throwUnsafeGeneratedFilePath(requestedPath, "path must name a file inside the output directory");
+	if (pathNamesCurrentDirectory(projectPath)) throwUnsafeGeneratedFilePath(requestedPath, "path must name a file inside the output directory");
+	const generatedPath = node_path.default.posix.normalize(projectPath);
+	if (generatedPath === ".") throwUnsafeGeneratedFilePath(requestedPath, "path must name a file inside the output directory");
+	if (pathContainsParentTraversal(generatedPath)) throwUnsafeGeneratedFilePath(requestedPath, "path contains parent-directory traversal");
+	const outputRoot = node_path.default.resolve(outputDir);
+	const fullPath = node_path.default.resolve(outputRoot, toNativePath(generatedPath));
+	if (!isStrictlyInsidePath(fullPath, outputRoot)) throwUnsafeGeneratedFilePath(requestedPath, "path escapes the output directory");
+	assertGeneratedPathHasNoSymlinkComponents({
+		outputRoot,
+		generatedPath,
+		requestedPath
+	});
+	return {
+		fullPath,
+		generatedPath
+	};
+}
+function toNativePath(projectPath) {
+	return projectPath.split("/").join(node_path.default.sep);
+}
+function assertGeneratedPathHasNoSymlinkComponents(config) {
+	assertExistingPathIsNotSymlink(config.outputRoot, config.requestedPath);
+	let currentPath = config.outputRoot;
+	for (const segment of config.generatedPath.split("/")) {
+		currentPath = node_path.default.join(currentPath, segment);
+		const pathStats = getExistingPathStats(currentPath);
+		if (pathStats === void 0) return;
+		assertPathStatsIsNotSymlink(pathStats, config.requestedPath);
+		if (!pathStats.isDirectory()) return;
+	}
+}
+function assertExistingPathIsNotSymlink(absolutePath, requestedPath) {
+	const pathStats = getExistingPathStats(absolutePath);
+	if (pathStats === void 0) return;
+	assertPathStatsIsNotSymlink(pathStats, requestedPath);
+}
+function assertPathStatsIsNotSymlink(pathStats, requestedPath) {
+	if (!pathStats.isSymbolicLink()) return;
+	throwUnsafeGeneratedFilePath(requestedPath, "path contains a symbolic link");
+}
+function getExistingPathStats(absolutePath) {
+	try {
+		return node_fs.default.lstatSync(absolutePath);
+	} catch (error) {
+		if (isMissingPathError(error)) return;
+		throw error;
+	}
+}
+function isMissingPathError(error) {
+	if (!(error instanceof Error)) return false;
+	return ["ENOENT", "ENOTDIR"].includes(error.code ?? "");
+}
+function isStrictlyInsidePath(childPath, parentPath) {
+	const relativePath = node_path.default.relative(parentPath, childPath);
+	return relativePath !== "" && relativePath !== ".." && !relativePath.startsWith(`..${node_path.default.sep}`) && !node_path.default.isAbsolute(relativePath);
+}
+function throwUnsafeGeneratedFilePath(requestedPath, reason) {
+	throw new Error(`Unsafe generated file path '${requestedPath}': ${reason}. Generated writes must stay inside the output directory.`);
+}
+function revalidateGeneratedWritePath(outputDir, generatedPath) {
+	return resolveSafeGeneratedFilePath(outputDir, generatedPath);
+}
+function writeGeneratedFileByReplacingDestination(config) {
+	const existingFileMode = getExistingFileMode(revalidateGeneratedWritePath(config.outputDir, config.generatedPath).fullPath);
+	const tempParentPath = revalidateGeneratedWritePath(config.outputDir, config.generatedPath);
+	const destinationDir = node_path.default.dirname(tempParentPath.fullPath);
+	const tempDir = node_fs.default.mkdtempSync(node_path.default.join(destinationDir, ".typeweaver-"));
+	const tempFile = node_path.default.join(tempDir, "generated.tmp");
+	try {
+		revalidateGeneratedWritePath(config.outputDir, config.generatedPath);
+		node_fs.default.writeFileSync(tempFile, config.content, {
+			flag: "wx",
+			mode: existingFileMode ?? 438
+		});
+		if (existingFileMode !== void 0) node_fs.default.chmodSync(tempFile, existingFileMode);
+		const writablePath = revalidateGeneratedWritePath(config.outputDir, config.generatedPath);
+		node_fs.default.renameSync(tempFile, writablePath.fullPath);
+		return writablePath;
+	} finally {
+		node_fs.default.rmSync(tempDir, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+function getExistingFileMode(absolutePath) {
+	const pathStats = getExistingPathStats(absolutePath);
+	if (pathStats?.isFile() !== true) return;
+	return pathStats.mode & 511;
+}
 function createPluginContextBuilder() {
 	const generatedFiles = /* @__PURE__ */ new Set();
 	const createPluginContext = (params) => {
@@ -543,19 +876,25 @@ function createPluginContextBuilder() {
 			getOperationOutputPaths,
 			getResourceOutputDir,
 			writeFile: (relativePath, content) => {
-				const fullPath = node_path.default.join(params.outputDir, relativePath);
-				const dir = node_path.default.dirname(fullPath);
+				const safePath = resolveSafeGeneratedFilePath(params.outputDir, relativePath);
+				const dir = node_path.default.dirname(safePath.fullPath);
 				node_fs.default.mkdirSync(dir, { recursive: true });
-				node_fs.default.writeFileSync(fullPath, content);
-				generatedFiles.add(relativePath);
-				console.info(`Generated: ${relativePath}`);
+				const writablePath = revalidateGeneratedWritePath(params.outputDir, safePath.generatedPath);
+				const generatedFile = writeGeneratedFileByReplacingDestination({
+					outputDir: params.outputDir,
+					generatedPath: writablePath.generatedPath,
+					content
+				});
+				generatedFiles.add(generatedFile.generatedPath);
+				console.info(`Generated: ${generatedFile.generatedPath}`);
 			},
 			renderTemplate: (templatePath, data) => {
 				const fullTemplatePath = node_path.default.isAbsolute(templatePath) ? templatePath : node_path.default.join(params.templateDir, templatePath);
 				return renderTemplate(node_fs.default.readFileSync(fullTemplatePath, "utf8"), data ?? {});
 			},
 			addGeneratedFile: (relativePath) => {
-				generatedFiles.add(relativePath);
+				const safePath = resolveSafeGeneratedFilePath(params.outputDir, relativePath);
+				generatedFiles.add(safePath.generatedPath);
 			},
 			getGeneratedFiles: () => {
 				return Array.from(generatedFiles);

package/dist/index.d.cts

@@ -44,6 +44,28 @@ declare class InvalidOperationIdError extends Error {
 type NormalizedSpec = {
   readonly resources: readonly NormalizedResource[];
   readonly responses: readonly NormalizedResponse[];
+  readonly warnings: readonly NormalizedSpecWarning[];
+};
+type NormalizedBodyMediaTypeSource = "content-type-header" | "body-schema" | "raw-fallback";
+type NormalizedBodyTransport = "json" | "text" | "form-url-encoded" | "multipart" | "raw";
+type NormalizedHttpBody = {
+  readonly schema: HttpBodySchema;
+  readonly mediaType: string;
+  readonly mediaTypeSource: NormalizedBodyMediaTypeSource;
+  readonly transport: NormalizedBodyTransport;
+};
+type NormalizedSpecWarningCode = "ambiguous-content-type-header" | "missing-content-type-header" | "raw-body-media-type-fallback";
+type NormalizedSpecWarningLocation = {
+  readonly part: "request.body" | "response.body";
+  readonly resourceName?: string;
+  readonly operationId?: string;
+  readonly responseName?: string;
+  readonly statusCode?: HttpStatusCode;
+};
+type NormalizedSpecWarning = {
+  readonly code: NormalizedSpecWarningCode;
+  readonly message: string;
+  readonly location: NormalizedSpecWarningLocation;
 };
 type NormalizedResource = {
   readonly name: string;
@@ -61,7 +83,7 @@ type NormalizedRequest = {
   readonly header?: HttpHeaderSchema;
   readonly param?: HttpParamSchema;
   readonly query?: HttpQuerySchema;
-  readonly body?: HttpBodySchema;
+  readonly body?: NormalizedHttpBody;
 };
 type NormalizedResponse = {
   readonly name: string;
@@ -69,7 +91,7 @@ type NormalizedResponse = {
   readonly statusCodeName: string;
   readonly description: string;
   readonly header?: HttpHeaderSchema;
-  readonly body?: HttpBodySchema;
+  readonly body?: NormalizedHttpBody;
   readonly kind: "response" | "derived-response";
   readonly derivedFrom?: string;
   readonly lineage?: readonly string[];
@@ -347,5 +369,5 @@ declare const compareRoutes: (a: {
 //#region src/helpers/templateEngine.d.ts
 declare function renderTemplate(template: string, data: Record<string, unknown>): string;
 //#endregion
-export { BasePlugin, CreateJSDocCommentOptions, DerivedResponseCycleError, DuplicateOperationIdError, DuplicateRouteError, EmptyOperationResponsesError, EmptyResourceOperationsError, EmptySpecResourcesError, GeneratorContext, InvalidDerivedResponseError, InvalidOperationIdError, InvalidRequestSchemaError, InvalidResourceNameError, MissingDerivedResponseParentError, NormalizedCanonicalResponseUsage, NormalizedInlineResponseUsage, NormalizedOperation, NormalizedRequest, NormalizedResource, NormalizedResponse, NormalizedResponseUsage, NormalizedSpec, OperationOutputPaths, PathParameterMismatchError, PluginConfig, PluginConstructor, PluginContext, type PluginContextBuilderApi, PluginDependencyError, PluginLoadError, PluginMetadata, PluginModule, PluginRegistration, type PluginRegistryApi, TypeweaverConfig, TypeweaverPlugin, compareRoutes, createJSDocComment, createPluginContextBuilder, createPluginRegistry, getMethodPriority, getPathParameterNames, isSupportedOperationId, isSupportedResourceName, normalizeRoutePath, normalizeSpec, relative, renderTemplate };
+export { BasePlugin, CreateJSDocCommentOptions, DerivedResponseCycleError, DuplicateOperationIdError, DuplicateRouteError, EmptyOperationResponsesError, EmptyResourceOperationsError, EmptySpecResourcesError, GeneratorContext, InvalidDerivedResponseError, InvalidOperationIdError, InvalidRequestSchemaError, InvalidResourceNameError, MissingDerivedResponseParentError, NormalizedBodyMediaTypeSource, NormalizedBodyTransport, NormalizedCanonicalResponseUsage, NormalizedHttpBody, NormalizedInlineResponseUsage, NormalizedOperation, NormalizedRequest, NormalizedResource, NormalizedResponse, NormalizedResponseUsage, NormalizedSpec, NormalizedSpecWarning, NormalizedSpecWarningCode, NormalizedSpecWarningLocation, OperationOutputPaths, PathParameterMismatchError, PluginConfig, PluginConstructor, PluginContext, type PluginContextBuilderApi, PluginDependencyError, PluginLoadError, PluginMetadata, PluginModule, PluginRegistration, type PluginRegistryApi, TypeweaverConfig, TypeweaverPlugin, compareRoutes, createJSDocComment, createPluginContextBuilder, createPluginRegistry, getMethodPriority, getPathParameterNames, isSupportedOperationId, isSupportedResourceName, normalizeRoutePath, normalizeSpec, relative, renderTemplate };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors/DerivedResponseCycleError.ts","../src/errors/DuplicateOperationIdError.ts","../src/errors/DuplicateRouteError.ts","../src/errors/EmptyOperationResponsesError.ts","../src/errors/EmptyResourceOperationsError.ts","../src/errors/EmptySpecResourcesError.ts","../src/errors/InvalidDerivedResponseError.ts","../src/errors/InvalidOperationIdError.ts","../src/NormalizedSpec.ts","../src/errors/InvalidRequestSchemaError.ts","../src/errors/InvalidResourceNameError.ts","../src/errors/MissingDerivedResponseParentError.ts","../src/errors/PathParameterMismatchError.ts","../src/normalizeSpec.ts","../src/plugins/types.ts","../src/plugins/BasePlugin.ts","../src/plugins/pluginRegistry.ts","../src/plugins/pluginContext.ts","../src/helpers/namingUtils.ts","../src/helpers/jsdoc.ts","../src/helpers/path.ts","../src/helpers/routePath.ts","../src/helpers/routeSort.ts","../src/helpers/templateEngine.ts"],"mappings":";;;cAAa,yBAAA,SAAkC,KAAA;cAC1B,YAAA;AAAA;;;cCDR,yBAAA,SAAkC,KAAA;cAC1B,WAAA;AAAA;;;cCDR,mBAAA,SAA4B,KAAA;cACpB,MAAA,UAAgB,IAAA,UAAc,cAAA;AAAA;;;cCDtC,4BAAA,SAAqC,KAAA;cAC7B,WAAA;AAAA;;;cCDR,4BAAA,SAAqC,KAAA;cAC7B,YAAA;AAAA;;;cCDR,uBAAA,SAAgC,KAAA;EAAA,WAAA,CAAA;AAAA;;;cCAhC,2BAAA,SAAoC,KAAA;cAC5B,YAAA;AAAA;;;cCDR,uBAAA,SAAgC,KAAA;cACxB,WAAA;AAAA;;;KCQT,cAAA;EAAA,SACD,SAAA,WAAoB,kBAAA;EAAA,SACpB,SAAA,WAAoB,kBAAA;AAAA;AAAA,KAGnB,kBAAA;EAAA,SACD,IAAA;EAAA,SACA,UAAA,WAAqB,mBAAA;AAAA;AAAA,KAGpB,mBAAA;EAAA,SACD,WAAA;EAAA,SACA,MAAA,EAAQ,UAAA;EAAA,SACR,IAAA;EAAA,SACA,OAAA;EAAA,SACA,OAAA,GAAU,iBAAA;EAAA,SACV,SAAA,WAAoB,uBAAA;AAAA;AAAA,KAGnB,iBAAA;EAAA,SACD,MAAA,GAAS,gBAAA;EAAA,SACT,KAAA,GAAQ,eAAA;EAAA,SACR,KAAA,GAAQ,eAAA;EAAA,SACR,IAAA,GAAO,cAAA;AAAA;AAAA,KAGN,kBAAA;EAAA,SACD,IAAA;EAAA,SACA,UAAA,EAAY,cAAA;EAAA,SACZ,cAAA;EAAA,SACA,WAAA;EAAA,SACA,MAAA,GAAS,gBAAA;EAAA,SACT,IAAA,GAAO,cAAA;EAAA,SACP,IAAA;EAAA,SACA,WAAA;EAAA,SACA,OAAA;EAAA,SACA,KAAA;AAAA;AAAA,KAGC,gCAAA;EAAA,SACD,YAAA;EAAA,SACA,MAAA;AAAA;AAAA,KAGC,6BAAA;EAAA,SACD,YAAA;EAAA,SACA,MAAA;EAAA,SACA,QAAA,EAAU,kBAAA;AAAA;AAAA,KAGT,uBAAA,GACR,gCAAA,GACA,6BAAA;;;cC3DS,yBAAA,SAAkC,KAAA;cAE3C,WAAA,UACA,WAAA,QAAmB,iBAAA;AAAA;;;cCLV,wBAAA,SAAiC,KAAA;cACzB,YAAA;AAAA;;;cCDR,iCAAA,SAA0C,KAAA;cAClC,YAAA,UAAsB,UAAA;AAAA;;;cCD9B,0BAAA,SAAmC,KAAA;cAE5C,WAAA,UACA,IAAA,UACA,UAAA,qBACA,aAAA;AAAA;;;cCmLS,aAAA,GAAiB,UAAA,EAAY,cAAA,KAAiB,cAAA;;;;;AbxL3D;KcKY,YAAA,GAAe,MAAA;;;;KAKf,aAAA;EAAA,SACD,SAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA,EAAQ,YAAA;AAAA;AAAA,KAGP,oBAAA;EAAA,SACD,SAAA;EAAA,SACA,WAAA;EAAA,SACA,eAAA;EAAA,SACA,YAAA;EAAA,SACA,gBAAA;EAAA,SACA,qBAAA;EAAA,SACA,yBAAA;EAAA,SACA,sBAAA;EAAA,SACA,0BAAA;EAAA,SACA,UAAA;EAAA,SACA,cAAA;AAAA;;AZ3BX;;KYiCY,gBAAA,GAAmB,aAAA;EAAA,SACpB,cAAA,EAAgB,cAAA;EAAA,SAChB,OAAA;EAAA,SACA,kBAAA;EAAA,SACA,aAAA;EAAA,SAEA,oBAAA,GAAuB,YAAA,aAAyB,kBAAA;EAAA,SAChD,8BAAA,GAAiC,YAAA;EAAA,SACjC,8BAAA,GAAiC,MAAA;IAAA,SAC/B,WAAA;IAAA,SACA,YAAA;EAAA;EAAA,SAEF,iBAAA,GAAoB,MAAA;IAAA,SAClB,WAAA;EAAA;EAAA,SAEF,8BAAA,GAAiC,MAAA;IAAA,SAC/B,YAAA;IAAA,SACA,WAAA;EAAA;EAAA,SAEF,uBAAA,GAA0B,MAAA;IAAA,SACxB,YAAA;IAAA,SACA,WAAA;EAAA,MACL,oBAAA;EAAA,SACG,oBAAA,GAAuB,YAAA;EAAA,SACvB,SAAA,GAAY,YAAA,UAAsB,OAAA;EAAA,SAClC,cAAA,GAAiB,YAAA,UAAsB,IAAA;EAAA,SACvC,gBAAA,GAAmB,YAAA;EAAA,SACnB,iBAAA;AAAA;;;;KAMC,cAAA;EAAA,SACD,IAAA;EAAA,SACA,OAAA;AAAA;;ATpEX;;KS0EY,gBAAA,GAAmB,cAAA;ET1Ec;;;;ES+E3C,UAAA,EAAY,OAAA,EAAS,aAAA,GAAgB,OAAA;ER/E1B;;;;EQqFX,gBAAA,EACE,cAAA,EAAgB,cAAA,GACf,OAAA,CAAQ,cAAA,IAAkB,cAAA;;;;;EAM7B,QAAA,EAAU,OAAA,EAAS,gBAAA,GAAmB,OAAA;;;AP7FxC;;EOmGE,QAAA,EAAU,OAAA,EAAS,aAAA,GAAgB,OAAA;AAAA;;;;KAMzB,iBAAA,QAAyB,MAAA,GAAS,YAAA,KAAiB,gBAAA;;;;KAKnD,YAAA;EACV,OAAA,EAAS,iBAAA;AAAA;;;;KAMC,kBAAA;EACV,IAAA;EACA,MAAA,EAAQ,gBAAA;EACR,MAAA,GAAS,YAAA;AAAA;AN1GX;;;AAAA,KMgHY,gBAAA;EACV,KAAA;EACA,MAAA;EACA,OAAA,sBAA6B,YAAA;EAC7B,MAAA;EACA,KAAA;AAAA;;;;cAMW,eAAA,SAAwB,KAAA;EAE1B,UAAA;cAAA,UAAA,UACP,OAAA;AAAA;;;;cAUS,qBAAA,SAA8B,KAAA;EAEhC,UAAA;EACA,iBAAA;cADA,UAAA,UACA,iBAAA,UACP,OAAA;AAAA;;;;Ad1JJ;;;uBecsB,UAAA,YAAsB,gBAAA;EAAA,SACjC,IAAA;EACT,WAAA;EACA,MAAA;EACA,OAAA;EAAA,UAEU,MAAA,EAAQ,YAAA;cAEN,MAAA,GAAQ,YAAA;;;AdtBtB;Ec6BQ,UAAA,CAAW,QAAA,EAAU,aAAA,GAAgB,OAAA;;;;EAO3C,gBAAA,CAAiB,cAAA,EAAgB,cAAA,GAAiB,cAAA;EdnC/B;;;EAAA,Sc0CV,QAAA,CAAS,OAAA,EAAS,gBAAA,GAAmB,OAAA;;;Ab3ChD;EagDQ,QAAA,CAAS,QAAA,EAAU,aAAA,GAAgB,OAAA;EAAA,UAI/B,YAAA,CACR,OAAA,EAAS,gBAAA,EACT,YAAA,UACA,YAAA;AAAA;;;KCpDQ,iBAAA;EAAA,SACD,QAAA,GAAW,MAAA,EAAQ,gBAAA,EAAkB,MAAA;EAAA,SACrC,GAAA,GAAM,IAAA,aAAiB,kBAAA;EAAA,SACvB,MAAA,QAAc,kBAAA;EAAA,SACd,GAAA,GAAM,IAAA;EAAA,SACN,KAAA;AAAA;AAAA,iBAGK,oBAAA,CAAA,GAAwB,iBAAA;;;KCF5B,uBAAA;EAAA,SACD,mBAAA,GAAsB,MAAA;IAC7B,SAAA;IACA,QAAA;IACA,MAAA,EAAQ,YAAA;EAAA,MACJ,aAAA;EAAA,SACG,sBAAA,GAAyB,MAAA;IAAA,SACvB,SAAA;IAAA,SACA,QAAA;IAAA,SACA,MAAA,EAAQ,YAAA;IAAA,SACR,cAAA,EAAgB,cAAA;IAAA,SAChB,WAAA;IAAA,SACA,OAAA;IAAA,SACA,kBAAA;IAAA,SACA,aAAA;EAAA,MACL,gBAAA;EAAA,SACG,iBAAA;EAAA,SACA,mBAAA;AAAA;AAAA,iBAGK,0BAAA,CAAA,GAA8B,uBAAA;;;cCjBjC,sBAAA,GAA0B,KAAA;AAAA,cAI1B,uBAAA,GAA2B,KAAA;;;KChB5B,yBAAA;EAAA,SACD,WAAA;AAAA;AAAA,iBAMK,kBAAA,CACd,IAAA,sBACA,OAAA,GAAS,yBAAA;;;iBCPK,QAAA,CAAS,IAAA,UAAc,EAAA;;;cCA1B,kBAAA,GAAsB,IAAA;AAAA,cAUtB,qBAAA,GAAyB,IAAA;;;;;;ArBZtC;csBoBa,iBAAA,GAAqB,MAAA;;;;;;;;;cA4BrB,aAAA,GACX,CAAA;EAAK,MAAA;EAAgB,IAAA;AAAA,GACrB,CAAA;EAAK,MAAA;EAAgB,IAAA;AAAA;;;iBCjCP,cAAA,CACd,QAAA,UACA,IAAA,EAAM,MAAA"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/errors/DerivedResponseCycleError.ts","../src/errors/DuplicateOperationIdError.ts","../src/errors/DuplicateRouteError.ts","../src/errors/EmptyOperationResponsesError.ts","../src/errors/EmptyResourceOperationsError.ts","../src/errors/EmptySpecResourcesError.ts","../src/errors/InvalidDerivedResponseError.ts","../src/errors/InvalidOperationIdError.ts","../src/NormalizedSpec.ts","../src/errors/InvalidRequestSchemaError.ts","../src/errors/InvalidResourceNameError.ts","../src/errors/MissingDerivedResponseParentError.ts","../src/errors/PathParameterMismatchError.ts","../src/normalizeSpec.ts","../src/plugins/types.ts","../src/plugins/BasePlugin.ts","../src/plugins/pluginRegistry.ts","../src/plugins/pluginContext.ts","../src/helpers/namingUtils.ts","../src/helpers/jsdoc.ts","../src/helpers/path.ts","../src/helpers/routePath.ts","../src/helpers/routeSort.ts","../src/helpers/templateEngine.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -44,6 +44,28 @@ declare class InvalidOperationIdError extends Error {
 type NormalizedSpec = {
   readonly resources: readonly NormalizedResource[];
   readonly responses: readonly NormalizedResponse[];
+  readonly warnings: readonly NormalizedSpecWarning[];
+};
+type NormalizedBodyMediaTypeSource = "content-type-header" | "body-schema" | "raw-fallback";
+type NormalizedBodyTransport = "json" | "text" | "form-url-encoded" | "multipart" | "raw";
+type NormalizedHttpBody = {
+  readonly schema: HttpBodySchema;
+  readonly mediaType: string;
+  readonly mediaTypeSource: NormalizedBodyMediaTypeSource;
+  readonly transport: NormalizedBodyTransport;
+};
+type NormalizedSpecWarningCode = "ambiguous-content-type-header" | "missing-content-type-header" | "raw-body-media-type-fallback";
+type NormalizedSpecWarningLocation = {
+  readonly part: "request.body" | "response.body";
+  readonly resourceName?: string;
+  readonly operationId?: string;
+  readonly responseName?: string;
+  readonly statusCode?: HttpStatusCode;
+};
+type NormalizedSpecWarning = {
+  readonly code: NormalizedSpecWarningCode;
+  readonly message: string;
+  readonly location: NormalizedSpecWarningLocation;
 };
 type NormalizedResource = {
   readonly name: string;
@@ -61,7 +83,7 @@ type NormalizedRequest = {
   readonly header?: HttpHeaderSchema;
   readonly param?: HttpParamSchema;
   readonly query?: HttpQuerySchema;
-  readonly body?: HttpBodySchema;
+  readonly body?: NormalizedHttpBody;
 };
 type NormalizedResponse = {
   readonly name: string;
@@ -69,7 +91,7 @@ type NormalizedResponse = {
   readonly statusCodeName: string;
   readonly description: string;
   readonly header?: HttpHeaderSchema;
-  readonly body?: HttpBodySchema;
+  readonly body?: NormalizedHttpBody;
   readonly kind: "response" | "derived-response";
   readonly derivedFrom?: string;
   readonly lineage?: readonly string[];
@@ -347,5 +369,5 @@ declare const compareRoutes: (a: {
 //#region src/helpers/templateEngine.d.ts
 declare function renderTemplate(template: string, data: Record<string, unknown>): string;
 //#endregion
-export { BasePlugin, CreateJSDocCommentOptions, DerivedResponseCycleError, DuplicateOperationIdError, DuplicateRouteError, EmptyOperationResponsesError, EmptyResourceOperationsError, EmptySpecResourcesError, GeneratorContext, InvalidDerivedResponseError, InvalidOperationIdError, InvalidRequestSchemaError, InvalidResourceNameError, MissingDerivedResponseParentError, NormalizedCanonicalResponseUsage, NormalizedInlineResponseUsage, NormalizedOperation, NormalizedRequest, NormalizedResource, NormalizedResponse, NormalizedResponseUsage, NormalizedSpec, OperationOutputPaths, PathParameterMismatchError, PluginConfig, PluginConstructor, PluginContext, type PluginContextBuilderApi, PluginDependencyError, PluginLoadError, PluginMetadata, PluginModule, PluginRegistration, type PluginRegistryApi, TypeweaverConfig, TypeweaverPlugin, compareRoutes, createJSDocComment, createPluginContextBuilder, createPluginRegistry, getMethodPriority, getPathParameterNames, isSupportedOperationId, isSupportedResourceName, normalizeRoutePath, normalizeSpec, relative, renderTemplate };
+export { BasePlugin, CreateJSDocCommentOptions, DerivedResponseCycleError, DuplicateOperationIdError, DuplicateRouteError, EmptyOperationResponsesError, EmptyResourceOperationsError, EmptySpecResourcesError, GeneratorContext, InvalidDerivedResponseError, InvalidOperationIdError, InvalidRequestSchemaError, InvalidResourceNameError, MissingDerivedResponseParentError, NormalizedBodyMediaTypeSource, NormalizedBodyTransport, NormalizedCanonicalResponseUsage, NormalizedHttpBody, NormalizedInlineResponseUsage, NormalizedOperation, NormalizedRequest, NormalizedResource, NormalizedResponse, NormalizedResponseUsage, NormalizedSpec, NormalizedSpecWarning, NormalizedSpecWarningCode, NormalizedSpecWarningLocation, OperationOutputPaths, PathParameterMismatchError, PluginConfig, PluginConstructor, PluginContext, type PluginContextBuilderApi, PluginDependencyError, PluginLoadError, PluginMetadata, PluginModule, PluginRegistration, type PluginRegistryApi, TypeweaverConfig, TypeweaverPlugin, compareRoutes, createJSDocComment, createPluginContextBuilder, createPluginRegistry, getMethodPriority, getPathParameterNames, isSupportedOperationId, isSupportedResourceName, normalizeRoutePath, normalizeSpec, relative, renderTemplate };
 //# sourceMappingURL=index.d.mts.map