@postman/sdk-config 0.17.0 → 0.19.1
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.
- package/README.md +1 -1
- package/dist/index.cjs +90 -12
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +90 -13
- package/dist/index.js.map +1 -1
- package/dist/sdk-config/index.cjs +80 -10
- package/dist/sdk-config/index.cjs.map +1 -1
- package/dist/sdk-config/index.d.cts +1 -1
- package/dist/sdk-config/index.d.ts +1 -1
- package/dist/sdk-config/index.js +80 -11
- package/dist/sdk-config/index.js.map +1 -1
- package/dist/sdk-config/v1/index.cjs +80 -10
- package/dist/sdk-config/v1/index.cjs.map +1 -1
- package/dist/sdk-config/v1/index.d.cts +6640 -818
- package/dist/sdk-config/v1/index.d.ts +6640 -818
- package/dist/sdk-config/v1/index.js +80 -11
- package/dist/sdk-config/v1/index.js.map +1 -1
- package/dist/sdk-config-ir/index.cjs +10 -2
- package/dist/sdk-config-ir/index.cjs.map +1 -1
- package/dist/sdk-config-ir/index.js +10 -2
- package/dist/sdk-config-ir/index.js.map +1 -1
- package/dist/sdk-config-ir/v1/index.cjs +10 -2
- package/dist/sdk-config-ir/v1/index.cjs.map +1 -1
- package/dist/sdk-config-ir/v1/index.d.cts +1040 -2
- package/dist/sdk-config-ir/v1/index.d.ts +1040 -2
- package/dist/sdk-config-ir/v1/index.js +10 -2
- package/dist/sdk-config-ir/v1/index.js.map +1 -1
- package/package.json +2 -2
- package/src/sdk-config/v1/README.md +22 -0
|
@@ -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",
|
|
@@ -2423,6 +2444,12 @@ var zipOutputSchema = z.strictObject({
|
|
|
2423
2444
|
fileName: nonEmptyStringSchema.optional().describe("The generated ZIP archive file name."),
|
|
2424
2445
|
publish: sdkConfigV1PublishConfigSchema.optional().describe("Optional package registry publication.")
|
|
2425
2446
|
});
|
|
2447
|
+
var localAliasOutputSchema = zipOutputSchema.extend({
|
|
2448
|
+
delivery: z.literal("local").describe('Alias of "zip": the package on the local machine.')
|
|
2449
|
+
}).transform(normalizeLocalDelivery);
|
|
2450
|
+
function normalizeLocalDelivery(output) {
|
|
2451
|
+
return { ...output, delivery: "zip" };
|
|
2452
|
+
}
|
|
2426
2453
|
var githubDeliverySchema = z.strictObject({
|
|
2427
2454
|
delivery: z.literal("github").describe("Delivers the generated SDK to GitHub."),
|
|
2428
2455
|
github: githubOutputSchema.describe("GitHub repository delivery settings."),
|
|
@@ -2430,8 +2457,25 @@ var githubDeliverySchema = z.strictObject({
|
|
|
2430
2457
|
});
|
|
2431
2458
|
var sdkConfigV1OutputConfigSchema = z.discriminatedUnion(
|
|
2432
2459
|
"delivery",
|
|
2433
|
-
[filesOutputSchema, zipOutputSchema, githubDeliverySchema],
|
|
2434
|
-
{ error: 'output.delivery must be one of "files", "zip", or "github"' }
|
|
2460
|
+
[filesOutputSchema, zipOutputSchema, githubDeliverySchema, localAliasOutputSchema],
|
|
2461
|
+
{ error: 'output.delivery must be one of "files", "zip", "local", or "github"' }
|
|
2462
|
+
);
|
|
2463
|
+
var hostedOutputSchema = z.strictObject({
|
|
2464
|
+
delivery: z.literal("hosted").describe("Deploys the generated MCP server to Fern-hosted infrastructure."),
|
|
2465
|
+
slug: nonEmptyStringSchema.describe(
|
|
2466
|
+
"The server slug. The hosted URL is https://{organization}.fernmcp.dev/{slug}. May be an environment expression that resolves to the slug."
|
|
2467
|
+
)
|
|
2468
|
+
});
|
|
2469
|
+
var sdkConfigV1McpOutputConfigSchema = z.discriminatedUnion(
|
|
2470
|
+
"delivery",
|
|
2471
|
+
[
|
|
2472
|
+
filesOutputSchema,
|
|
2473
|
+
zipOutputSchema,
|
|
2474
|
+
githubDeliverySchema,
|
|
2475
|
+
hostedOutputSchema,
|
|
2476
|
+
localAliasOutputSchema
|
|
2477
|
+
],
|
|
2478
|
+
{ error: 'output.delivery must be one of "files", "zip", "local", "github", or "hosted"' }
|
|
2435
2479
|
);
|
|
2436
2480
|
var cliDistributionShape = {
|
|
2437
2481
|
distribution: cliDistributionConfigSchema.optional().describe(
|
|
@@ -2452,9 +2496,10 @@ var sdkConfigV1CliOutputConfigSchema = z.discriminatedUnion(
|
|
|
2452
2496
|
[
|
|
2453
2497
|
filesOutputSchema.extend(cliDistributionShape).superRefine(rejectDistributionWithoutGithub),
|
|
2454
2498
|
zipOutputSchema.extend(cliDistributionShape).superRefine(rejectDistributionWithoutGithub),
|
|
2455
|
-
githubDeliverySchema.extend(cliDistributionShape)
|
|
2499
|
+
githubDeliverySchema.extend(cliDistributionShape),
|
|
2500
|
+
localAliasOutputSchema.in.extend(cliDistributionShape).superRefine(rejectDistributionWithoutGithub).transform(normalizeLocalDelivery)
|
|
2456
2501
|
],
|
|
2457
|
-
{ error: 'output.delivery must be one of "files", "zip", or "github"' }
|
|
2502
|
+
{ error: 'output.delivery must be one of "files", "zip", "local", or "github"' }
|
|
2458
2503
|
);
|
|
2459
2504
|
var sdkConfigV1ReplayConfigSchema = z.strictObject({
|
|
2460
2505
|
enabled: z.boolean().describe("Whether regeneration reapplies customer-authored repository changes.")
|
|
@@ -2870,7 +2915,10 @@ var sdkConfigV1TargetSchema = z.discriminatedUnion("language", [
|
|
|
2870
2915
|
z.strictObject({
|
|
2871
2916
|
language: z.literal("mcp").describe("Generates an MCP server."),
|
|
2872
2917
|
generation: sdkConfigV1GenerationConfigOverrideSchema.extend(mcpGenerationConfigSchema.shape).optional().describe("Common and MCP-specific generation settings for this target."),
|
|
2873
|
-
...targetOverrideShape
|
|
2918
|
+
...targetOverrideShape,
|
|
2919
|
+
output: sdkConfigV1McpOutputConfigSchema.optional().describe(
|
|
2920
|
+
"Output configuration, including Fern-hosted deployment, that replaces the root output for this target."
|
|
2921
|
+
)
|
|
2874
2922
|
}),
|
|
2875
2923
|
z.strictObject({
|
|
2876
2924
|
language: z.literal("terraform").describe("Generates a Terraform provider."),
|
|
@@ -2947,7 +2995,7 @@ function validateTargetPublishing(target, targetIndex, globalPackage, globalOutp
|
|
|
2947
2995
|
});
|
|
2948
2996
|
return;
|
|
2949
2997
|
}
|
|
2950
|
-
if (!output.publish) {
|
|
2998
|
+
if (output.delivery === "hosted" || !output.publish) {
|
|
2951
2999
|
return;
|
|
2952
3000
|
}
|
|
2953
3001
|
const registry = output.publish.registry;
|
|
@@ -3065,6 +3113,22 @@ function mapFernConfigToSdkConfigV1(input) {
|
|
|
3065
3113
|
const docs = partitionSharedBlock(mapped.map(({ docs: docs2 }) => docs2));
|
|
3066
3114
|
const generations = partitionSharedBlock(mapped.map(({ invocation }) => invocation.generation));
|
|
3067
3115
|
const api = { ...input.api ?? {} };
|
|
3116
|
+
const mcpBaseUrlIndex = mapped.findIndex(({ invocation }) => invocation.apiBaseUrl !== void 0);
|
|
3117
|
+
const mcpBaseUrl = mapped[mcpBaseUrlIndex]?.invocation.apiBaseUrl;
|
|
3118
|
+
const apiDiagnostics = [];
|
|
3119
|
+
if (mcpBaseUrl !== void 0) {
|
|
3120
|
+
if (api.baseUrl !== void 0 && api.baseUrl !== "" && api.baseUrl !== mcpBaseUrl) {
|
|
3121
|
+
apiDiagnostics.push({
|
|
3122
|
+
code: "FERN_MCP_BASE_URL_REPLACES_API_BASE_URL",
|
|
3123
|
+
severity: "warning",
|
|
3124
|
+
path: ["group", "generators", mcpBaseUrlIndex, "config", "baseUrl"],
|
|
3125
|
+
reason: `The MCP generator baseUrl "${mcpBaseUrl}" replaced the API base URL "${api.baseUrl}"`,
|
|
3126
|
+
sdkConfigPath: ["api", "baseUrl"],
|
|
3127
|
+
suggestedAction: "Check api.baseUrl in the migrated SDK Config. Remove the MCP baseUrl to keep the API base URL."
|
|
3128
|
+
});
|
|
3129
|
+
}
|
|
3130
|
+
api.baseUrl = mcpBaseUrl;
|
|
3131
|
+
}
|
|
3068
3132
|
delete api.audiences;
|
|
3069
3133
|
if (input.group.audiences.type === "select") {
|
|
3070
3134
|
api.audiences = [...input.group.audiences.audiences];
|
|
@@ -3165,10 +3229,13 @@ function mapFernConfigToSdkConfigV1(input) {
|
|
|
3165
3229
|
const validatedSdkConfig = sdkConfig;
|
|
3166
3230
|
return {
|
|
3167
3231
|
sdkConfig: validatedSdkConfig,
|
|
3168
|
-
unsupportedFields:
|
|
3169
|
-
...
|
|
3170
|
-
...unsupportedFields
|
|
3171
|
-
|
|
3232
|
+
unsupportedFields: [
|
|
3233
|
+
...apiDiagnostics,
|
|
3234
|
+
...mapped.flatMap(({ invocation, unsupportedFields }) => [
|
|
3235
|
+
...invocation.unsupportedFields,
|
|
3236
|
+
...unsupportedFields
|
|
3237
|
+
])
|
|
3238
|
+
]
|
|
3172
3239
|
};
|
|
3173
3240
|
}
|
|
3174
3241
|
function withRustCratesPublishDefaults(packageConfig, { language, output, generator }) {
|
|
@@ -3301,6 +3368,7 @@ function mapInvocation(generator, language, activeLanguages, index) {
|
|
|
3301
3368
|
...optional("smartCasingDigitWordBoundary", smartCasingDigitWordBoundary)
|
|
3302
3369
|
};
|
|
3303
3370
|
}
|
|
3371
|
+
const apiBaseUrl = language === "mcp" && activeLanguages.size === 1 ? takeString(config, ["baseUrl"], state, [...prefix, "config"]) : void 0;
|
|
3304
3372
|
const targetGeneration = mapLanguageConfig(
|
|
3305
3373
|
language,
|
|
3306
3374
|
config,
|
|
@@ -3345,6 +3413,7 @@ function mapInvocation(generator, language, activeLanguages, index) {
|
|
|
3345
3413
|
package: packageConfig,
|
|
3346
3414
|
packageFallbacks: state.packageFallbacks ?? [],
|
|
3347
3415
|
...optional("cliDistribution", state.cliDistribution),
|
|
3416
|
+
...optional("apiBaseUrl", apiBaseUrl),
|
|
3348
3417
|
targetGeneration,
|
|
3349
3418
|
unsupportedFields
|
|
3350
3419
|
};
|
|
@@ -4262,6 +4331,6 @@ function takeToolsets(value, aliases, state, basePath) {
|
|
|
4262
4331
|
return Object.fromEntries(entries.filter((entry) => entry !== void 0));
|
|
4263
4332
|
}
|
|
4264
4333
|
|
|
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 };
|
|
4334
|
+
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
4335
|
//# sourceMappingURL=index.js.map
|
|
4267
4336
|
//# sourceMappingURL=index.js.map
|