@workos/oagen 0.10.4 → 0.12.0

package/README.md

@@ -196,6 +196,11 @@ export default {
     Connections: 'SSO',           // All Connections ops mount on SSO
     DirectoryGroups: 'DirectorySync',
   },
+  modelHints: {
+    // Pin a model's placement when "first service to reference it wins"
+    // would otherwise drift as the spec evolves.
+    User: 'UserManagementUsers',
+  },
 };
 ```
 

package/dist/cli/index.mjs

@@ -4700,6 +4700,7 @@ function buildEmitterContext(spec, options) {
 		apiSurface: options.apiSurface,
 		overlayLookup: options.overlayLookup,
 		resolvedOperations: resolveOperations(spec, options.operationHints, options.mountRules),
+		modelHints: options.modelHints,
 		targetDir: options.target,
 		priorTargetManifestPaths: options.priorTargetManifestPaths
 	};
@@ -5932,6 +5933,7 @@ async function generateCommand(opts) {
 		overlayLookup,
 		operationHints: opts.operationHints,
 		mountRules: opts.mountRules,
+		modelHints: opts.modelHints,
 		noPrune: opts.prune === false
 	});
 	if (opts.dryRun) for (const f of files) console.log(f.path);
@@ -6427,7 +6429,8 @@ function apiSurfaceToSnapshot(surface) {
 			displayName: className,
 			visibility: "public",
 			stability: cls.deprecationMessage ? "deprecated" : "stable",
-			sourceKind: "generated_service_wrapper"
+			sourceKind: "generated_service_wrapper",
+			...cls.sourceFile ? { sourceFile: cls.sourceFile } : {}
 		});
 		if (cls.constructorParams.length > 0) symbols.push({
 			id: `ctor:${className}`,
@@ -6438,7 +6441,8 @@ function apiSurfaceToSnapshot(surface) {
 			visibility: "public",
 			stability: "stable",
 			sourceKind: "generated_resource_constructor",
-			parameters: cls.constructorParams.map((p, i) => apiParamToCompatParam(p, i, language))
+			parameters: cls.constructorParams.map((p, i) => apiParamToCompatParam(p, i, language)),
+			...cls.sourceFile ? { sourceFile: cls.sourceFile } : {}
 		});
 		for (const [methodName, overloads] of Object.entries(cls.methods)) for (let oi = 0; oi < overloads.length; oi++) {
 			const method = overloads[oi];
@@ -6453,7 +6457,8 @@ function apiSurfaceToSnapshot(surface) {
 				stability: "stable",
 				sourceKind: "generated_service_wrapper",
 				parameters: method.params.map((p, i) => apiParamToCompatParam(p, i, language)),
-				returns: { name: method.returnType }
+				returns: { name: method.returnType },
+				...cls.sourceFile ? { sourceFile: cls.sourceFile } : {}
 			});
 		}
 		for (const [propName, prop] of Object.entries(cls.properties)) symbols.push({
@@ -6465,7 +6470,8 @@ function apiSurfaceToSnapshot(surface) {
 			visibility: "public",
 			stability: "stable",
 			sourceKind: "generated_service_wrapper",
-			typeRef: { name: prop.type }
+			typeRef: { name: prop.type },
+			...cls.sourceFile ? { sourceFile: cls.sourceFile } : {}
 		});
 	}
 	for (const [ifaceName, iface] of Object.entries(surface.interfaces)) {
@@ -6476,7 +6482,8 @@ function apiSurfaceToSnapshot(surface) {
 			displayName: ifaceName,
 			visibility: "public",
 			stability: "stable",
-			sourceKind: "generated_resource_constructor"
+			sourceKind: "generated_resource_constructor",
+			...iface.sourceFile ? { sourceFile: iface.sourceFile } : {}
 		});
 		for (const [fieldName, field] of Object.entries(iface.fields)) symbols.push({
 			id: `field:${ifaceName}.${fieldName}`,
@@ -6487,7 +6494,8 @@ function apiSurfaceToSnapshot(surface) {
 			visibility: "public",
 			stability: "stable",
 			sourceKind: "generated_resource_constructor",
-			typeRef: { name: field.type }
+			typeRef: { name: field.type },
+			...iface.sourceFile ? { sourceFile: iface.sourceFile } : {}
 		});
 		if (iface.hasCustomConstructor) symbols.push({
 			id: `ctor:${ifaceName}`,
@@ -6497,17 +6505,19 @@ function apiSurfaceToSnapshot(surface) {
 			displayName: `new ${ifaceName}`,
 			visibility: "public",
 			stability: "stable",
-			sourceKind: "generated_resource_constructor"
+			sourceKind: "generated_resource_constructor",
+			...iface.sourceFile ? { sourceFile: iface.sourceFile } : {}
 		});
 	}
-	for (const [aliasName] of Object.entries(surface.typeAliases)) symbols.push({
+	for (const [aliasName, alias] of Object.entries(surface.typeAliases)) symbols.push({
 		id: `alias:${aliasName}`,
 		kind: "alias",
 		fqName: aliasName,
 		displayName: aliasName,
 		visibility: "public",
 		stability: "stable",
-		sourceKind: "generated_resource_constructor"
+		sourceKind: "generated_resource_constructor",
+		...alias.sourceFile ? { sourceFile: alias.sourceFile } : {}
 	});
 	for (const [enumName, enumDef] of Object.entries(surface.enums)) {
 		symbols.push({
@@ -6517,7 +6527,8 @@ function apiSurfaceToSnapshot(surface) {
 			displayName: enumName,
 			visibility: "public",
 			stability: "stable",
-			sourceKind: "generated_enum"
+			sourceKind: "generated_enum",
+			...enumDef.sourceFile ? { sourceFile: enumDef.sourceFile } : {}
 		});
 		for (const [memberName, memberValue] of Object.entries(enumDef.members)) symbols.push({
 			id: `enum_member:${enumName}.${memberName}`,
@@ -6528,7 +6539,8 @@ function apiSurfaceToSnapshot(surface) {
 			visibility: "public",
 			stability: "stable",
 			sourceKind: "generated_enum",
-			value: memberValue
+			value: memberValue,
+			...enumDef.sourceFile ? { sourceFile: enumDef.sourceFile } : {}
 		});
 	}
 	return {
@@ -8368,6 +8380,7 @@ let configSchemaNameTransform;
 let configDocUrl;
 let configOperationHints;
 let configMountRules;
+let configModelHints;
 let configCompat;
 try {
 	const config = await loadConfig(explicitConfigPath);
@@ -8379,6 +8392,7 @@ try {
 		configDocUrl = config.docUrl;
 		configOperationHints = config.operationHints;
 		configMountRules = config.mountRules;
+		configModelHints = config.modelHints;
 		configCompat = config.compat;
 	}
 } catch (err) {
@@ -8405,7 +8419,8 @@ program.command("generate").description("Run a registered emitter against an Ope
 		schemaNameTransform: configSchemaNameTransform,
 		docUrl: configDocUrl,
 		operationHints: configOperationHints,
-		mountRules: configMountRules
+		mountRules: configMountRules,
+		modelHints: configModelHints
 	}).catch(handleError);
 });
 program.command("diff").description("Compare two OpenAPI specs and output a diff report").requiredOption("--old <path>", "Path to old spec").requiredOption("--new <path>", "Path to new spec").action((opts) => {