@postman/sdk-config 0.0.4 → 0.1.1

package/dist/sdk-config-ir/index.js

@@ -1,8 +1,12 @@
 import { z } from 'zod';
 import semver from 'semver';
 
-// src/sdk-config-ir/v1/api.ts
+// src/sdk-config-domain/v1/api.ts
 var nonEmptyStringSchema = 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 = z.string().refine(
   (value) => {
     if (value.trim() !== value || !/^\d/.test(value)) {
@@ -25,7 +29,7 @@ var jsonValueSchema = z.lazy(
 );
 var jsonObjectSchema = z.record(z.string(), jsonValueSchema);
 
-// src/sdk-config-ir/v1/api.ts
+// src/sdk-config-domain/v1/api.ts
 var authVariableSchema = z.strictObject({
   name: nonEmptyStringSchema.optional(),
   environmentVariable: nonEmptyStringSchema.optional(),
@@ -175,7 +179,14 @@ var apiConfigSchema = z.strictObject({
   environmentVariables: z.array(environmentVariableSchema).default([]),
   defaultEnvironment: nonEmptyStringSchema.optional(),
   auth: authConfigSchema.optional(),
-  headers: z.array(headerSchema).optional()
+  headers: 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: z.array(nonEmptyStringSchema).optional()
 });
 var retryConfigSchema = z.strictObject({
   enabled: z.boolean().default(true),
@@ -229,6 +240,7 @@ var clientConfigSchema = z.strictObject({
   pathParameterStyle: parameterStyleSchema.optional(),
   filePropertyStyle: parameterStyleSchema.optional(),
   useDefaultRequestParameterValues: z.boolean().optional(),
+  respectOptionalRequestBody: z.boolean().optional(),
   tokenRefresh: tokenRefreshConfigSchema.optional()
 });
 var unsupportedFieldSchema = z.strictObject({
@@ -274,12 +286,17 @@ var readmeEndpointSchema = z.strictObject({
   path: nonEmptyStringSchema,
   stream: z.boolean().optional()
 });
+var readmeCustomSectionSchema = z.strictObject({
+  title: nonEmptyStringSchema,
+  content: z.string()
+});
 var readmeConfigSchema = z.strictObject({
   apiName: nonEmptyStringSchema.optional(),
   introduction: z.string().optional(),
   apiReferenceLink: nonEmptyStringSchema.optional(),
   bannerLink: nonEmptyStringSchema.optional(),
   disabledSections: z.array(nonEmptyStringSchema).optional(),
+  customSections: z.array(readmeCustomSectionSchema).optional(),
   defaultEndpoint: readmeEndpointSchema.optional(),
   features: z.record(z.string(), z.array(readmeEndpointSchema)).optional()
 });
@@ -303,10 +320,15 @@ var csharpGenerationConfigSchema = z.strictObject({
   simplifyObjectDictionaries: z.boolean().optional(),
   explicitNamespaces: z.boolean().optional(),
   rootNamespaceForCoreClasses: z.boolean().optional(),
-  includeExceptionHandler: z.boolean().optional()
+  includeExceptionHandler: z.boolean().optional(),
+  experimentalExplicitNullableOptional: z.boolean().optional()
 });
 var goGenerationConfigSchema = z.strictObject({
   legacyComplexModels: z.boolean().optional(),
+  /** Uppercase common initialisms in generated names (`UserID` rather than `UserId`). */
+  smartCasing: z.boolean().optional(),
+  /** Overrides the fern root-client constructor independently from the client type name. */
+  clientConstructorName: nonEmptyStringSchema.optional(),
   unionVersion: z.enum(["v0", "v1"]).optional(),
   includeLegacyClientOptions: z.boolean().optional()
 });
@@ -316,15 +338,17 @@ var jvmGenerationConfigSchema = z.strictObject({
   collapseOptionalNullable: z.boolean().optional(),
   gradleDistributionUrl: z.string().min(1).optional(),
   gradlePluginManagement: z.string().optional(),
-  gradleCentralDependencyManagement: z.boolean().optional()
+  gradleCentralDependencyManagement: z.boolean().optional(),
+  /** Selects co-located async methods or a separate async client surface. */
+  asyncStyle: 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: z.boolean().optional()
 });
 
-// src/sdk-config-ir/v1/language/kotlin.ts
+// src/sdk-config-domain/v1/language/kotlin.ts
 var kotlinGenerationConfigSchema = jvmGenerationConfigSchema;
 var compilerOptionsSchema = z.strictObject({
   target: nonEmptyStringSchema.optional(),
@@ -356,8 +380,32 @@ var typescriptGenerationConfigSchema = z.strictObject({
   scripts: 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 = z.strictObject({
+  include: z.array(nonEmptyStringSchema).optional(),
+  exclude: 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: z.array(z.enum(mcpAvailabilityStatuses)).optional(),
+  tools: mcpToolFilterSchema.optional(),
+  toolsets: z.record(mcpToolsetNameSchema, mcpToolFilterSchema).optional()
+});
 var phpGenerationConfigSchema = z.strictObject({
   propertyAccess: z.enum(["public", "private"]).optional(),
   generateClientInterfaces: z.boolean().optional()
@@ -398,9 +446,10 @@ var rustGenerationConfigSchema = z.strictObject({
   defaultFeatures: z.array(nonEmptyStringSchema).optional()
 });
 var swiftGenerationConfigSchema = z.strictObject({
-  moduleName: nonEmptyStringSchema.optional()
+  moduleName: nonEmptyStringSchema.optional(),
+  nullableAsOptional: 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"
 );
@@ -479,7 +528,7 @@ var packageConfigSchema = z.strictObject({
   extraPeerDependencies: z.array(dependencySchema).optional()
 });
 
-// src/sdk-config-ir/v1/language/terraform.ts
+// src/sdk-config-domain/v1/language/terraform.ts
 var planModifierSourceSchema = z.discriminatedUnion("enabled", [
   z.strictObject({ enabled: z.literal(true), sourceDir: nonEmptyStringSchema }),
   z.strictObject({ enabled: z.literal(false) })
@@ -503,10 +552,11 @@ var terraformGenerationConfigSchema = z.strictObject({
 });
 
 // src/sdk-config-ir/v1/generation.ts
-var generationAssetSchema = z.strictObject({
-  type: z.enum(["path", "url", "artifact"]),
-  location: nonEmptyStringSchema
-});
+var generationAssetSchema = z.discriminatedUnion("type", [
+  z.strictObject({ type: z.literal("path"), location: relativePathSchema }),
+  z.strictObject({ type: z.literal("url"), location: nonEmptyStringSchema }),
+  z.strictObject({ type: z.literal("artifact"), location: nonEmptyStringSchema })
+]);
 var hookDependencySchema = z.strictObject({
   name: nonEmptyStringSchema,
   version: nonEmptyStringSchema,
@@ -526,7 +576,7 @@ var customCodeConfigSchema = z.strictObject({
   protectedFiles: z.array(nonEmptyStringSchema).optional()
 });
 var workflowConfigSchema = z.strictObject({
-  path: nonEmptyStringSchema,
+  path: relativePathSchema,
   outputName: nonEmptyStringSchema.optional()
 });
 var analyticsHeaderSchema = z.union([
@@ -561,6 +611,11 @@ var unitTestsSchema = z.strictObject({
   mode: z.enum(["core-runtime", "schema-driven", "both"]).optional(),
   exclusions: z.array(nonEmptyStringSchema).optional()
 });
+var fernDefinitionMetadataSchema = z.strictObject({
+  definitionS3DownloadUrl: nonEmptyStringSchema,
+  outputPath: nonEmptyStringSchema.optional(),
+  cliVersion: nonEmptyStringSchema.optional()
+});
 var streamsSchema = z.strictObject({
   enabled: z.boolean(),
   responseType: z.enum(["wrapper", "native", "web"]).optional(),
@@ -612,11 +667,22 @@ var generationConfigSchema = z.strictObject({
   devContainer: z.boolean().default(false),
   allowMockClient: z.boolean().default(false),
   ignoreFiles: 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: 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: z.array(nonEmptyStringSchema).optional(),
   hooks: hooksConfigSchema.optional(),
   customCode: customCodeConfigSchema.optional(),
   workflows: z.array(workflowConfigSchema).optional(),
-  customQueryPaths: z.array(nonEmptyStringSchema).optional(),
+  customQueryPaths: z.array(relativePathSchema).optional(),
   analytics: analyticsConfigSchema.optional(),
   wireTests: wireTestsSchema.optional(),
   unitTests: unitTestsSchema.optional(),
@@ -637,8 +703,17 @@ var publishRegistrySchema = z.enum([
   "go",
   "composer"
 ]);
+var credentialResolutionSchema = 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: z.boolean().optional()
@@ -653,6 +728,10 @@ var publishConfigSchema = z.discriminatedUnion("registry", [
   z.strictObject({ registry: z.literal("composer"), ...commonPublishShape }),
   z.strictObject({
     registry: 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
   })
@@ -661,29 +740,54 @@ var reviewersSchema = z.strictObject({
   teams: z.array(nonEmptyStringSchema).optional(),
   users: z.array(nonEmptyStringSchema).optional()
 });
+var replayControlSchema = z.strictObject({
+  enabled: z.boolean()
+});
 var githubOutputSchema = z.strictObject({
   repository: nonEmptyStringSchema,
   host: nonEmptyStringSchema.optional(),
   branch: nonEmptyStringSchema.optional(),
   mode: 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: z.boolean().optional()
-});
+  privateRepository: 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: z.boolean().default(false),
+  /** Skip creating/updating a GitHub PR when no files changed. Defaults to false. */
+  skipIfNoDiff: z.boolean().default(false),
+  /** Automatically merge the GitHub publishing PR. Defaults to false. */
+  autoMerge: 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 = z.strictObject({
   delivery: z.literal("files"),
   path: nonEmptyStringSchema.optional(),
-  publish: publishConfigSchema.optional()
+  publish: publishConfigSchema.optional(),
+  ...credentialResolutionShape
 });
 var zipOutputSchema = z.strictObject({
   delivery: z.literal("zip"),
   fileName: nonEmptyStringSchema.optional(),
-  publish: publishConfigSchema.optional()
+  publish: publishConfigSchema.optional(),
+  ...credentialResolutionShape
 });
 var githubDeliverySchema = z.strictObject({
   delivery: z.literal("github"),
   github: githubOutputSchema,
-  publish: publishConfigSchema.optional()
+  publish: publishConfigSchema.optional(),
+  ...credentialResolutionShape
 });
 var outputConfigSchema = z.discriminatedUnion(
   "delivery",
@@ -703,7 +807,8 @@ var apiImportSettingsSchema = z.strictObject({
   onlyIncludeReferencedSchemas: z.boolean().optional(),
   objectQueryParameters: z.boolean().optional(),
   typeDatesAsStrings: z.boolean().optional(),
-  groupMultiApiEnvironments: z.boolean().optional()
+  groupMultiApiEnvironments: z.boolean().optional(),
+  defaultIntegerFormat: z.enum(["int32", "int64", "uint32", "uint64"]).optional()
 });
 var sourceSpecTypeSchema = z.enum([
   "openapi",
@@ -760,7 +865,19 @@ var targetConfigSchema = z.strictObject({
   generatorVersion: exactSemverSchema.optional(),
   sourceOrigin: 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()
 });
@@ -768,7 +885,7 @@ var targetConfigSchema = 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"],
@@ -836,6 +953,21 @@ var sdkConfigIrV1Schema = 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({
@@ -872,6 +1004,6 @@ function parseSdkConfigIrV1(value) {
   return sdkConfigIrV1Schema.parse(value);
 }
 
-export { SDK_CONFIG_IR_V1_SCHEMA_VERSION, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, cliGenerationConfigSchema, clientConfigSchema, compatibilityConfigSchema, composerPackageNameSchema, csharpGenerationConfigSchema, dependencySchema, docsConfigSchema, exactSemverSchema, generationConfigSchema, goGenerationConfigSchema, goModulePathSchema, javaGenerationConfigSchema, jsonObjectSchema, jsonValueSchema, kotlinGenerationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, mcpGenerationConfigSchema, nonEmptyStringSchema, outputConfigSchema, packageConfigSchema, parseSdkConfigIrV1, phpGenerationConfigSchema, publishConfigSchema, publishRegistrySchema, pythonGenerationConfigSchema, readmeEndpointSchema, rubyGenerationConfigSchema, rustGenerationConfigSchema, sdkConfigIrV1Schema, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, swiftGenerationConfigSchema, targetConfigSchema, targetLanguageSchema, terraformGenerationConfigSchema, typescriptGenerationConfigSchema, unsupportedFieldSchema };
+export { SDK_CONFIG_IR_V1_SCHEMA_VERSION, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, cliGenerationConfigSchema, clientConfigSchema, compatibilityConfigSchema, composerPackageNameSchema, csharpGenerationConfigSchema, dependencySchema, docsConfigSchema, exactSemverSchema, generationConfigSchema, goGenerationConfigSchema, goModulePathSchema, javaGenerationConfigSchema, jsonObjectSchema, jsonValueSchema, kotlinGenerationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, mcpAvailabilityStatuses, mcpGenerationConfigSchema, nonEmptyStringSchema, outputConfigSchema, packageConfigSchema, parseSdkConfigIrV1, phpGenerationConfigSchema, publishConfigSchema, publishRegistrySchema, pythonGenerationConfigSchema, readmeCustomSectionSchema, readmeEndpointSchema, relativePathSchema, rubyGenerationConfigSchema, rustGenerationConfigSchema, sdkConfigIrV1Schema, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, swiftGenerationConfigSchema, targetConfigSchema, targetLanguageSchema, terraformGenerationConfigSchema, typescriptGenerationConfigSchema, unsupportedFieldSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map