@workos/oagen 0.18.0 → 0.18.1

package/dist/smoke.mjs

@@ -1760,7 +1760,7 @@ const HTTP_METHODS = [
 	"options",
 	"trace"
 ];
-function extractOperations(paths, operationIdTransform) {
+function extractOperations(paths, operationIdTransform, componentSchemas) {
 	if (!paths) return {
 		services: [],
 		inlineModels: []
@@ -1773,7 +1773,7 @@ function extractOperations(paths, operationIdTransform) {
 			const op = pathItem[method];
 			if (!op) continue;
 			const serviceName = inferServiceName(path, op.tags?.[0]);
-			const { operation, inlineModels: opModels } = buildOperation(method, path, op, pathLevelParams, operationIdTransform, serviceName);
+			const { operation, inlineModels: opModels } = buildOperation(method, path, op, pathLevelParams, operationIdTransform, serviceName, componentSchemas);
 			inlineModels.push(...opModels);
 			const ops = serviceMap.get(serviceName) ?? [];
 			ops.push(operation);
@@ -2016,14 +2016,14 @@ function extractBodyParameterGroups(op, operationContext) {
 	}
 	return groups.length > 0 ? groups : void 0;
 }
-function buildOperation(method, path, op, pathLevelParams, operationIdTransform, serviceName) {
+function buildOperation(method, path, op, pathLevelParams, operationIdTransform, serviceName, componentSchemas) {
 	const allParams = [...pathLevelParams, ...op.parameters ?? []];
 	const hasIdempotencyHeader = allParams.some((p) => p.in === "header" && p.name.toLowerCase() === "idempotency-key");
 	const opContext = serviceName;
-	const pathParams = extractParams(allParams, "path", opContext);
-	const queryParams = extractParams(allParams, "query", opContext);
-	const headerParams = extractParams(allParams, "header", opContext).filter((p) => p.name.toLowerCase() !== "idempotency-key");
-	const cookieParams = extractParams(allParams, "cookie", opContext);
+	const pathParams = extractParams(allParams, "path", opContext, componentSchemas);
+	const queryParams = extractParams(allParams, "query", opContext, componentSchemas);
+	const headerParams = extractParams(allParams, "header", opContext, componentSchemas).filter((p) => p.name.toLowerCase() !== "idempotency-key");
+	const cookieParams = extractParams(allParams, "cookie", opContext, componentSchemas);
 	const reqBodyModels = [];
 	const { body: requestBody, encoding: requestBodyEncoding } = extractRequestBody(op.requestBody, op, reqBodyModels);
 	const { response, successResponses, errors, inlineModels, isPaginated, dataPath: responseDataPath, itemType: responseItemType } = extractResponses(op.responses, op, path, method);
@@ -2095,21 +2095,42 @@ function buildDescription(summary, description) {
 	if (summary && description && summary !== description) return `${summary}\n\n${description}`;
 	return description ?? summary;
 }
-function extractParams(params, location, operationContext) {
-	return params.filter((p) => p.in === location).map((p) => ({
-		name: p.name,
-		type: p.schema ? schemaToTypeRef(p.schema, p.name, operationContext ? toPascalCase(operationContext) : void 0) : {
-			kind: "primitive",
-			type: "string"
-		},
-		required: p.required ?? false,
-		description: p.description,
-		deprecated: p.deprecated || p.schema?.deprecated || void 0,
-		default: p.schema?.default,
-		example: p.example ?? p.schema?.example,
-		style: p.style,
-		explode: p.explode
-	}));
+function extractParams(params, location, operationContext, componentSchemas) {
+	return params.filter((p) => p.in === location).map((p) => {
+		const refTarget = resolveParamSchemaRef(p.schema, componentSchemas);
+		return {
+			name: p.name,
+			type: p.schema ? schemaToTypeRef(p.schema, p.name, operationContext ? toPascalCase(operationContext) : void 0) : {
+				kind: "primitive",
+				type: "string"
+			},
+			required: p.required ?? false,
+			description: p.description,
+			deprecated: p.deprecated || p.schema?.deprecated || refTarget?.deprecated || void 0,
+			default: p.schema?.default ?? refTarget?.default,
+			example: p.example ?? p.schema?.example ?? refTarget?.example,
+			style: p.style,
+			explode: p.explode
+		};
+	});
+}
+/**
+* If a parameter's schema is a `$ref` to `#/components/schemas/X`, return the
+* referenced component schema. Used to surface schema-level metadata (default,
+* example, deprecated) that wouldn't otherwise be visible at the param level.
+*
+* Refs are not pre-resolved by the bundler (`dereference: false` in refs.ts),
+* so without this, a param like `schema: { $ref: '.../PaginationOrder' }`
+* silently loses the target's `default: desc` and the SDK stops emitting the
+* spec-mandated default value in generated method signatures.
+*/
+function resolveParamSchemaRef(schema, componentSchemas) {
+	if (!schema || !componentSchemas) return void 0;
+	const ref = schema.$ref;
+	if (!ref) return void 0;
+	const match = /^#\/components\/schemas\/(.+)$/.exec(ref);
+	if (!match) return void 0;
+	return componentSchemas[match[1]];
 }
 function extractRequestBody(body, op, inlineModels) {
 	if (!body?.content) return {};
@@ -2463,7 +2484,7 @@ async function parseSpec(specPath, options) {
 	const version = spec.openapi ?? "";
 	if (!version.startsWith("3.")) throw new SpecParseError(`Unsupported OpenAPI version: ${version}. oagen requires OpenAPI 3.x`, `Update the spec to OpenAPI 3.0 or 3.1. If you are using Swagger 2.x, convert it first with \`npx swagger2openapi ${specPath}\`.`);
 	const { models, enums } = extractSchemas(spec.components?.schemas, { schemaNameTransform: options?.schemaNameTransform });
-	const { services, inlineModels } = extractOperations(spec.paths, options?.operationIdTransform);
+	const { services, inlineModels } = extractOperations(spec.paths, options?.operationIdTransform, spec.components?.schemas);
 	clearSchemaNameTransform();
 	const finalModels = collapseJsonSuffixModels(mergeFieldInlineModels(mergeInlineResponseModels(models, inlineModels), extractInlineModelsFromSchemas(spec.components?.schemas)), services);
 	collectInlineEnumsFromModels(finalModels, enums);