@postman/sdk-config 0.0.4 → 0.1.1

package/dist/sdk-config-ir/v1/index.cjs

@@ -7,8 +7,12 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var semver__default = /*#__PURE__*/_interopDefault(semver);
 
-// src/sdk-config-ir/v1/api.ts
+// src/sdk-config-domain/v1/api.ts
 var nonEmptyStringSchema = zod.z.string().min(1);
+var relativePathSchema = nonEmptyStringSchema.refine(
+  (value) => !/^(?:[\\/]|[A-Za-z]:)/.test(value) && !value.split(/[\\/]/).some((segment) => segment === ".."),
+  { message: "must be a relative path without parent directory segments" }
+);
 var exactSemverSchema = zod.z.string().refine(
   (value) => {
     if (value.trim() !== value || !/^\d/.test(value)) {
@@ -31,7 +35,7 @@ var jsonValueSchema = zod.z.lazy(
 );
 var jsonObjectSchema = zod.z.record(zod.z.string(), jsonValueSchema);
 
-// src/sdk-config-ir/v1/api.ts
+// src/sdk-config-domain/v1/api.ts
 var authVariableSchema = zod.z.strictObject({
   name: nonEmptyStringSchema.optional(),
   environmentVariable: nonEmptyStringSchema.optional(),
@@ -181,7 +185,14 @@ var apiConfigSchema = zod.z.strictObject({
   environmentVariables: zod.z.array(environmentVariableSchema).default([]),
   defaultEnvironment: nonEmptyStringSchema.optional(),
   auth: authConfigSchema.optional(),
-  headers: zod.z.array(headerSchema).optional()
+  headers: zod.z.array(headerSchema).optional(),
+  /**
+   * Selects the named `x-fern-audiences`.
+   *
+   * Absent means all audiences. A present empty array selects no tagged audience: untagged nodes
+   * remain included, while every audience-tagged node is excluded.
+   */
+  audiences: zod.z.array(nonEmptyStringSchema).optional()
 });
 var retryConfigSchema = zod.z.strictObject({
   enabled: zod.z.boolean().default(true),
@@ -235,6 +246,7 @@ var clientConfigSchema = zod.z.strictObject({
   pathParameterStyle: parameterStyleSchema.optional(),
   filePropertyStyle: parameterStyleSchema.optional(),
   useDefaultRequestParameterValues: zod.z.boolean().optional(),
+  respectOptionalRequestBody: zod.z.boolean().optional(),
   tokenRefresh: tokenRefreshConfigSchema.optional()
 });
 var unsupportedFieldSchema = zod.z.strictObject({
@@ -280,12 +292,17 @@ var readmeEndpointSchema = zod.z.strictObject({
   path: nonEmptyStringSchema,
   stream: zod.z.boolean().optional()
 });
+var readmeCustomSectionSchema = zod.z.strictObject({
+  title: nonEmptyStringSchema,
+  content: zod.z.string()
+});
 var readmeConfigSchema = zod.z.strictObject({
   apiName: nonEmptyStringSchema.optional(),
   introduction: zod.z.string().optional(),
   apiReferenceLink: nonEmptyStringSchema.optional(),
   bannerLink: nonEmptyStringSchema.optional(),
   disabledSections: zod.z.array(nonEmptyStringSchema).optional(),
+  customSections: zod.z.array(readmeCustomSectionSchema).optional(),
   defaultEndpoint: readmeEndpointSchema.optional(),
   features: zod.z.record(zod.z.string(), zod.z.array(readmeEndpointSchema)).optional()
 });
@@ -309,10 +326,15 @@ var csharpGenerationConfigSchema = zod.z.strictObject({
   simplifyObjectDictionaries: zod.z.boolean().optional(),
   explicitNamespaces: zod.z.boolean().optional(),
   rootNamespaceForCoreClasses: zod.z.boolean().optional(),
-  includeExceptionHandler: zod.z.boolean().optional()
+  includeExceptionHandler: zod.z.boolean().optional(),
+  experimentalExplicitNullableOptional: zod.z.boolean().optional()
 });
 var goGenerationConfigSchema = zod.z.strictObject({
   legacyComplexModels: zod.z.boolean().optional(),
+  /** Uppercase common initialisms in generated names (`UserID` rather than `UserId`). */
+  smartCasing: zod.z.boolean().optional(),
+  /** Overrides the fern root-client constructor independently from the client type name. */
+  clientConstructorName: nonEmptyStringSchema.optional(),
   unionVersion: zod.z.enum(["v0", "v1"]).optional(),
   includeLegacyClientOptions: zod.z.boolean().optional()
 });
@@ -322,15 +344,17 @@ var jvmGenerationConfigSchema = zod.z.strictObject({
   collapseOptionalNullable: zod.z.boolean().optional(),
   gradleDistributionUrl: zod.z.string().min(1).optional(),
   gradlePluginManagement: zod.z.string().optional(),
-  gradleCentralDependencyManagement: zod.z.boolean().optional()
+  gradleCentralDependencyManagement: zod.z.boolean().optional(),
+  /** Selects co-located async methods or a separate async client surface. */
+  asyncStyle: zod.z.enum(["dedicated-client", "twin-methods"]).optional()
 });
 
-// src/sdk-config-ir/v1/language/java.ts
+// src/sdk-config-domain/v1/language/java.ts
 var javaGenerationConfigSchema = jvmGenerationConfigSchema.extend({
   includeKotlinSnippets: zod.z.boolean().optional()
 });
 
-// src/sdk-config-ir/v1/language/kotlin.ts
+// src/sdk-config-domain/v1/language/kotlin.ts
 var kotlinGenerationConfigSchema = jvmGenerationConfigSchema;
 var compilerOptionsSchema = zod.z.strictObject({
   target: nonEmptyStringSchema.optional(),
@@ -362,8 +386,32 @@ var typescriptGenerationConfigSchema = zod.z.strictObject({
   scripts: zod.z.array(packageScriptSchema).optional()
 });
 
-// src/sdk-config-ir/v1/language/mcp.ts
-var mcpGenerationConfigSchema = typescriptGenerationConfigSchema;
+// src/sdk-config-domain/v1/language/mcp.ts
+var mcpAvailabilityStatuses = [
+  "IN_DEVELOPMENT",
+  "PRE_RELEASE",
+  "GENERAL_AVAILABILITY",
+  "DEPRECATED",
+  "ALPHA",
+  "BETA",
+  "PREVIEW",
+  "LEGACY"
+];
+var mcpToolFilterSchema = zod.z.strictObject({
+  include: zod.z.array(nonEmptyStringSchema).optional(),
+  exclude: zod.z.array(nonEmptyStringSchema).optional()
+});
+var mcpToolsetNameSchema = nonEmptyStringSchema.refine(
+  (name) => name !== "default" && /^[a-z0-9-]+$/.test(name),
+  'toolset names must match [a-z0-9-]+ and cannot be "default"'
+);
+var mcpGenerationConfigSchema = typescriptGenerationConfigSchema.extend({
+  serverName: nonEmptyStringSchema.optional(),
+  serverDescription: nonEmptyStringSchema.optional(),
+  excludeAvailability: zod.z.array(zod.z.enum(mcpAvailabilityStatuses)).optional(),
+  tools: mcpToolFilterSchema.optional(),
+  toolsets: zod.z.record(mcpToolsetNameSchema, mcpToolFilterSchema).optional()
+});
 var phpGenerationConfigSchema = zod.z.strictObject({
   propertyAccess: zod.z.enum(["public", "private"]).optional(),
   generateClientInterfaces: zod.z.boolean().optional()
@@ -404,9 +452,10 @@ var rustGenerationConfigSchema = zod.z.strictObject({
   defaultFeatures: zod.z.array(nonEmptyStringSchema).optional()
 });
 var swiftGenerationConfigSchema = zod.z.strictObject({
-  moduleName: nonEmptyStringSchema.optional()
+  moduleName: nonEmptyStringSchema.optional(),
+  nullableAsOptional: zod.z.boolean().optional()
 });
-var goModulePathSchema = nonEmptyStringSchema.regex(
+var goModulePathSchema = relativePathSchema.regex(
   /^(?!.*(?:^|\/)\.{1,2}(?:\/|$))[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)+$/,
   "Go module path must be a slash-delimited path using letters, numbers, dots, dashes, underscores, or tildes"
 );
@@ -485,7 +534,7 @@ var packageConfigSchema = zod.z.strictObject({
   extraPeerDependencies: zod.z.array(dependencySchema).optional()
 });
 
-// src/sdk-config-ir/v1/language/terraform.ts
+// src/sdk-config-domain/v1/language/terraform.ts
 var planModifierSourceSchema = zod.z.discriminatedUnion("enabled", [
   zod.z.strictObject({ enabled: zod.z.literal(true), sourceDir: nonEmptyStringSchema }),
   zod.z.strictObject({ enabled: zod.z.literal(false) })
@@ -509,10 +558,11 @@ var terraformGenerationConfigSchema = zod.z.strictObject({
 });
 
 // src/sdk-config-ir/v1/generation.ts
-var generationAssetSchema = zod.z.strictObject({
-  type: zod.z.enum(["path", "url", "artifact"]),
-  location: nonEmptyStringSchema
-});
+var generationAssetSchema = zod.z.discriminatedUnion("type", [
+  zod.z.strictObject({ type: zod.z.literal("path"), location: relativePathSchema }),
+  zod.z.strictObject({ type: zod.z.literal("url"), location: nonEmptyStringSchema }),
+  zod.z.strictObject({ type: zod.z.literal("artifact"), location: nonEmptyStringSchema })
+]);
 var hookDependencySchema = zod.z.strictObject({
   name: nonEmptyStringSchema,
   version: nonEmptyStringSchema,
@@ -532,7 +582,7 @@ var customCodeConfigSchema = zod.z.strictObject({
   protectedFiles: zod.z.array(nonEmptyStringSchema).optional()
 });
 var workflowConfigSchema = zod.z.strictObject({
-  path: nonEmptyStringSchema,
+  path: relativePathSchema,
   outputName: nonEmptyStringSchema.optional()
 });
 var analyticsHeaderSchema = zod.z.union([
@@ -567,6 +617,11 @@ var unitTestsSchema = zod.z.strictObject({
   mode: zod.z.enum(["core-runtime", "schema-driven", "both"]).optional(),
   exclusions: zod.z.array(nonEmptyStringSchema).optional()
 });
+var fernDefinitionMetadataSchema = zod.z.strictObject({
+  definitionS3DownloadUrl: nonEmptyStringSchema,
+  outputPath: nonEmptyStringSchema.optional(),
+  cliVersion: nonEmptyStringSchema.optional()
+});
 var streamsSchema = zod.z.strictObject({
   enabled: zod.z.boolean(),
   responseType: zod.z.enum(["wrapper", "native", "web"]).optional(),
@@ -618,11 +673,22 @@ var generationConfigSchema = zod.z.strictObject({
   devContainer: zod.z.boolean().default(false),
   allowMockClient: zod.z.boolean().default(false),
   ignoreFiles: zod.z.array(nonEmptyStringSchema).optional(),
+  /**
+   * Raw .fernignore file contents supplied to external publishers that need Fern ignore semantics.
+   * This is separate from generation.ignoreFiles because raw contents preserve comments, ordering,
+   * blank lines, and negation rules.
+   */
+  fernignoreContents: zod.z.string().optional(),
+  /**
+   * Optional Fern definition metadata for publisher paths that need to write definition or
+   * mock-server support files. This is not required for core GitHub artifact publishing.
+   */
+  fernDefinitionMetadata: fernDefinitionMetadataSchema.optional(),
   reservedKeywords: zod.z.array(nonEmptyStringSchema).optional(),
   hooks: hooksConfigSchema.optional(),
   customCode: customCodeConfigSchema.optional(),
   workflows: zod.z.array(workflowConfigSchema).optional(),
-  customQueryPaths: zod.z.array(nonEmptyStringSchema).optional(),
+  customQueryPaths: zod.z.array(relativePathSchema).optional(),
   analytics: analyticsConfigSchema.optional(),
   wireTests: wireTestsSchema.optional(),
   unitTests: unitTestsSchema.optional(),
@@ -643,8 +709,17 @@ var publishRegistrySchema = zod.z.enum([
   "go",
   "composer"
 ]);
+var credentialResolutionSchema = zod.z.enum([
+  "refs-only",
+  "resolved-by-orchestrator",
+  "resolved-by-fiddle"
+]);
 var commonPublishShape = {
   url: nonEmptyStringSchema.optional(),
+  /**
+   * Reference to registry publishing credentials. Raw tokens/passwords are intentionally not part of
+   * SDK Config IR; the external publisher or orchestrator resolves this reference before use.
+   */
   credentialsRef: nonEmptyStringSchema.optional(),
   releaseBranch: nonEmptyStringSchema.optional(),
   tolerateRepublish: zod.z.boolean().optional()
@@ -659,6 +734,10 @@ var publishConfigSchema = zod.z.discriminatedUnion("registry", [
   zod.z.strictObject({ registry: zod.z.literal("composer"), ...commonPublishShape }),
   zod.z.strictObject({
     registry: zod.z.literal("maven"),
+    /**
+     * Reference to Maven signing credentials. Raw signing keys are intentionally not part of SDK
+     * Config IR; the external publisher or orchestrator resolves this reference before use.
+     */
     signingCredentialsRef: nonEmptyStringSchema.optional(),
     ...commonPublishShape
   })
@@ -667,29 +746,54 @@ var reviewersSchema = zod.z.strictObject({
   teams: zod.z.array(nonEmptyStringSchema).optional(),
   users: zod.z.array(nonEmptyStringSchema).optional()
 });
+var replayControlSchema = zod.z.strictObject({
+  enabled: zod.z.boolean()
+});
 var githubOutputSchema = zod.z.strictObject({
   repository: nonEmptyStringSchema,
   host: nonEmptyStringSchema.optional(),
   branch: nonEmptyStringSchema.optional(),
   mode: zod.z.enum(["release", "pull-request", "push"]).optional(),
   reviewers: reviewersSchema.optional(),
+  /**
+   * Reference to GitHub credentials. Raw tokens are intentionally not part of SDK Config IR; the
+   * external publisher or orchestrator resolves this reference before use.
+   */
   credentialsRef: nonEmptyStringSchema.optional(),
-  privateRepository: zod.z.boolean().optional()
-});
+  privateRepository: zod.z.boolean().optional(),
+  /** GitHub replay control. If omitted, the external publisher applies its default behavior. */
+  replay: replayControlSchema.optional(),
+  /** Run GitHub publishing verification. Defaults to false to match current Fiddle job behavior. */
+  verify: zod.z.boolean().default(false),
+  /** Skip creating/updating a GitHub PR when no files changed. Defaults to false. */
+  skipIfNoDiff: zod.z.boolean().default(false),
+  /** Automatically merge the GitHub publishing PR. Defaults to false. */
+  autoMerge: zod.z.boolean().default(false)
+});
+var credentialResolutionShape = {
+  /**
+   * Where output credential references are resolved. SDK Config IR carries refs only; raw resolved
+   * credentials belong at the external publisher/orchestrator boundary, not in this config.
+   */
+  credentialResolution: credentialResolutionSchema.default("refs-only")
+};
 var filesOutputSchema = zod.z.strictObject({
   delivery: zod.z.literal("files"),
   path: nonEmptyStringSchema.optional(),
-  publish: publishConfigSchema.optional()
+  publish: publishConfigSchema.optional(),
+  ...credentialResolutionShape
 });
 var zipOutputSchema = zod.z.strictObject({
   delivery: zod.z.literal("zip"),
   fileName: nonEmptyStringSchema.optional(),
-  publish: publishConfigSchema.optional()
+  publish: publishConfigSchema.optional(),
+  ...credentialResolutionShape
 });
 var githubDeliverySchema = zod.z.strictObject({
   delivery: zod.z.literal("github"),
   github: githubOutputSchema,
-  publish: publishConfigSchema.optional()
+  publish: publishConfigSchema.optional(),
+  ...credentialResolutionShape
 });
 var outputConfigSchema = zod.z.discriminatedUnion(
   "delivery",
@@ -709,7 +813,8 @@ var apiImportSettingsSchema = zod.z.strictObject({
   onlyIncludeReferencedSchemas: zod.z.boolean().optional(),
   objectQueryParameters: zod.z.boolean().optional(),
   typeDatesAsStrings: zod.z.boolean().optional(),
-  groupMultiApiEnvironments: zod.z.boolean().optional()
+  groupMultiApiEnvironments: zod.z.boolean().optional(),
+  defaultIntegerFormat: zod.z.enum(["int32", "int64", "uint32", "uint64"]).optional()
 });
 var sourceSpecTypeSchema = zod.z.enum([
   "openapi",
@@ -766,7 +871,19 @@ var targetConfigSchema = zod.z.strictObject({
   generatorVersion: exactSemverSchema.optional(),
   sourceOrigin: zod.z.enum(["postman", "fern"]),
   sdkName: nonEmptyStringSchema,
+  /**
+   * Stable Fern/Fiddle API identity for external publishing.
+   * Producers must set this explicitly for GitHub or registry publishing; it is not inferred from
+   * target.sdkName because SDK display names and Fern API names are not equivalent.
+   */
+  apiName: nonEmptyStringSchema.optional(),
   organization: nonEmptyStringSchema.optional(),
+  /**
+   * Stable Fern/Fiddle organization identity for external publishing.
+   * Producers must set this explicitly for GitHub or registry publishing; it is not inferred from
+   * target.organization because source organization metadata is optional and may not match Fern.
+   */
+  organizationName: nonEmptyStringSchema.optional(),
   sdkVersion: nonEmptyStringSchema.default("1.0.0"),
   apiVersion: nonEmptyStringSchema.optional()
 });
@@ -774,7 +891,7 @@ var targetConfigSchema = zod.z.strictObject({
 // src/sdk-config-ir/v1/sdk-config-ir-v1.ts
 var SDK_CONFIG_IR_V1_SCHEMA_VERSION = "sdk-config-ir/v1";
 var publishRegistryLanguages = {
-  npm: ["typescript"],
+  npm: ["typescript", "mcp"],
   pypi: ["python"],
   maven: ["java", "kotlin"],
   nuget: ["csharp"],
@@ -842,6 +959,21 @@ var sdkConfigIrV1Schema = zod.z.strictObject({
   compatibility: compatibilityConfigSchema.optional()
 }).superRefine(({ compatibility, generation, output, package: packageConfig, target }, context) => {
   const configuredLanguages = Object.keys(generation.language ?? {});
+  const requiresExternalPublishIdentity = output.delivery === "github" || output.publish !== void 0;
+  if (requiresExternalPublishIdentity) {
+    [
+      ["apiName", "target.apiName is required for external publishing"],
+      ["organizationName", "target.organizationName is required for external publishing"]
+    ].forEach(([field, message]) => {
+      if (!target[field]) {
+        context.addIssue({
+          code: "custom",
+          message,
+          path: ["target", field]
+        });
+      }
+    });
+  }
   configuredLanguages.forEach((language) => {
     if (language !== target.language) {
       context.addIssue({
@@ -900,6 +1032,7 @@ exports.jsonValueSchema = jsonValueSchema;
 exports.kotlinGenerationConfigSchema = kotlinGenerationConfigSchema;
 exports.languageGenerationConfigSchema = languageGenerationConfigSchema;
 exports.legacyInputSchema = legacyInputSchema;
+exports.mcpAvailabilityStatuses = mcpAvailabilityStatuses;
 exports.mcpGenerationConfigSchema = mcpGenerationConfigSchema;
 exports.nonEmptyStringSchema = nonEmptyStringSchema;
 exports.outputConfigSchema = outputConfigSchema;
@@ -909,7 +1042,9 @@ exports.phpGenerationConfigSchema = phpGenerationConfigSchema;
 exports.publishConfigSchema = publishConfigSchema;
 exports.publishRegistrySchema = publishRegistrySchema;
 exports.pythonGenerationConfigSchema = pythonGenerationConfigSchema;
+exports.readmeCustomSectionSchema = readmeCustomSectionSchema;
 exports.readmeEndpointSchema = readmeEndpointSchema;
+exports.relativePathSchema = relativePathSchema;
 exports.rubyGenerationConfigSchema = rubyGenerationConfigSchema;
 exports.rustGenerationConfigSchema = rustGenerationConfigSchema;
 exports.sdkConfigIrV1Schema = sdkConfigIrV1Schema;