@postman/sdk-config 0.0.4 → 0.1.1

package/dist/typescript-DK97815_.d.ts

@@ -0,0 +1,427 @@
+import { z } from 'zod';
+
+declare const nonEmptyStringSchema: z.ZodString;
+declare const relativePathSchema: z.ZodString;
+declare const exactSemverSchema: z.ZodString;
+type JsonValue = null | boolean | number | string | JsonValue[] | JsonObject;
+type JsonObject = {
+    [key: string]: JsonValue;
+};
+declare const jsonValueSchema: z.ZodType<JsonValue>;
+declare const jsonObjectSchema: z.ZodType<JsonObject>;
+
+declare const goModulePathSchema: z.ZodString;
+declare const composerPackageNameSchema: z.ZodString;
+declare const dependencySchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"registry">;
+        registry: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"git">;
+        url: z.ZodString;
+        ref: z.ZodOptional<z.ZodString>;
+        subdirectory: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"path">;
+        path: z.ZodString;
+    }, z.core.$strict>], "type">>;
+    packageName: z.ZodOptional<z.ZodString>;
+    features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    extras: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optional: z.ZodOptional<z.ZodBoolean>;
+    defaultFeatures: z.ZodOptional<z.ZodBoolean>;
+    environmentMarker: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const packageConfigSchema: z.ZodObject<{
+    packageName: z.ZodOptional<z.ZodString>;
+    moduleName: z.ZodOptional<z.ZodString>;
+    modulePath: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    groupId: z.ZodOptional<z.ZodString>;
+    artifactId: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    repository: z.ZodOptional<z.ZodString>;
+    homepage: z.ZodOptional<z.ZodString>;
+    documentationUrl: z.ZodOptional<z.ZodString>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodEmail>;
+    }, z.core.$strict>>>;
+    developers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodOptional<z.ZodEmail>;
+        organization: z.ZodOptional<z.ZodString>;
+        organizationUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    license: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    keywords: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    classifiers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    projectUrls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        url: z.ZodString;
+    }, z.core.$strict>>>;
+    extraDependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"registry">;
+            registry: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"git">;
+            url: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            subdirectory: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "type">>;
+        packageName: z.ZodOptional<z.ZodString>;
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extras: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        defaultFeatures: z.ZodOptional<z.ZodBoolean>;
+        environmentMarker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    extraDevDependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"registry">;
+            registry: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"git">;
+            url: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            subdirectory: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "type">>;
+        packageName: z.ZodOptional<z.ZodString>;
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extras: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        defaultFeatures: z.ZodOptional<z.ZodBoolean>;
+        environmentMarker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    extraPeerDependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"registry">;
+            registry: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"git">;
+            url: z.ZodString;
+            ref: z.ZodOptional<z.ZodString>;
+            subdirectory: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>, z.ZodObject<{
+            type: z.ZodLiteral<"path">;
+            path: z.ZodString;
+        }, z.core.$strict>], "type">>;
+        packageName: z.ZodOptional<z.ZodString>;
+        features: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        extras: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        optional: z.ZodOptional<z.ZodBoolean>;
+        defaultFeatures: z.ZodOptional<z.ZodBoolean>;
+        environmentMarker: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type Dependency = z.infer<typeof dependencySchema>;
+type PackageConfig = z.infer<typeof packageConfigSchema>;
+
+declare const cliGenerationConfigSchema: z.ZodObject<{
+    paginationParameters: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    skills: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type CliGenerationConfig = z.infer<typeof cliGenerationConfigSchema>;
+
+declare const csharpGenerationConfigSchema: z.ZodObject<{
+    useOptionalWrapper: z.ZodOptional<z.ZodBoolean>;
+    simplifyObjectDictionaries: z.ZodOptional<z.ZodBoolean>;
+    explicitNamespaces: z.ZodOptional<z.ZodBoolean>;
+    rootNamespaceForCoreClasses: z.ZodOptional<z.ZodBoolean>;
+    includeExceptionHandler: z.ZodOptional<z.ZodBoolean>;
+    experimentalExplicitNullableOptional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type CsharpGenerationConfig = z.infer<typeof csharpGenerationConfigSchema>;
+
+declare const goGenerationConfigSchema: z.ZodObject<{
+    legacyComplexModels: z.ZodOptional<z.ZodBoolean>;
+    /** Uppercase common initialisms in generated names (`UserID` rather than `UserId`). */
+    smartCasing: z.ZodOptional<z.ZodBoolean>;
+    /** Overrides the fern root-client constructor independently from the client type name. */
+    clientConstructorName: z.ZodOptional<z.ZodString>;
+    unionVersion: z.ZodOptional<z.ZodEnum<{
+        v0: "v0";
+        v1: "v1";
+    }>>;
+    includeLegacyClientOptions: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type GoGenerationConfig = z.infer<typeof goGenerationConfigSchema>;
+
+declare const javaGenerationConfigSchema: z.ZodObject<{
+    packageLayout: z.ZodOptional<z.ZodEnum<{
+        flat: "flat";
+        nested: "nested";
+    }>>;
+    useLocalDateForDates: z.ZodOptional<z.ZodBoolean>;
+    collapseOptionalNullable: z.ZodOptional<z.ZodBoolean>;
+    gradleDistributionUrl: z.ZodOptional<z.ZodString>;
+    gradlePluginManagement: z.ZodOptional<z.ZodString>;
+    gradleCentralDependencyManagement: z.ZodOptional<z.ZodBoolean>;
+    asyncStyle: z.ZodOptional<z.ZodEnum<{
+        "dedicated-client": "dedicated-client";
+        "twin-methods": "twin-methods";
+    }>>;
+    includeKotlinSnippets: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type JavaGenerationConfig = z.infer<typeof javaGenerationConfigSchema>;
+
+/**
+ * Kotlin targets use the shared Java/JVM generator and always include Kotlin-facing
+ * examples, snippets, and documentation.
+ */
+declare const kotlinGenerationConfigSchema: z.ZodObject<{
+    packageLayout: z.ZodOptional<z.ZodEnum<{
+        flat: "flat";
+        nested: "nested";
+    }>>;
+    useLocalDateForDates: z.ZodOptional<z.ZodBoolean>;
+    collapseOptionalNullable: z.ZodOptional<z.ZodBoolean>;
+    gradleDistributionUrl: z.ZodOptional<z.ZodString>;
+    gradlePluginManagement: z.ZodOptional<z.ZodString>;
+    gradleCentralDependencyManagement: z.ZodOptional<z.ZodBoolean>;
+    asyncStyle: z.ZodOptional<z.ZodEnum<{
+        "dedicated-client": "dedicated-client";
+        "twin-methods": "twin-methods";
+    }>>;
+}, z.core.$strict>;
+type KotlinGenerationConfig = z.infer<typeof kotlinGenerationConfigSchema>;
+
+declare const mcpAvailabilityStatuses: readonly ["IN_DEVELOPMENT", "PRE_RELEASE", "GENERAL_AVAILABILITY", "DEPRECATED", "ALPHA", "BETA", "PREVIEW", "LEGACY"];
+declare const mcpToolFilterSchema: z.ZodObject<{
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+declare const mcpGenerationConfigSchema: z.ZodObject<{
+    typescriptVersion: z.ZodOptional<z.ZodString>;
+    zodVersion: z.ZodOptional<z.ZodString>;
+    compilerOptions: z.ZodOptional<z.ZodObject<{
+        target: z.ZodOptional<z.ZodString>;
+        module: z.ZodOptional<z.ZodString>;
+        lib: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    httpClient: z.ZodOptional<z.ZodObject<{
+        name: z.ZodEnum<{
+            axios: "axios";
+            fetch: "fetch";
+        }>;
+    }, z.core.$strict>>;
+    packageManager: z.ZodOptional<z.ZodEnum<{
+        pnpm: "pnpm";
+        yarn: "yarn";
+    }>>;
+    testFramework: z.ZodOptional<z.ZodEnum<{
+        jest: "jest";
+        vitest: "vitest";
+    }>>;
+    namingStrategy: z.ZodOptional<z.ZodEnum<{
+        base: "base";
+        originalPropertyNames: "originalPropertyNames";
+    }>>;
+    bundle: z.ZodOptional<z.ZodBoolean>;
+    exportClassDefault: z.ZodOptional<z.ZodBoolean>;
+    allowCustomFetcher: z.ZodOptional<z.ZodBoolean>;
+    useBrandedStringAliases: z.ZodOptional<z.ZodBoolean>;
+    useLegacyExports: z.ZodOptional<z.ZodBoolean>;
+    useBigInt: z.ZodOptional<z.ZodBoolean>;
+    serdeLayer: z.ZodOptional<z.ZodBoolean>;
+    scripts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+    }, z.core.$strict>>>;
+    serverName: z.ZodOptional<z.ZodString>;
+    serverDescription: z.ZodOptional<z.ZodString>;
+    excludeAvailability: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        IN_DEVELOPMENT: "IN_DEVELOPMENT";
+        PRE_RELEASE: "PRE_RELEASE";
+        GENERAL_AVAILABILITY: "GENERAL_AVAILABILITY";
+        DEPRECATED: "DEPRECATED";
+        ALPHA: "ALPHA";
+        BETA: "BETA";
+        PREVIEW: "PREVIEW";
+        LEGACY: "LEGACY";
+    }>>>;
+    tools: z.ZodOptional<z.ZodObject<{
+        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    toolsets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        exclude: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type McpAvailabilityStatus = (typeof mcpAvailabilityStatuses)[number];
+type McpToolFilter = z.infer<typeof mcpToolFilterSchema>;
+type McpGenerationConfig = z.infer<typeof mcpGenerationConfigSchema>;
+
+declare const phpGenerationConfigSchema: z.ZodObject<{
+    propertyAccess: z.ZodOptional<z.ZodEnum<{
+        public: "public";
+        private: "private";
+    }>>;
+    generateClientInterfaces: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type PhpGenerationConfig = z.infer<typeof phpGenerationConfigSchema>;
+
+declare const pythonGenerationConfigSchema: z.ZodObject<{
+    pythonVersion: z.ZodOptional<z.ZodString>;
+    pydanticVersion: z.ZodOptional<z.ZodString>;
+    pydantic: z.ZodOptional<z.ZodObject<{
+        versionCompatibility: z.ZodOptional<z.ZodEnum<{
+            both: "both";
+            v1: "v1";
+            v2: "v2";
+            "v1-on-v2": "v1-on-v2";
+        }>>;
+        frozen: z.ZodOptional<z.ZodBoolean>;
+        requireOptionalFields: z.ZodOptional<z.ZodBoolean>;
+        unionNaming: z.ZodOptional<z.ZodEnum<{
+            v0: "v0";
+            v1: "v1";
+        }>>;
+        useFieldAliases: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    client: z.ZodOptional<z.ZodObject<{
+        fileName: z.ZodOptional<z.ZodString>;
+        exportedFileName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    alwaysInitializeOptionals: z.ZodOptional<z.ZodBoolean>;
+    useTypedDictRequests: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type PythonGenerationConfig = z.infer<typeof pythonGenerationConfigSchema>;
+
+declare const rubyGenerationConfigSchema: z.ZodObject<{
+    requirePaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type RubyGenerationConfig = z.infer<typeof rubyGenerationConfigSchema>;
+
+/**
+ * Rust keeps crate identity, client naming, and package metadata in the shared fields; only
+ * behavior with no cross-language equivalent lives here.
+ */
+declare const rustGenerationConfigSchema: z.ZodObject<{
+    /**
+     * Rust type for datetime primitives. `offset` maps to `DateTime<FixedOffset>` and preserves the
+     * timezone the payload carried; `utc` maps to `DateTime<Utc>` and normalizes to UTC.
+     */
+    dateTimeType: z.ZodOptional<z.ZodEnum<{
+        offset: "offset";
+        utc: "utc";
+    }>>;
+    /** Uppercase common initialisms in generated names (`UserID` rather than `UserId`). */
+    capitalizeInitialisms: z.ZodOptional<z.ZodBoolean>;
+    /** Cargo features, mapping a feature name to the dependencies or features it enables. */
+    features: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString>>>;
+    /** Overrides which features make up Cargo's `default` feature set. */
+    defaultFeatures: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type RustGenerationConfig = z.infer<typeof rustGenerationConfigSchema>;
+
+declare const swiftGenerationConfigSchema: z.ZodObject<{
+    moduleName: z.ZodOptional<z.ZodString>;
+    nullableAsOptional: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+type SwiftGenerationConfig = z.infer<typeof swiftGenerationConfigSchema>;
+
+declare const planModifiersSchema: z.ZodObject<{
+    resources: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        enabled: z.ZodLiteral<true>;
+        sourceDir: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        enabled: z.ZodLiteral<false>;
+    }, z.core.$strict>], "enabled">;
+    attributes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        enabled: z.ZodLiteral<true>;
+        sourceDir: z.ZodString;
+    }, z.core.$strict>, z.ZodObject<{
+        enabled: z.ZodLiteral<false>;
+    }, z.core.$strict>], "enabled">;
+}, z.core.$strict>;
+declare const terraformGenerationConfigSchema: z.ZodObject<{
+    providerName: z.ZodOptional<z.ZodString>;
+    providerVersion: z.ZodOptional<z.ZodString>;
+    providerModulePath: z.ZodOptional<z.ZodString>;
+    mockAcceptance: z.ZodOptional<z.ZodBoolean>;
+    hideComputedDiff: z.ZodOptional<z.ZodBoolean>;
+    providerSchema: z.ZodOptional<z.ZodObject<{
+        addressKey: z.ZodString;
+        authTokenKey: z.ZodString;
+    }, z.core.$strict>>;
+    planModifiers: z.ZodOptional<z.ZodObject<{
+        resources: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            enabled: z.ZodLiteral<true>;
+            sourceDir: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            enabled: z.ZodLiteral<false>;
+        }, z.core.$strict>], "enabled">;
+        attributes: z.ZodDiscriminatedUnion<[z.ZodObject<{
+            enabled: z.ZodLiteral<true>;
+            sourceDir: z.ZodString;
+        }, z.core.$strict>, z.ZodObject<{
+            enabled: z.ZodLiteral<false>;
+        }, z.core.$strict>], "enabled">;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+type PlanModifiers = z.infer<typeof planModifiersSchema>;
+type TerraformGenerationConfig = z.infer<typeof terraformGenerationConfigSchema>;
+
+declare const typescriptGenerationConfigSchema: z.ZodObject<{
+    typescriptVersion: z.ZodOptional<z.ZodString>;
+    zodVersion: z.ZodOptional<z.ZodString>;
+    compilerOptions: z.ZodOptional<z.ZodObject<{
+        target: z.ZodOptional<z.ZodString>;
+        module: z.ZodOptional<z.ZodString>;
+        lib: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    httpClient: z.ZodOptional<z.ZodObject<{
+        name: z.ZodEnum<{
+            axios: "axios";
+            fetch: "fetch";
+        }>;
+    }, z.core.$strict>>;
+    packageManager: z.ZodOptional<z.ZodEnum<{
+        pnpm: "pnpm";
+        yarn: "yarn";
+    }>>;
+    testFramework: z.ZodOptional<z.ZodEnum<{
+        jest: "jest";
+        vitest: "vitest";
+    }>>;
+    namingStrategy: z.ZodOptional<z.ZodEnum<{
+        base: "base";
+        originalPropertyNames: "originalPropertyNames";
+    }>>;
+    bundle: z.ZodOptional<z.ZodBoolean>;
+    exportClassDefault: z.ZodOptional<z.ZodBoolean>;
+    allowCustomFetcher: z.ZodOptional<z.ZodBoolean>;
+    useBrandedStringAliases: z.ZodOptional<z.ZodBoolean>;
+    useLegacyExports: z.ZodOptional<z.ZodBoolean>;
+    useBigInt: z.ZodOptional<z.ZodBoolean>;
+    serdeLayer: z.ZodOptional<z.ZodBoolean>;
+    scripts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        command: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+type TypescriptGenerationConfig = z.infer<typeof typescriptGenerationConfigSchema>;
+
+export { pythonGenerationConfigSchema as A, relativePathSchema as B, type CliGenerationConfig as C, type Dependency as D, rubyGenerationConfigSchema as E, rustGenerationConfigSchema as F, type GoGenerationConfig as G, swiftGenerationConfigSchema as H, terraformGenerationConfigSchema as I, type JavaGenerationConfig as J, type KotlinGenerationConfig as K, typescriptGenerationConfigSchema as L, type McpAvailabilityStatus as M, type PackageConfig as P, type RubyGenerationConfig as R, type SwiftGenerationConfig as S, type TerraformGenerationConfig as T, type CsharpGenerationConfig as a, type JsonObject as b, type JsonValue as c, type McpGenerationConfig as d, type McpToolFilter as e, type PhpGenerationConfig as f, type PlanModifiers as g, type PythonGenerationConfig as h, type RustGenerationConfig as i, type TypescriptGenerationConfig as j, cliGenerationConfigSchema as k, composerPackageNameSchema as l, csharpGenerationConfigSchema as m, dependencySchema as n, exactSemverSchema as o, goGenerationConfigSchema as p, goModulePathSchema as q, javaGenerationConfigSchema as r, jsonObjectSchema as s, jsonValueSchema as t, kotlinGenerationConfigSchema as u, mcpAvailabilityStatuses as v, mcpGenerationConfigSchema as w, nonEmptyStringSchema as x, packageConfigSchema as y, phpGenerationConfigSchema as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@postman/sdk-config",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "description": "Shared SDK configuration contracts and transformations for Postman SDK generation",
   "license": "UNLICENSED",
   "sideEffects": false,
@@ -14,6 +14,16 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./sdk-config": {
+      "types": "./dist/sdk-config/index.d.ts",
+      "import": "./dist/sdk-config/index.js",
+      "require": "./dist/sdk-config/index.cjs"
+    },
+    "./sdk-config/v1": {
+      "types": "./dist/sdk-config/v1/index.d.ts",
+      "import": "./dist/sdk-config/v1/index.js",
+      "require": "./dist/sdk-config/v1/index.cjs"
+    },
     "./sdk-config-ir": {
       "types": "./dist/sdk-config-ir/index.d.ts",
       "import": "./dist/sdk-config-ir/index.js",
@@ -30,6 +40,7 @@
     "dist",
     "docs",
     "README.md",
+    "src/sdk-config/v1/README.md",
     "src/sdk-config-ir/v1/README.md"
   ],
   "repository": {
@@ -37,7 +48,7 @@
     "url": "git+https://github.com/postman-eng/sdk-config.git"
   },
   "publishConfig": {
-    "access": "restricted"
+    "access": "public"
   },
   "engines": {
     "node": ">=24"
@@ -48,10 +59,12 @@
     "format": "prettier --write .",
     "format:check": "prettier --check .",
     "lint": "eslint .",
+    "release": "bash scripts/release.sh",
     "test": "vitest run",
+    "test:exports": "node tests/package-exports/sdk-config-subpaths.mjs",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "check": "npm run format:check && npm run lint && npm run typecheck && npm test && npm run build",
+    "check": "npm run format:check && npm run lint && npm run typecheck && npm test && npm run build && npm run test:exports",
     "prepublishOnly": "npm run check"
   },
   "dependencies": {

package/src/sdk-config/v1/README.md

@@ -0,0 +1,135 @@
+# SDK Config v1
+
+`SdkConfigV1` is the public, customer-authored configuration for one or more SDK targets. It
+describes portable generation intent and uses the discriminator `schemaVersion: "sdk-config/v1"`.
+
+```ts
+import { parseSdkConfigV1, type SdkConfigV1 } from '@postman/sdk-config/sdk-config/v1';
+
+const config: SdkConfigV1 = parseSdkConfigV1(untrustedInput);
+```
+
+### Convert a Fern generator group
+
+The Fern CLI can convert its resolved in-memory generator group without serializing or reparsing
+Fern project files. The mapper has no Fern package dependency: its input is a structural projection
+of the resolved group and generator invocations.
+
+```ts
+import { mapFernConfigToSdkConfigV1 } from '@postman/sdk-config/sdk-config/v1';
+
+const { sdkConfig, unsupportedFields } = mapFernConfigToSdkConfigV1({
+  apiName: definition.rootApiFile.contents.name,
+  apiVersion: definition.specVersion,
+  sdkVersion,
+  group: {
+    name: group.groupName,
+    audiences: group.audiences,
+    generators: group.generators,
+  },
+});
+```
+
+Known generator configuration is normalized into SDK Config fields. Values that have no public v1
+representation are returned in `unsupportedFields`; each issue includes a code, source path,
+severity, reason, suggested manual action, and the SDK Config destination when one exists.
+`FernConfigMappingError.issues` uses the same structure for missing information and other fatal
+cases. Generation must not recover omitted values from legacy configuration. Differing
+target-specific values for a shared SDK Config block are rejected because combining them would
+change behavior. Optional `api` enrichment may be supplied after Fern's definition or IR has already
+been lowered into the public API shape.
+
+## Contract boundaries
+
+`SdkConfigV1` is distinct from both existing configuration contracts:
+
+- `SdkConfigV1` is customer-facing, may contain multiple one-language targets, and does not select
+  the API source. A client or sdk-gen-api supplies a collection ID, specification ID, or uploaded
+  file separately.
+- `SdkConfigIrV1` is the normalized, single-target internal input consumed by sdk-gen-core. A server
+  expands one `SdkConfigV1` into one IR document per target and supplies source and operational
+  metadata.
+- The legacy Postman configuration (`BuildParameters`) is an older producer-specific input. It is
+  not accepted by `parseSdkConfigV1`; legacy translators normalize it independently.
+
+The public schema deliberately has no `source`, `compatibility`, source-origin, artifact ID, signed
+URL, S3 location, credential-resolution, or server-generated publishing control fields. Unknown
+fields are rejected at every object boundary. Portable API, client, documentation, package, and
+language field schemas come from a neutral shared domain layer to prevent drift; the public and
+internal envelopes and their operational extensions remain separate explicit allowlists.
+
+## Shape
+
+```json
+{
+  "schemaVersion": "sdk-config/v1",
+  "sdkName": "Acme SDK",
+  "sdkVersion": "1.0.0",
+  "api": {},
+  "client": {},
+  "package": { "description": "Acme API SDK" },
+  "output": { "delivery": "zip" },
+  "docs": {},
+  "generation": { "includeWatermark": true },
+  "targets": [
+    {
+      "language": "typescript",
+      "package": { "packageName": "@acme/sdk" },
+      "generation": { "packageManager": "pnpm" }
+    },
+    {
+      "language": "python",
+      "sdkName": "Acme Python SDK",
+      "package": { "packageName": "acme-sdk" },
+      "output": { "delivery": "files" },
+      "generation": { "pythonVersion": "3.11" }
+    }
+  ]
+}
+```
+
+Each target has exactly one `language`. A language may occur only once, so both identical duplicate
+targets and differing targets that conflict on the same language are rejected. `generatorVersion`
+is an optional target-only exact semantic version.
+
+## Supported languages
+
+SdkConfig v1 is language-agnostic across every sdk-gen-core target available when this contract was
+defined. Each language has an explicitly allowlisted `generation` shape:
+
+| Language   | `language` value | Representative target setting |
+| ---------- | ---------------- | ----------------------------- |
+| TypeScript | `typescript`     | `packageManager`              |
+| Python     | `python`         | `pythonVersion`               |
+| Java       | `java`           | `includeKotlinSnippets`       |
+| Kotlin     | `kotlin`         | `asyncStyle`                  |
+| Go         | `go`             | `clientConstructorName`       |
+| C#         | `csharp`         | `useOptionalWrapper`          |
+| PHP        | `php`            | `propertyAccess`              |
+| Ruby       | `ruby`           | `requirePaths`                |
+| Rust       | `rust`           | `dateTimeType`                |
+| Swift      | `swift`          | `moduleName`                  |
+| CLI        | `cli`            | `skills`                      |
+| MCP        | `mcp`            | `serverName`                  |
+| Terraform  | `terraform`      | `providerName`                |
+
+Adding an internal language setting to `SdkConfigIrV1` does not add it here. Portable settings are
+added to the shared domain deliberately; IR-only settings remain explicit internal extensions.
+
+## Precedence
+
+When a server expands the public config into single-target IR documents, it applies these rules:
+
+| Configuration           | Rule                                                                                                            |
+| ----------------------- | --------------------------------------------------------------------------------------------------------------- |
+| `api`, `client`, `docs` | Shared unchanged by every target; no target override exists.                                                    |
+| Root `generation`       | Shared generation behavior for every target.                                                                    |
+| Target `generation`     | Language-specific settings for that target; it supplements the disjoint shared settings.                        |
+| `sdkName`, `sdkVersion` | A target value wins; otherwise the root value is inherited.                                                     |
+| `package`               | Target properties override root properties; omitted properties inherit. Arrays replace rather than concatenate. |
+| `output`                | A target block replaces the complete root output block; otherwise the root block is inherited.                  |
+| `apiVersion`            | Shared unchanged by every target.                                                                               |
+
+Package publication requirements are validated after applying package and output precedence. For
+example, a TypeScript target publishing to npm may inherit a root `packageName`, while a Python
+target must replace an inherited npm output with a PyPI-compatible output.