@postman/sdk-config 0.5.1 → 0.6.0

package/dist/sdk-config/v1/index.d.cts

@@ -9308,6 +9308,12 @@ type SdkConfigV1Document = SdkConfigV1Input;
 declare function validateSdkConfigV1(value: unknown): SdkConfigV1Document;
 /** Parses SDK Config and materializes its versioned defaults for runtime resolution. */
 declare function parseSdkConfigV1(value: unknown): SdkConfigV1;
+/**
+ * Parses a service-to-service SDK Config v1 document while ignoring additive object fields unknown
+ * to this package version. Customer-authored documents should continue to use the strict parser or
+ * validator so misspellings are reported.
+ */
+declare function parseSdkConfigV1ForConsumption(value: unknown): SdkConfigV1;
 
 /** A source is either a local path or an HTTP(S) URL; the two locators are mutually exclusive. */
 declare const sdkConfigV1SourceSpecSchema: z.ZodUnion<readonly [z.ZodObject<{
@@ -16754,4 +16760,4 @@ declare class FernConfigMappingError extends Error {
 /** Converts one resolved Fern generator group into a validated customer-facing SDK Config. */
 declare function mapFernConfigToSdkConfigV1(input: FernResolvedGeneratorGroupInput): FernConfigMappingResult;
 
-export { type FernConfigMappingDiagnostic, FernConfigMappingError, type FernConfigMappingResult, type FernResolvedGeneratorGroupInput, type FernResolvedGeneratorInput, type FernSdkConfigLanguage, SDK_CONFIG_V1_SCHEMA_VERSION, type SdkConfigV1, type SdkConfigV1ApiConfig, type SdkConfigV1ApiConfigInput, type SdkConfigV1ClientConfig, type SdkConfigV1ClientConfigInput, type SdkConfigV1ClientConfigOverride, type SdkConfigV1Dependency, type SdkConfigV1DocsConfig, type SdkConfigV1Document, type SdkConfigV1GenerationConfig, type SdkConfigV1GenerationConfigInput, type SdkConfigV1GenerationConfigOverride, type SdkConfigV1Input, type SdkConfigV1OutputConfig, type SdkConfigV1PackageConfig, type SdkConfigV1PublishConfig, type SdkConfigV1PublishRegistry, type SdkConfigV1ReplayConfig, type SdkConfigV1SourceConfig, type SdkConfigV1SourceSpec, type SdkConfigV1Target, type SdkConfigV1WebhookSignature, type SdkConfigV1WebhookSignatureInput, mapFernConfigToSdkConfigV1, parseSdkConfigV1, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, sdkConfigV1PublishConfigSchema, sdkConfigV1PublishRegistrySchema, sdkConfigV1ReadmeCustomSectionSchema, sdkConfigV1ReadmeEndpointSchema, sdkConfigV1ReplayConfigSchema, sdkConfigV1Schema, sdkConfigV1SourceConfigSchema, sdkConfigV1SourceSpecSchema, sdkConfigV1TargetSchema, sdkConfigV1WebhookSignatureSchema, splitSdkConfigV1TargetGeneration, validateSdkConfigV1 };
+export { type FernConfigMappingDiagnostic, FernConfigMappingError, type FernConfigMappingResult, type FernResolvedGeneratorGroupInput, type FernResolvedGeneratorInput, type FernSdkConfigLanguage, SDK_CONFIG_V1_SCHEMA_VERSION, type SdkConfigV1, type SdkConfigV1ApiConfig, type SdkConfigV1ApiConfigInput, type SdkConfigV1ClientConfig, type SdkConfigV1ClientConfigInput, type SdkConfigV1ClientConfigOverride, type SdkConfigV1Dependency, type SdkConfigV1DocsConfig, type SdkConfigV1Document, type SdkConfigV1GenerationConfig, type SdkConfigV1GenerationConfigInput, type SdkConfigV1GenerationConfigOverride, type SdkConfigV1Input, type SdkConfigV1OutputConfig, type SdkConfigV1PackageConfig, type SdkConfigV1PublishConfig, type SdkConfigV1PublishRegistry, type SdkConfigV1ReplayConfig, type SdkConfigV1SourceConfig, type SdkConfigV1SourceSpec, type SdkConfigV1Target, type SdkConfigV1WebhookSignature, type SdkConfigV1WebhookSignatureInput, mapFernConfigToSdkConfigV1, parseSdkConfigV1, parseSdkConfigV1ForConsumption, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, sdkConfigV1PublishConfigSchema, sdkConfigV1PublishRegistrySchema, sdkConfigV1ReadmeCustomSectionSchema, sdkConfigV1ReadmeEndpointSchema, sdkConfigV1ReplayConfigSchema, sdkConfigV1Schema, sdkConfigV1SourceConfigSchema, sdkConfigV1SourceSpecSchema, sdkConfigV1TargetSchema, sdkConfigV1WebhookSignatureSchema, splitSdkConfigV1TargetGeneration, validateSdkConfigV1 };

package/dist/sdk-config/v1/index.d.ts

@@ -9308,6 +9308,12 @@ type SdkConfigV1Document = SdkConfigV1Input;
 declare function validateSdkConfigV1(value: unknown): SdkConfigV1Document;
 /** Parses SDK Config and materializes its versioned defaults for runtime resolution. */
 declare function parseSdkConfigV1(value: unknown): SdkConfigV1;
+/**
+ * Parses a service-to-service SDK Config v1 document while ignoring additive object fields unknown
+ * to this package version. Customer-authored documents should continue to use the strict parser or
+ * validator so misspellings are reported.
+ */
+declare function parseSdkConfigV1ForConsumption(value: unknown): SdkConfigV1;
 
 /** A source is either a local path or an HTTP(S) URL; the two locators are mutually exclusive. */
 declare const sdkConfigV1SourceSpecSchema: z.ZodUnion<readonly [z.ZodObject<{
@@ -16754,4 +16760,4 @@ declare class FernConfigMappingError extends Error {
 /** Converts one resolved Fern generator group into a validated customer-facing SDK Config. */
 declare function mapFernConfigToSdkConfigV1(input: FernResolvedGeneratorGroupInput): FernConfigMappingResult;
 
-export { type FernConfigMappingDiagnostic, FernConfigMappingError, type FernConfigMappingResult, type FernResolvedGeneratorGroupInput, type FernResolvedGeneratorInput, type FernSdkConfigLanguage, SDK_CONFIG_V1_SCHEMA_VERSION, type SdkConfigV1, type SdkConfigV1ApiConfig, type SdkConfigV1ApiConfigInput, type SdkConfigV1ClientConfig, type SdkConfigV1ClientConfigInput, type SdkConfigV1ClientConfigOverride, type SdkConfigV1Dependency, type SdkConfigV1DocsConfig, type SdkConfigV1Document, type SdkConfigV1GenerationConfig, type SdkConfigV1GenerationConfigInput, type SdkConfigV1GenerationConfigOverride, type SdkConfigV1Input, type SdkConfigV1OutputConfig, type SdkConfigV1PackageConfig, type SdkConfigV1PublishConfig, type SdkConfigV1PublishRegistry, type SdkConfigV1ReplayConfig, type SdkConfigV1SourceConfig, type SdkConfigV1SourceSpec, type SdkConfigV1Target, type SdkConfigV1WebhookSignature, type SdkConfigV1WebhookSignatureInput, mapFernConfigToSdkConfigV1, parseSdkConfigV1, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, sdkConfigV1PublishConfigSchema, sdkConfigV1PublishRegistrySchema, sdkConfigV1ReadmeCustomSectionSchema, sdkConfigV1ReadmeEndpointSchema, sdkConfigV1ReplayConfigSchema, sdkConfigV1Schema, sdkConfigV1SourceConfigSchema, sdkConfigV1SourceSpecSchema, sdkConfigV1TargetSchema, sdkConfigV1WebhookSignatureSchema, splitSdkConfigV1TargetGeneration, validateSdkConfigV1 };
+export { type FernConfigMappingDiagnostic, FernConfigMappingError, type FernConfigMappingResult, type FernResolvedGeneratorGroupInput, type FernResolvedGeneratorInput, type FernSdkConfigLanguage, SDK_CONFIG_V1_SCHEMA_VERSION, type SdkConfigV1, type SdkConfigV1ApiConfig, type SdkConfigV1ApiConfigInput, type SdkConfigV1ClientConfig, type SdkConfigV1ClientConfigInput, type SdkConfigV1ClientConfigOverride, type SdkConfigV1Dependency, type SdkConfigV1DocsConfig, type SdkConfigV1Document, type SdkConfigV1GenerationConfig, type SdkConfigV1GenerationConfigInput, type SdkConfigV1GenerationConfigOverride, type SdkConfigV1Input, type SdkConfigV1OutputConfig, type SdkConfigV1PackageConfig, type SdkConfigV1PublishConfig, type SdkConfigV1PublishRegistry, type SdkConfigV1ReplayConfig, type SdkConfigV1SourceConfig, type SdkConfigV1SourceSpec, type SdkConfigV1Target, type SdkConfigV1WebhookSignature, type SdkConfigV1WebhookSignatureInput, mapFernConfigToSdkConfigV1, parseSdkConfigV1, parseSdkConfigV1ForConsumption, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, sdkConfigV1PublishConfigSchema, sdkConfigV1PublishRegistrySchema, sdkConfigV1ReadmeCustomSectionSchema, sdkConfigV1ReadmeEndpointSchema, sdkConfigV1ReplayConfigSchema, sdkConfigV1Schema, sdkConfigV1SourceConfigSchema, sdkConfigV1SourceSpecSchema, sdkConfigV1TargetSchema, sdkConfigV1WebhookSignatureSchema, splitSdkConfigV1TargetGeneration, validateSdkConfigV1 };

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

@@ -1333,6 +1333,113 @@ function outputDiagnostic(path, index) {
     suggestedAction: resolvedGuidance?.suggestedAction ?? "Review this output setting and preserve it outside SDK Config when no equivalent exists."
   };
 }
+var OMIT = /* @__PURE__ */ Symbol("omit");
+function inputJsonSchema(schema) {
+  return z.toJSONSchema(schema, {
+    io: "input",
+    unrepresentable: "any"
+  });
+}
+function stripUnknownProperties(value, schema) {
+  return project(value, schema, schema);
+}
+function project(value, candidateSchema, rootSchema, omitDefaults) {
+  const resolvedCandidate = resolveSchema(candidateSchema, rootSchema);
+  const schema = selectSchema(value, resolvedCandidate, rootSchema);
+  if (Array.isArray(value)) {
+    if (!schema.items) return value;
+    return value.map((item) => {
+      const projected = project(item, schema.items, rootSchema);
+      return projected === OMIT ? item : projected;
+    });
+  }
+  if (!isRecord(value) || schema.type !== "object") return value;
+  const entries = [];
+  const properties = schema.properties ?? {};
+  const unionProperties = collectAlternativeProperties(resolvedCandidate, rootSchema);
+  for (const [key, propertySchema] of Object.entries(properties)) {
+    if (!Object.hasOwn(value, key)) continue;
+    const projected = project(value[key], propertySchema, rootSchema);
+    if (projected !== OMIT) entries.push([key, projected]);
+  }
+  for (const [key, fieldValue] of Object.entries(value)) {
+    if (Object.hasOwn(properties, key)) continue;
+    if (Object.hasOwn(unionProperties, key)) {
+      entries.push([key, fieldValue]);
+      continue;
+    }
+    if (schema.additionalProperties !== false) {
+      const projected = typeof schema.additionalProperties === "object" ? project(fieldValue, schema.additionalProperties, rootSchema) : fieldValue;
+      if (projected !== OMIT) entries.push([key, projected]);
+    }
+  }
+  return Object.fromEntries(entries);
+}
+function collectAlternativeProperties(schema, rootSchema) {
+  const alternatives = schema.oneOf ?? schema.anyOf;
+  if (!alternatives) return schema.properties ?? {};
+  return Object.assign(
+    {},
+    ...alternatives.map((alternative) => resolveSchema(alternative, rootSchema).properties ?? {})
+  );
+}
+function selectSchema(value, schema, rootSchema) {
+  const alternatives = schema.oneOf ?? schema.anyOf;
+  if (!alternatives || alternatives.length === 0) return schema;
+  const best = alternatives.map((alternative, index) => {
+    const resolved = resolveSchema(alternative, rootSchema);
+    return { index, schema: resolved, score: schemaMatchScore(value, resolved) };
+  }).sort((left, right) => right.score - left.score || left.index - right.index)[0];
+  return best.score === Number.NEGATIVE_INFINITY ? schema : best.schema;
+}
+function schemaMatchScore(value, schema) {
+  if (Object.hasOwn(schema, "const") && !deepEqual(value, schema.const)) {
+    return Number.NEGATIVE_INFINITY;
+  }
+  if (schema.enum && !schema.enum.some((candidate) => deepEqual(value, candidate))) {
+    return Number.NEGATIVE_INFINITY;
+  }
+  if (schema.type === "object") {
+    if (!isRecord(value)) return Number.NEGATIVE_INFINITY;
+    const properties = schema.properties ?? {};
+    for (const [key, propertySchema] of Object.entries(properties)) {
+      if (!Object.hasOwn(value, key)) continue;
+      if (Object.hasOwn(propertySchema, "const") && !deepEqual(value[key], propertySchema.const)) {
+        return Number.NEGATIVE_INFINITY;
+      }
+    }
+    return Object.keys(value).filter((key) => Object.hasOwn(properties, key)).length;
+  }
+  if (schema.type === "array") return Array.isArray(value) ? 1 : Number.NEGATIVE_INFINITY;
+  if (schema.type === "string") return typeof value === "string" ? 1 : Number.NEGATIVE_INFINITY;
+  if (schema.type === "number" || schema.type === "integer") {
+    return typeof value === "number" ? 1 : Number.NEGATIVE_INFINITY;
+  }
+  if (schema.type === "boolean") return typeof value === "boolean" ? 1 : Number.NEGATIVE_INFINITY;
+  if (schema.type === "null") return value === null ? 1 : Number.NEGATIVE_INFINITY;
+  return 0;
+}
+function resolveSchema(schema, rootSchema) {
+  if (!schema.$ref) return schema;
+  if (!schema.$ref.startsWith("#/$defs/")) return schema;
+  const name = schema.$ref.slice("#/$defs/".length).replaceAll("~1", "/").replaceAll("~0", "~");
+  return rootSchema.$defs?.[name] ?? schema;
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function deepEqual(left, right) {
+  if (Object.is(left, right)) return true;
+  if (Array.isArray(left) && Array.isArray(right)) {
+    return left.length === right.length && left.every((value, index) => deepEqual(value, right[index]));
+  }
+  if (isRecord(left) && isRecord(right)) {
+    const leftKeys = Object.keys(left);
+    const rightKeys = Object.keys(right);
+    return leftKeys.length === rightKeys.length && leftKeys.every((key) => Object.hasOwn(right, key) && deepEqual(left[key], right[key]));
+  }
+  return false;
+}
 var namingConfigSchema = z.strictObject({
   clientName: nonEmptyStringSchema.optional(),
   exportedClientName: nonEmptyStringSchema.optional(),
@@ -2011,6 +2118,10 @@ function validateSdkConfigV1(value) {
 function parseSdkConfigV1(value) {
   return sdkConfigV1Schema.parse(value);
 }
+var sdkConfigV1InputJsonSchema = inputJsonSchema(sdkConfigV1Schema);
+function parseSdkConfigV1ForConsumption(value) {
+  return parseSdkConfigV1(stripUnknownProperties(value, sdkConfigV1InputJsonSchema));
+}
 
 // src/sdk-config/v1/fern-config-mapper.ts
 var generatorLanguages = {
@@ -2886,6 +2997,6 @@ function takeToolsets(value, aliases, state, basePath) {
   return Object.fromEntries(entries.filter((entry) => entry !== void 0));
 }
 
-export { FernConfigMappingError, SDK_CONFIG_V1_SCHEMA_VERSION, mapFernConfigToSdkConfigV1, parseSdkConfigV1, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, cliGenerationConfigSchema as sdkConfigV1CliGenerationConfigSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, composerPackageNameSchema as sdkConfigV1ComposerPackageNameSchema, csharpGenerationConfigSchema as sdkConfigV1CsharpGenerationConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, exactSemverSchema as sdkConfigV1ExactSemverSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, goGenerationConfigSchema as sdkConfigV1GoGenerationConfigSchema, goModulePathSchema as sdkConfigV1GoModulePathSchema, javaGenerationConfigSchema as sdkConfigV1JavaGenerationConfigSchema, kotlinGenerationConfigSchema as sdkConfigV1KotlinGenerationConfigSchema, mcpGenerationConfigSchema as sdkConfigV1McpGenerationConfigSchema, nonEmptyStringSchema as sdkConfigV1NonEmptyStringSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, phpGenerationConfigSchema as sdkConfigV1PhpGenerationConfigSchema, 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 };
+export { FernConfigMappingError, SDK_CONFIG_V1_SCHEMA_VERSION, mapFernConfigToSdkConfigV1, parseSdkConfigV1, parseSdkConfigV1ForConsumption, sdkConfigV1ApiConfigSchema, sdkConfigV1AuthConfigSchema, sdkConfigV1AuthSchemeSchema, cliGenerationConfigSchema as sdkConfigV1CliGenerationConfigSchema, sdkConfigV1ClientConfigOverrideSchema, sdkConfigV1ClientConfigSchema, composerPackageNameSchema as sdkConfigV1ComposerPackageNameSchema, csharpGenerationConfigSchema as sdkConfigV1CsharpGenerationConfigSchema, sdkConfigV1DependencySchema, sdkConfigV1DocsConfigSchema, exactSemverSchema as sdkConfigV1ExactSemverSchema, sdkConfigV1GenerationConfigOverrideSchema, sdkConfigV1GenerationConfigSchema, goGenerationConfigSchema as sdkConfigV1GoGenerationConfigSchema, goModulePathSchema as sdkConfigV1GoModulePathSchema, javaGenerationConfigSchema as sdkConfigV1JavaGenerationConfigSchema, kotlinGenerationConfigSchema as sdkConfigV1KotlinGenerationConfigSchema, mcpGenerationConfigSchema as sdkConfigV1McpGenerationConfigSchema, nonEmptyStringSchema as sdkConfigV1NonEmptyStringSchema, sdkConfigV1OutputConfigSchema, sdkConfigV1PackageConfigSchema, phpGenerationConfigSchema as sdkConfigV1PhpGenerationConfigSchema, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map