@postman/sdk-config 0.5.0 → 0.6.0

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

@@ -925,6 +925,8 @@ declare const generationConfigSchema: z.ZodObject<{
     inferServiceNames: z.ZodDefault<z.ZodBoolean>;
     includeDeprecatedOperations: z.ZodDefault<z.ZodBoolean>;
     multipleResponses: z.ZodDefault<z.ZodBoolean>;
+    /** Generate the entire SDK project, including package manifests and publishable artifacts. */
+    generateFullProject: z.ZodDefault<z.ZodBoolean>;
     devContainer: z.ZodDefault<z.ZodBoolean>;
     allowMockClient: z.ZodDefault<z.ZodBoolean>;
     ignoreFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -3216,6 +3218,7 @@ declare const sdkConfigIrV1Schema: z.ZodObject<{
         inferServiceNames: z.ZodDefault<z.ZodBoolean>;
         includeDeprecatedOperations: z.ZodDefault<z.ZodBoolean>;
         multipleResponses: z.ZodDefault<z.ZodBoolean>;
+        generateFullProject: z.ZodDefault<z.ZodBoolean>;
         devContainer: z.ZodDefault<z.ZodBoolean>;
         allowMockClient: z.ZodDefault<z.ZodBoolean>;
         ignoreFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -3931,4 +3934,26 @@ declare const webhookSignatureSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 type WebhookSignatureInput = z.input<typeof webhookSignatureSchema>;
 type WebhookSignature = z.output<typeof webhookSignatureSchema>;
 
-export { type ApiConfig, type ApiConfigInput, type ApiImportSettings, type AuthConfig, type AuthScheme, type ClientConfig, type ClientConfigInput, type ClientConfigOverride, type CompatibilityConfig, type CredentialResolution, type DocsConfig, type GenerationConfig, JsonObject, type LanguageGenerationConfig, type LegacyInput, type OutputConfig, type PublishConfig, type PublishRegistry, type ReadmeCustomSection, type ReadmeEndpoint, type ReplayConfig, SDK_CONFIG_IR_V1_SCHEMA_VERSION, type SdkConfigIrV1, type SdkConfigIrV1Input, type SourceConfig, type SourceSpecConfig, type SourceSpecType, type TargetConfig, type TargetLanguage, type UnsupportedField, type WebhookSignature, type WebhookSignatureInput, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, clientConfigOverrideSchema, clientConfigSchema, clientRetryOverrideSchema, compatibilityConfigSchema, docsConfigSchema, generationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, outputConfigSchema, parseSdkConfigIrV1, publishConfigSchema, publishRegistrySchema, readmeCustomSectionSchema, readmeEndpointSchema, replayConfigSchema, sdkConfigIrV1Schema, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, targetConfigSchema, targetLanguageSchema, unsupportedFieldSchema, webhookSignatureSchema };
+declare const sdkConfigIrCapabilitySchema: z.ZodEnum<{
+    "generation.generateFullProject": "generation.generateFullProject";
+}>;
+type SdkConfigIrCapability = z.infer<typeof sdkConfigIrCapabilitySchema>;
+interface SerializedSdkConfigIrV1 {
+    /** Canonical UTF-8 JSON payload intended for a generator runtime. */
+    body: Uint8Array;
+    /** Behavior the selected generator version must implement for this payload. */
+    requiredCapabilities: SdkConfigIrCapability[];
+}
+/**
+ * Serializes SDK Config IR v1 for generator transport. Defaults are runtime behavior, not wire
+ * requirements, so they are omitted. Semantically active features declare the capabilities the
+ * orchestrator must verify before dispatch.
+ */
+declare function serializeSdkConfigIrV1(value: SdkConfigIrV1Input | SdkConfigIrV1): SerializedSdkConfigIrV1;
+/**
+ * Parses a service-to-service SDK Config IR payload while ignoring additive object fields unknown
+ * to this package version. Known fields and all cross-field invariants remain fully validated.
+ */
+declare function parseSdkConfigIrV1ForConsumption(value: unknown): SdkConfigIrV1;
+
+export { type ApiConfig, type ApiConfigInput, type ApiImportSettings, type AuthConfig, type AuthScheme, type ClientConfig, type ClientConfigInput, type ClientConfigOverride, type CompatibilityConfig, type CredentialResolution, type DocsConfig, type GenerationConfig, JsonObject, type LanguageGenerationConfig, type LegacyInput, type OutputConfig, type PublishConfig, type PublishRegistry, type ReadmeCustomSection, type ReadmeEndpoint, type ReplayConfig, SDK_CONFIG_IR_V1_SCHEMA_VERSION, type SdkConfigIrCapability, type SdkConfigIrV1, type SdkConfigIrV1Input, type SerializedSdkConfigIrV1, type SourceConfig, type SourceSpecConfig, type SourceSpecType, type TargetConfig, type TargetLanguage, type UnsupportedField, type WebhookSignature, type WebhookSignatureInput, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, clientConfigOverrideSchema, clientConfigSchema, clientRetryOverrideSchema, compatibilityConfigSchema, docsConfigSchema, generationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, outputConfigSchema, parseSdkConfigIrV1, parseSdkConfigIrV1ForConsumption, publishConfigSchema, publishRegistrySchema, readmeCustomSectionSchema, readmeEndpointSchema, replayConfigSchema, sdkConfigIrCapabilitySchema, sdkConfigIrV1Schema, serializeSdkConfigIrV1, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, targetConfigSchema, targetLanguageSchema, unsupportedFieldSchema, webhookSignatureSchema };

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

@@ -925,6 +925,8 @@ declare const generationConfigSchema: z.ZodObject<{
     inferServiceNames: z.ZodDefault<z.ZodBoolean>;
     includeDeprecatedOperations: z.ZodDefault<z.ZodBoolean>;
     multipleResponses: z.ZodDefault<z.ZodBoolean>;
+    /** Generate the entire SDK project, including package manifests and publishable artifacts. */
+    generateFullProject: z.ZodDefault<z.ZodBoolean>;
     devContainer: z.ZodDefault<z.ZodBoolean>;
     allowMockClient: z.ZodDefault<z.ZodBoolean>;
     ignoreFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -3216,6 +3218,7 @@ declare const sdkConfigIrV1Schema: z.ZodObject<{
         inferServiceNames: z.ZodDefault<z.ZodBoolean>;
         includeDeprecatedOperations: z.ZodDefault<z.ZodBoolean>;
         multipleResponses: z.ZodDefault<z.ZodBoolean>;
+        generateFullProject: z.ZodDefault<z.ZodBoolean>;
         devContainer: z.ZodDefault<z.ZodBoolean>;
         allowMockClient: z.ZodDefault<z.ZodBoolean>;
         ignoreFiles: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -3931,4 +3934,26 @@ declare const webhookSignatureSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
 type WebhookSignatureInput = z.input<typeof webhookSignatureSchema>;
 type WebhookSignature = z.output<typeof webhookSignatureSchema>;
 
-export { type ApiConfig, type ApiConfigInput, type ApiImportSettings, type AuthConfig, type AuthScheme, type ClientConfig, type ClientConfigInput, type ClientConfigOverride, type CompatibilityConfig, type CredentialResolution, type DocsConfig, type GenerationConfig, JsonObject, type LanguageGenerationConfig, type LegacyInput, type OutputConfig, type PublishConfig, type PublishRegistry, type ReadmeCustomSection, type ReadmeEndpoint, type ReplayConfig, SDK_CONFIG_IR_V1_SCHEMA_VERSION, type SdkConfigIrV1, type SdkConfigIrV1Input, type SourceConfig, type SourceSpecConfig, type SourceSpecType, type TargetConfig, type TargetLanguage, type UnsupportedField, type WebhookSignature, type WebhookSignatureInput, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, clientConfigOverrideSchema, clientConfigSchema, clientRetryOverrideSchema, compatibilityConfigSchema, docsConfigSchema, generationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, outputConfigSchema, parseSdkConfigIrV1, publishConfigSchema, publishRegistrySchema, readmeCustomSectionSchema, readmeEndpointSchema, replayConfigSchema, sdkConfigIrV1Schema, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, targetConfigSchema, targetLanguageSchema, unsupportedFieldSchema, webhookSignatureSchema };
+declare const sdkConfigIrCapabilitySchema: z.ZodEnum<{
+    "generation.generateFullProject": "generation.generateFullProject";
+}>;
+type SdkConfigIrCapability = z.infer<typeof sdkConfigIrCapabilitySchema>;
+interface SerializedSdkConfigIrV1 {
+    /** Canonical UTF-8 JSON payload intended for a generator runtime. */
+    body: Uint8Array;
+    /** Behavior the selected generator version must implement for this payload. */
+    requiredCapabilities: SdkConfigIrCapability[];
+}
+/**
+ * Serializes SDK Config IR v1 for generator transport. Defaults are runtime behavior, not wire
+ * requirements, so they are omitted. Semantically active features declare the capabilities the
+ * orchestrator must verify before dispatch.
+ */
+declare function serializeSdkConfigIrV1(value: SdkConfigIrV1Input | SdkConfigIrV1): SerializedSdkConfigIrV1;
+/**
+ * Parses a service-to-service SDK Config IR payload while ignoring additive object fields unknown
+ * to this package version. Known fields and all cross-field invariants remain fully validated.
+ */
+declare function parseSdkConfigIrV1ForConsumption(value: unknown): SdkConfigIrV1;
+
+export { type ApiConfig, type ApiConfigInput, type ApiImportSettings, type AuthConfig, type AuthScheme, type ClientConfig, type ClientConfigInput, type ClientConfigOverride, type CompatibilityConfig, type CredentialResolution, type DocsConfig, type GenerationConfig, JsonObject, type LanguageGenerationConfig, type LegacyInput, type OutputConfig, type PublishConfig, type PublishRegistry, type ReadmeCustomSection, type ReadmeEndpoint, type ReplayConfig, SDK_CONFIG_IR_V1_SCHEMA_VERSION, type SdkConfigIrCapability, type SdkConfigIrV1, type SdkConfigIrV1Input, type SerializedSdkConfigIrV1, type SourceConfig, type SourceSpecConfig, type SourceSpecType, type TargetConfig, type TargetLanguage, type UnsupportedField, type WebhookSignature, type WebhookSignatureInput, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, clientConfigOverrideSchema, clientConfigSchema, clientRetryOverrideSchema, compatibilityConfigSchema, docsConfigSchema, generationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, outputConfigSchema, parseSdkConfigIrV1, parseSdkConfigIrV1ForConsumption, publishConfigSchema, publishRegistrySchema, readmeCustomSectionSchema, readmeEndpointSchema, replayConfigSchema, sdkConfigIrCapabilitySchema, sdkConfigIrV1Schema, serializeSdkConfigIrV1, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, targetConfigSchema, targetLanguageSchema, unsupportedFieldSchema, webhookSignatureSchema };

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

@@ -766,6 +766,8 @@ var generationConfigSchema = z.strictObject({
   inferServiceNames: z.boolean().default(false),
   includeDeprecatedOperations: z.boolean().default(true),
   multipleResponses: z.boolean().default(false),
+  /** Generate the entire SDK project, including package manifests and publishable artifacts. */
+  generateFullProject: z.boolean().default(false),
   devContainer: z.boolean().default(false),
   allowMockClient: z.boolean().default(false),
   ignoreFiles: z.array(nonEmptyStringSchema).optional(),
@@ -1196,7 +1198,152 @@ var sdkConfigIrV1Schema = z.strictObject({
 function parseSdkConfigIrV1(value) {
   return sdkConfigIrV1Schema.parse(value);
 }
+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, false);
+}
+function omitSchemaDefaults(value, schema) {
+  const projected = project(value, schema, schema, true);
+  return projected === OMIT ? void 0 : projected;
+}
+function project(value, candidateSchema, rootSchema, omitDefaults) {
+  const resolvedCandidate = resolveSchema(candidateSchema, rootSchema);
+  if (omitDefaults && Object.hasOwn(resolvedCandidate, "default") && deepEqual(value, resolvedCandidate.default)) {
+    return OMIT;
+  }
+  const schema = selectSchema(value, resolvedCandidate, rootSchema);
+  if (omitDefaults && schema !== resolvedCandidate && Object.hasOwn(schema, "default") && deepEqual(value, schema.default)) {
+    return OMIT;
+  }
+  if (Array.isArray(value)) {
+    if (!schema.items) return value;
+    return value.map((item) => {
+      const projected = project(item, schema.items, rootSchema, omitDefaults);
+      return projected === OMIT ? item : projected;
+    });
+  }
+  if (!isRecord(value) || schema.type !== "object") return value;
+  const entries = [];
+  const properties = schema.properties ?? {};
+  const unionProperties = omitDefaults ? properties : collectAlternativeProperties(resolvedCandidate, rootSchema);
+  for (const [key, propertySchema] of Object.entries(properties)) {
+    if (!Object.hasOwn(value, key)) continue;
+    const projected = project(value[key], propertySchema, rootSchema, omitDefaults);
+    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, omitDefaults) : fieldValue;
+      if (projected !== OMIT) entries.push([key, projected]);
+    } else if (omitDefaults) {
+      throw new Error(`Cannot serialize property unknown to the wire schema: ${key}`);
+    }
+  }
+  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;
+}
+
+// src/sdk-config-ir/v1/wire.ts
+var sdkConfigIrCapabilitySchema = z.enum(["generation.generateFullProject"]);
+var sdkConfigIrV1InputJsonSchema = inputJsonSchema(sdkConfigIrV1Schema);
+function serializeSdkConfigIrV1(value) {
+  const parsed = parseSdkConfigIrV1(value);
+  const wireValue = omitSchemaDefaults(parsed, sdkConfigIrV1InputJsonSchema);
+  const requiredCapabilities = [];
+  if (wireValue === void 0) {
+    throw new Error("SDK Config IR v1 root cannot be omitted from its wire payload");
+  }
+  if (parsed.generation.generateFullProject) {
+    requiredCapabilities.push("generation.generateFullProject");
+  }
+  const json = JSON.stringify(wireValue);
+  if (json === void 0) {
+    throw new Error("SDK Config IR v1 could not be serialized as JSON");
+  }
+  return {
+    body: new TextEncoder().encode(json),
+    requiredCapabilities
+  };
+}
+function parseSdkConfigIrV1ForConsumption(value) {
+  return parseSdkConfigIrV1(stripUnknownProperties(value, sdkConfigIrV1InputJsonSchema));
+}
 
-export { SDK_CONFIG_IR_V1_SCHEMA_VERSION, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, cliGenerationConfigSchema, clientConfigOverrideSchema, clientConfigSchema, clientRetryOverrideSchema, 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, replayConfigSchema, rubyGenerationConfigSchema, rustGenerationConfigSchema, sdkConfigIrV1Schema, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, swiftGenerationConfigSchema, targetConfigSchema, targetLanguageSchema, terraformGenerationConfigSchema, typescriptGenerationConfigSchema, unsupportedFieldSchema, webhookSignatureSchema };
+export { SDK_CONFIG_IR_V1_SCHEMA_VERSION, apiConfigSchema, apiImportSettingsSchema, authConfigSchema, authSchemeSchema, cliGenerationConfigSchema, clientConfigOverrideSchema, clientConfigSchema, clientRetryOverrideSchema, compatibilityConfigSchema, composerPackageNameSchema, csharpGenerationConfigSchema, dependencySchema, docsConfigSchema, exactSemverSchema, generationConfigSchema, goGenerationConfigSchema, goModulePathSchema, javaGenerationConfigSchema, jsonObjectSchema, jsonValueSchema, kotlinGenerationConfigSchema, languageGenerationConfigSchema, legacyInputSchema, mcpAvailabilityStatuses, mcpGenerationConfigSchema, nonEmptyStringSchema, outputConfigSchema, packageConfigSchema, parseSdkConfigIrV1, parseSdkConfigIrV1ForConsumption, phpGenerationConfigSchema, publishConfigSchema, publishRegistrySchema, pythonGenerationConfigSchema, readmeCustomSectionSchema, readmeEndpointSchema, relativePathSchema, replayConfigSchema, rubyGenerationConfigSchema, rustGenerationConfigSchema, sdkConfigIrCapabilitySchema, sdkConfigIrV1Schema, serializeSdkConfigIrV1, sourceConfigSchema, sourceSpecConfigSchema, sourceSpecTypeSchema, swiftGenerationConfigSchema, targetConfigSchema, targetLanguageSchema, terraformGenerationConfigSchema, typescriptGenerationConfigSchema, unsupportedFieldSchema, webhookSignatureSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map