@postman/sdk-config 0.5.0 → 0.6.0

package/dist/sdk-config/index.cjs

@@ -1246,10 +1246,16 @@ function finishOutputMapping(mapping, outputMode, sourcePath, state, index) {
   for (const path of collectLeafPaths(outputMode, sourcePath)) {
     if (path[path.length - 1] === "_visit") consume(state, path);
   }
+  const legacyGenerateFullProject = isObject(outputMode) ? outputMode.generateFullProject : void 0;
+  const generationShape = typeof legacyGenerateFullProject === "boolean" ? { generation: { ...mapping.generation, generateFullProject: legacyGenerateFullProject } } : {};
+  if (typeof legacyGenerateFullProject === "boolean") {
+    consume(state, [...sourcePath, "generateFullProject"]);
+  }
   const unsupported = collectUnsupported(outputMode, sourcePath, state);
   const hasCredentials = unsupported.some((diagnostic) => isCredentialPath(diagnostic.path));
   return {
     ...mapping,
+    ...generationShape,
     unsupportedFields: [
       ...state.credentialDiagnostics ?? [],
       ...hasCredentials ? [
@@ -1333,6 +1339,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 zod.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 = zod.z.strictObject({
   clientName: nonEmptyStringSchema.optional(),
   exportedClientName: nonEmptyStringSchema.optional(),
@@ -1431,6 +1544,8 @@ var generationConfigOverrideShape = {
   inferServiceNames: zod.z.boolean().optional(),
   includeDeprecatedOperations: zod.z.boolean().optional(),
   multipleResponses: zod.z.boolean().optional(),
+  /** Generate the entire SDK project, including package manifests and publishable artifacts. */
+  generateFullProject: zod.z.boolean().optional(),
   devContainer: zod.z.boolean().optional(),
   allowMockClient: zod.z.boolean().optional(),
   ignoreFiles: zod.z.array(nonEmptyStringSchema).optional(),
@@ -1459,6 +1574,7 @@ var sdkConfigV1GenerationConfigSchema = zod.z.strictObject({
   inferServiceNames: zod.z.boolean().default(false),
   includeDeprecatedOperations: zod.z.boolean().default(true),
   multipleResponses: zod.z.boolean().default(false),
+  generateFullProject: zod.z.boolean().default(false),
   devContainer: zod.z.boolean().default(false),
   allowMockClient: zod.z.boolean().default(false)
 });
@@ -2008,6 +2124,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 = {
@@ -2063,7 +2183,14 @@ function mapFernConfigToSdkConfigV1(input) {
     api.audiences = [...input.group.audiences.audiences];
   }
   const targets = mapped.map(
-    ({ generator, invocation, language, output, package: outputPackage }, index) => {
+    ({
+      generator,
+      invocation,
+      language,
+      output,
+      package: outputPackage,
+      generation: outputGeneration
+    }, index) => {
       const target = {
         language,
         output,
@@ -2077,6 +2204,7 @@ function mapFernConfigToSdkConfigV1(input) {
       }
       const targetGeneration = {
         ...generations.targetOverrides[index],
+        ...outputGeneration,
         ...invocation.targetGeneration
       };
       if (Object.keys(targetGeneration).length > 0) {
@@ -2254,6 +2382,9 @@ function mapInvocation(generator, language, activeLanguages, index) {
   if (generator.keywords?.length) {
     generation.reservedKeywords = [...generator.keywords];
   }
+  if (generator.generateFullProject !== void 0) {
+    generation.generateFullProject = generator.generateFullProject;
+  }
   const settings = isObject(generator.settings) ? generator.settings : void 0;
   if (settings) {
     const inlinePathParameters = takeBoolean(settings, ["inlinePathParameters"], state, [
@@ -2396,6 +2527,8 @@ function mapCommonConfig(language, config, state, client, generation, packageCon
     basePath
   );
   if (webSockets !== void 0) generation.webSockets = webSockets;
+  const generateFullProject = takeBoolean(config, ["generateFullProject"], state, basePath);
+  if (generateFullProject !== void 0) generation.generateFullProject = generateFullProject;
   const inlineTypes = takeBoolean(config, ["enableInlineTypes"], state, basePath);
   const omitUndefined = takeBoolean(config, ["omitUndefined"], state, basePath);
   const forwardEnums = takeBoolean(config, ["enableForwardCompatibleEnums"], state, basePath);
@@ -2874,6 +3007,7 @@ exports.FernConfigMappingError = FernConfigMappingError;
 exports.SDK_CONFIG_V1_SCHEMA_VERSION = SDK_CONFIG_V1_SCHEMA_VERSION;
 exports.mapFernConfigToSdkConfigV1 = mapFernConfigToSdkConfigV1;
 exports.parseSdkConfigV1 = parseSdkConfigV1;
+exports.parseSdkConfigV1ForConsumption = parseSdkConfigV1ForConsumption;
 exports.sdkConfigV1ApiConfigSchema = sdkConfigV1ApiConfigSchema;
 exports.sdkConfigV1AuthConfigSchema = sdkConfigV1AuthConfigSchema;
 exports.sdkConfigV1AuthSchemeSchema = sdkConfigV1AuthSchemeSchema;