@postman/sdk-config 0.17.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1116,6 +1116,27 @@ function mapOutput(generator, language, index) {
1116
1116
  language
1117
1117
  );
1118
1118
  }
1119
+ if (language === "mcp" && rawOutput?.location === "fern-hosted") {
1120
+ const slug = rawOutput.slug;
1121
+ if (typeof slug !== "string" || slug === "") {
1122
+ fail(
1123
+ "FERN_HOSTED_SLUG_REQUIRED",
1124
+ ["group", "generators", index, "output", "slug"],
1125
+ `Fern generator ${generator.name} uses output.location "fern-hosted" without a slug`,
1126
+ 'Set output.slug on the generator, or set target.output manually with delivery "hosted" and a slug.',
1127
+ ["targets", index, "output", "slug"]
1128
+ );
1129
+ }
1130
+ if (isObject(generator.outputMode)) consume(state, [...outputPath, "type"]);
1131
+ return finishOutputMapping(
1132
+ { output: { delivery: "hosted", slug } },
1133
+ generator.outputMode,
1134
+ outputPath,
1135
+ state,
1136
+ index,
1137
+ language
1138
+ );
1139
+ }
1119
1140
  if (!isObject(generator.outputMode) || typeof generator.outputMode.type !== "string") {
1120
1141
  fail(
1121
1142
  "FERN_OUTPUT_REQUIRED",
@@ -2433,6 +2454,17 @@ var sdkConfigV1OutputConfigSchema = z.discriminatedUnion(
2433
2454
  [filesOutputSchema, zipOutputSchema, githubDeliverySchema],
2434
2455
  { error: 'output.delivery must be one of "files", "zip", or "github"' }
2435
2456
  );
2457
+ var hostedOutputSchema = z.strictObject({
2458
+ delivery: z.literal("hosted").describe("Deploys the generated MCP server to Fern-hosted infrastructure."),
2459
+ slug: nonEmptyStringSchema.describe(
2460
+ "The server slug. The hosted URL is https://{organization}.fernmcp.dev/{slug}. May be an environment expression that resolves to the slug."
2461
+ )
2462
+ });
2463
+ var sdkConfigV1McpOutputConfigSchema = z.discriminatedUnion(
2464
+ "delivery",
2465
+ [filesOutputSchema, zipOutputSchema, githubDeliverySchema, hostedOutputSchema],
2466
+ { error: 'output.delivery must be one of "files", "zip", "github", or "hosted"' }
2467
+ );
2436
2468
  var cliDistributionShape = {
2437
2469
  distribution: cliDistributionConfigSchema.optional().describe(
2438
2470
  "CLI release channels and build attestation settings for the generated release workflow; credentials are GitHub Actions secret names."
@@ -2870,7 +2902,10 @@ var sdkConfigV1TargetSchema = z.discriminatedUnion("language", [
2870
2902
  z.strictObject({
2871
2903
  language: z.literal("mcp").describe("Generates an MCP server."),
2872
2904
  generation: sdkConfigV1GenerationConfigOverrideSchema.extend(mcpGenerationConfigSchema.shape).optional().describe("Common and MCP-specific generation settings for this target."),
2873
- ...targetOverrideShape
2905
+ ...targetOverrideShape,
2906
+ output: sdkConfigV1McpOutputConfigSchema.optional().describe(
2907
+ "Output configuration, including Fern-hosted deployment, that replaces the root output for this target."
2908
+ )
2874
2909
  }),
2875
2910
  z.strictObject({
2876
2911
  language: z.literal("terraform").describe("Generates a Terraform provider."),
@@ -2947,7 +2982,7 @@ function validateTargetPublishing(target, targetIndex, globalPackage, globalOutp
2947
2982
  });
2948
2983
  return;
2949
2984
  }
2950
- if (!output.publish) {
2985
+ if (output.delivery === "hosted" || !output.publish) {
2951
2986
  return;
2952
2987
  }
2953
2988
  const registry = output.publish.registry;
@@ -3065,6 +3100,22 @@ function mapFernConfigToSdkConfigV1(input) {
3065
3100
  const docs = partitionSharedBlock(mapped.map(({ docs: docs2 }) => docs2));
3066
3101
  const generations = partitionSharedBlock(mapped.map(({ invocation }) => invocation.generation));
3067
3102
  const api = { ...input.api ?? {} };
3103
+ const mcpBaseUrlIndex = mapped.findIndex(({ invocation }) => invocation.apiBaseUrl !== void 0);
3104
+ const mcpBaseUrl = mapped[mcpBaseUrlIndex]?.invocation.apiBaseUrl;
3105
+ const apiDiagnostics = [];
3106
+ if (mcpBaseUrl !== void 0) {
3107
+ if (api.baseUrl !== void 0 && api.baseUrl !== "" && api.baseUrl !== mcpBaseUrl) {
3108
+ apiDiagnostics.push({
3109
+ code: "FERN_MCP_BASE_URL_REPLACES_API_BASE_URL",
3110
+ severity: "warning",
3111
+ path: ["group", "generators", mcpBaseUrlIndex, "config", "baseUrl"],
3112
+ reason: `The MCP generator baseUrl "${mcpBaseUrl}" replaced the API base URL "${api.baseUrl}"`,
3113
+ sdkConfigPath: ["api", "baseUrl"],
3114
+ suggestedAction: "Check api.baseUrl in the migrated SDK Config. Remove the MCP baseUrl to keep the API base URL."
3115
+ });
3116
+ }
3117
+ api.baseUrl = mcpBaseUrl;
3118
+ }
3068
3119
  delete api.audiences;
3069
3120
  if (input.group.audiences.type === "select") {
3070
3121
  api.audiences = [...input.group.audiences.audiences];
@@ -3165,10 +3216,13 @@ function mapFernConfigToSdkConfigV1(input) {
3165
3216
  const validatedSdkConfig = sdkConfig;
3166
3217
  return {
3167
3218
  sdkConfig: validatedSdkConfig,
3168
- unsupportedFields: mapped.flatMap(({ invocation, unsupportedFields }) => [
3169
- ...invocation.unsupportedFields,
3170
- ...unsupportedFields
3171
- ])
3219
+ unsupportedFields: [
3220
+ ...apiDiagnostics,
3221
+ ...mapped.flatMap(({ invocation, unsupportedFields }) => [
3222
+ ...invocation.unsupportedFields,
3223
+ ...unsupportedFields
3224
+ ])
3225
+ ]
3172
3226
  };
3173
3227
  }
3174
3228
  function withRustCratesPublishDefaults(packageConfig, { language, output, generator }) {
@@ -3301,6 +3355,7 @@ function mapInvocation(generator, language, activeLanguages, index) {
3301
3355
  ...optional("smartCasingDigitWordBoundary", smartCasingDigitWordBoundary)
3302
3356
  };
3303
3357
  }
3358
+ const apiBaseUrl = language === "mcp" && activeLanguages.size === 1 ? takeString(config, ["baseUrl"], state, [...prefix, "config"]) : void 0;
3304
3359
  const targetGeneration = mapLanguageConfig(
3305
3360
  language,
3306
3361
  config,
@@ -3345,6 +3400,7 @@ function mapInvocation(generator, language, activeLanguages, index) {
3345
3400
  package: packageConfig,
3346
3401
  packageFallbacks: state.packageFallbacks ?? [],
3347
3402
  ...optional("cliDistribution", state.cliDistribution),
3403
+ ...optional("apiBaseUrl", apiBaseUrl),
3348
3404
  targetGeneration,
3349
3405
  unsupportedFields
3350
3406
  };
@@ -4262,6 +4318,6 @@ function takeToolsets(value, aliases, state, basePath) {
4262
4318
  return Object.fromEntries(entries.filter((entry) => entry !== void 0));
4263
4319
  }
4264
4320
 
4265
- export { FernConfigMappingError, CLI_DISTRIBUTION_NON_RELEASE_MODE_CODE as SDK_CONFIG_V1_CLI_DISTRIBUTION_NON_RELEASE_MODE_CODE, SDK_CONFIG_V1_SCHEMA_VERSION, getSdkConfigV1Diagnostics, mapFernConfigToSdkConfigV1, parseSdkConfigV1, parseSdkConfigV1ForConsumption, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, cliDistributionConfigSchema as sdkConfigV1CliDistributionConfigSchema, cliDistributionGithubAppSchema as sdkConfigV1CliDistributionGithubAppSchema, cliDistributionHomebrewSchema as sdkConfigV1CliDistributionHomebrewSchema, cliDistributionScoopSchema as sdkConfigV1CliDistributionScoopSchema, cliGenerationConfigSchema as sdkConfigV1CliGenerationConfigSchema, sdkConfigV1CliOutputConfigSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, composerPackageNameSchema as sdkConfigV1ComposerPackageNameSchema, csharpGenerationConfigSchema as sdkConfigV1CsharpGenerationConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, exactSemverSchema as sdkConfigV1ExactSemverSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, sdkConfigV1GitRemoteSchema, githubActionsSecretNameSchema as sdkConfigV1GithubActionsSecretNameSchema, goGenerationConfigSchema as sdkConfigV1GoGenerationConfigSchema, goModulePathSchema as sdkConfigV1GoModulePathSchema, javaGenerationConfigSchema as sdkConfigV1JavaGenerationConfigSchema, kotlinGenerationConfigSchema as sdkConfigV1KotlinGenerationConfigSchema, mcpGenerationConfigSchema as sdkConfigV1McpGenerationConfigSchema, nonEmptyStringSchema as sdkConfigV1NonEmptyStringSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, parentRelativePathSchema as sdkConfigV1ParentRelativePathSchema, phpGenerationConfigSchema as sdkConfigV1PhpGenerationConfigSchema, sdkConfigV1ProtobufRootSchema, sdkConfigV1ProtobufSourceSchema, sdkConfigV1PublishConfigSchema, sdkConfigV1PublishRegistrySchema, pythonGenerationConfigSchema as sdkConfigV1PythonGenerationConfigSchema, sdkConfigV1ReadmeCustomSectionSchema, sdkConfigV1ReadmeEndpointSchema, relativePathSchema as sdkConfigV1RelativePathSchema, sdkConfigV1ReplayConfigSchema, rubyGenerationConfigSchema as sdkConfigV1RubyGenerationConfigSchema, rustGenerationConfigSchema as sdkConfigV1RustGenerationConfigSchema, sdkConfigV1Schema, sdkConfigV1SourceConfigSchema, sdkConfigV1SourceSpecSchema, swiftGenerationConfigSchema as sdkConfigV1SwiftGenerationConfigSchema, sdkConfigV1TargetSchema, terraformGenerationConfigSchema as sdkConfigV1TerraformGenerationConfigSchema, typescriptGenerationConfigSchema as sdkConfigV1TypescriptGenerationConfigSchema, sdkConfigV1WebhookSignatureSchema, splitSdkConfigV1TargetGeneration, validateSdkConfigV1 };
4321
+ export { FernConfigMappingError, CLI_DISTRIBUTION_NON_RELEASE_MODE_CODE as SDK_CONFIG_V1_CLI_DISTRIBUTION_NON_RELEASE_MODE_CODE, SDK_CONFIG_V1_SCHEMA_VERSION, getSdkConfigV1Diagnostics, mapFernConfigToSdkConfigV1, parseSdkConfigV1, parseSdkConfigV1ForConsumption, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, cliDistributionConfigSchema as sdkConfigV1CliDistributionConfigSchema, cliDistributionGithubAppSchema as sdkConfigV1CliDistributionGithubAppSchema, cliDistributionHomebrewSchema as sdkConfigV1CliDistributionHomebrewSchema, cliDistributionScoopSchema as sdkConfigV1CliDistributionScoopSchema, cliGenerationConfigSchema as sdkConfigV1CliGenerationConfigSchema, sdkConfigV1CliOutputConfigSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, composerPackageNameSchema as sdkConfigV1ComposerPackageNameSchema, csharpGenerationConfigSchema as sdkConfigV1CsharpGenerationConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, exactSemverSchema as sdkConfigV1ExactSemverSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, sdkConfigV1GitRemoteSchema, githubActionsSecretNameSchema as sdkConfigV1GithubActionsSecretNameSchema, goGenerationConfigSchema as sdkConfigV1GoGenerationConfigSchema, goModulePathSchema as sdkConfigV1GoModulePathSchema, javaGenerationConfigSchema as sdkConfigV1JavaGenerationConfigSchema, kotlinGenerationConfigSchema as sdkConfigV1KotlinGenerationConfigSchema, mcpGenerationConfigSchema as sdkConfigV1McpGenerationConfigSchema, sdkConfigV1McpOutputConfigSchema, nonEmptyStringSchema as sdkConfigV1NonEmptyStringSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, parentRelativePathSchema as sdkConfigV1ParentRelativePathSchema, phpGenerationConfigSchema as sdkConfigV1PhpGenerationConfigSchema, sdkConfigV1ProtobufRootSchema, sdkConfigV1ProtobufSourceSchema, sdkConfigV1PublishConfigSchema, sdkConfigV1PublishRegistrySchema, pythonGenerationConfigSchema as sdkConfigV1PythonGenerationConfigSchema, sdkConfigV1ReadmeCustomSectionSchema, sdkConfigV1ReadmeEndpointSchema, relativePathSchema as sdkConfigV1RelativePathSchema, sdkConfigV1ReplayConfigSchema, rubyGenerationConfigSchema as sdkConfigV1RubyGenerationConfigSchema, rustGenerationConfigSchema as sdkConfigV1RustGenerationConfigSchema, sdkConfigV1Schema, sdkConfigV1SourceConfigSchema, sdkConfigV1SourceSpecSchema, swiftGenerationConfigSchema as sdkConfigV1SwiftGenerationConfigSchema, sdkConfigV1TargetSchema, terraformGenerationConfigSchema as sdkConfigV1TerraformGenerationConfigSchema, typescriptGenerationConfigSchema as sdkConfigV1TypescriptGenerationConfigSchema, sdkConfigV1WebhookSignatureSchema, splitSdkConfigV1TargetGeneration, validateSdkConfigV1 };
4266
4322
  //# sourceMappingURL=index.js.map
4267
4323
  //# sourceMappingURL=index.js.map