@postman/sdk-config 0.8.0 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.cjs +76 -7
- package/dist/index.cjs.map +1 -1
- package/dist/index.js +76 -7
- package/dist/index.js.map +1 -1
- package/dist/sdk-config/index.cjs +76 -7
- package/dist/sdk-config/index.cjs.map +1 -1
- package/dist/sdk-config/index.js +76 -7
- package/dist/sdk-config/index.js.map +1 -1
- package/dist/sdk-config/v1/index.cjs +76 -7
- package/dist/sdk-config/v1/index.cjs.map +1 -1
- package/dist/sdk-config/v1/index.d.cts +520 -114
- package/dist/sdk-config/v1/index.d.ts +520 -114
- package/dist/sdk-config/v1/index.js +76 -7
- package/dist/sdk-config/v1/index.js.map +1 -1
- package/dist/sdk-config-ir/index.cjs +23 -2
- package/dist/sdk-config-ir/index.cjs.map +1 -1
- package/dist/sdk-config-ir/index.js +23 -2
- package/dist/sdk-config-ir/index.js.map +1 -1
- package/dist/sdk-config-ir/v1/index.cjs +23 -2
- package/dist/sdk-config-ir/v1/index.cjs.map +1 -1
- package/dist/sdk-config-ir/v1/index.d.cts +52 -10
- package/dist/sdk-config-ir/v1/index.d.ts +52 -10
- package/dist/sdk-config-ir/v1/index.js +23 -2
- package/dist/sdk-config-ir/v1/index.js.map +1 -1
- package/package.json +1 -1
- package/src/sdk-config-ir/v1/README.md +29 -15
package/package.json
CHANGED
|
@@ -226,6 +226,9 @@ audited on 2026-07-17. Counts guide the initial contract; they are not a permane
|
|
|
226
226
|
| `skipResponseValidation`, Python `pydantic_config.skip_validation` | `client.responseValidation` | Inverted; 12 TS, 8 Python |
|
|
227
227
|
| `useDefaultRequestParameterValues` aliases | `client.useDefaultRequestParameterValues` | 1 |
|
|
228
228
|
| `respectOptionalRequestBody`, `respect-optional-request-body` | `client.respectOptionalRequestBody` | Not in the project snapshot; see below |
|
|
229
|
+
| `auto-generate-idempotency-key`, API-wide setting | `client.idempotencyKeyGeneration` | Not in the project snapshot; see below |
|
|
230
|
+
| `user-agent`, `includePlatformHeaders`, `allowUserAgentAppInfo` | `client.userAgent` | Not in the project snapshot; see below |
|
|
231
|
+
| `offsetSemantics` | `client.offsetSemantics` | Not in the project snapshot; see below |
|
|
229
232
|
| `enable-wire-tests`, `enableWireTests`, `generateWireTests` | `generation.wireTests` | 1-15 per language |
|
|
230
233
|
| WebSocket generation aliases | `generation.webSockets` | 3 TS, 3 Python |
|
|
231
234
|
| `streamType`, `fileResponseType` | `generation.streams` | 1 TS |
|
|
@@ -273,6 +276,16 @@ enabling it changes the signature of every endpoint whose body the API declares
|
|
|
273
276
|
absent must keep an existing SDK's signatures rather than assert a value the generator would then
|
|
274
277
|
have to honour.
|
|
275
278
|
|
|
279
|
+
`client.idempotencyKeyGeneration`, `client.userAgent` and `client.offsetSemantics` come from the
|
|
280
|
+
Fern PHP configuration page and also postdate the snapshot. Fern's `auto-generate-idempotency-key` is
|
|
281
|
+
`true`, `false`, or an object of `header-name` and `methods` (which enables it); `enabled` is always
|
|
282
|
+
explicit, so a generator's `false` can opt out of the API-wide `api.settings` value, which the
|
|
283
|
+
translator reads from the resolved `idempotencyKeyGenerationConfig` when the generator sets none. An
|
|
284
|
+
object the translator cannot fully read is reported rather than enabled with defaults. The User-Agent
|
|
285
|
+
options are grouped because they describe one header: `template` is Fern's `user-agent`,
|
|
286
|
+
`includePlatformInfo` is `includePlatformHeaders`, and `allowAppInfo` is `allowUserAgentAppInfo`.
|
|
287
|
+
All three stay undefaulted, for the same reason as `respectOptionalRequestBody`.
|
|
288
|
+
|
|
276
289
|
Fern README endpoint strings such as `GET /users` are parsed into
|
|
277
290
|
`{ "method": "GET", "path": "/users" }`; the legacy string shorthand is not part of the
|
|
278
291
|
normalized contract.
|
|
@@ -337,19 +350,19 @@ project's OpenAPI specs carry it too and are refused for it.
|
|
|
337
350
|
|
|
338
351
|
Only options that remain language-specific stay in `generation.language`.
|
|
339
352
|
|
|
340
|
-
| Language | Fern fields retained in language config | Shared mappings lifted out
|
|
341
|
-
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
342
|
-
| TypeScript | `packageManager` (1), `testFramework` (2), `namespaceExportName`, `allowCustomFetcher` (13), branded aliases (1), legacy exports (1), `useBigInt`, and positive `serdeLayer` from `noSerdeLayer` (8) | Namespace, validation, inline types, dependencies, wire tests, streams, WebSockets, pager/client names
|
|
343
|
-
| Python | Python/Pydantic versions, client filenames, model switches, TypedDict requests, redirect/chunk/recursion compatibility, and package extras | Package/module names, enum form, extra fields, response validation, request style, dependencies, timeout, layout, wire tests, WebSockets
|
|
344
|
-
| Java/Kotlin | Package layout (3), local dates (2), optional-nullable collapse (2), Gradle settings (7), and JVM async-client style | Maven identity, namespace, names, forward-compatible enums, inline properties, dependencies, pager, wire tests
|
|
345
|
-
| Go | Legacy complex models, union version (3), legacy client options (1), and the fern root-client constructor name | Module/package identity, client name, environments, smart casing, inline properties, pager, wire tests
|
|
346
|
-
| C# | Optional wrapper, simplified dictionaries (1), explicit namespaces (7), core namespace behavior (1), exception handler (5), and the experimental explicit-nullable-optional switch | NuGet identity, namespace, class/error names, pager, wire tests
|
|
347
|
-
| PHP | Property access (2) and generated client interfaces (1) | Composer identity, namespace, client/pager names, request style, dependencies, wire tests
|
|
348
|
-
| Ruby | Require paths (2) | Gem identity, client name, dependencies, pager, wire tests
|
|
349
|
-
| Rust | Datetime representation, initialism casing, and Cargo features/default-features | Crate identity, client name, and package metadata use shared fields.
|
|
350
|
-
| Swift | Module name and the nullable-as-optional collapse | Client, environment and error naming use shared fields.
|
|
351
|
-
| CLI | Pagination parameter names and the `skills` boolean | Go module and package identity use `package`.
|
|
352
|
-
| MCP | Server identity, availability exclusions, tool filters and named toolsets, plus the TypeScript options | npm package identity, client and serialization behavior
|
|
353
|
+
| Language | Fern fields retained in language config | Shared mappings lifted out |
|
|
354
|
+
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
|
|
355
|
+
| TypeScript | `packageManager` (1), `testFramework` (2), `namespaceExportName`, `allowCustomFetcher` (13), branded aliases (1), legacy exports (1), `useBigInt`, and positive `serdeLayer` from `noSerdeLayer` (8) | Namespace, validation, inline types, dependencies, wire tests, streams, WebSockets, pager/client names |
|
|
356
|
+
| Python | Python/Pydantic versions, client filenames, model switches, TypedDict requests, redirect/chunk/recursion compatibility, and package extras | Package/module names, enum form, extra fields, response validation, request style, dependencies, timeout, layout, wire tests, WebSockets |
|
|
357
|
+
| Java/Kotlin | Package layout (3), local dates (2), optional-nullable collapse (2), Gradle settings (7), and JVM async-client style | Maven identity, namespace, names, forward-compatible enums, inline properties, dependencies, pager, wire tests |
|
|
358
|
+
| Go | Legacy complex models, union version (3), legacy client options (1), and the fern root-client constructor name | Module/package identity, client name, environments, smart casing, inline properties, pager, wire tests |
|
|
359
|
+
| C# | Optional wrapper, simplified dictionaries (1), explicit namespaces (7), core namespace behavior (1), exception handler (5), and the experimental explicit-nullable-optional switch | NuGet identity, namespace, class/error names, pager, wire tests |
|
|
360
|
+
| PHP | Property access (2) and generated client interfaces (1) | Composer identity, namespace, client/pager names, request style, dependencies, wire tests, idempotency keys, User-Agent, offset semantics |
|
|
361
|
+
| Ruby | Require paths (2) | Gem identity, client name, dependencies, pager, wire tests |
|
|
362
|
+
| Rust | Datetime representation, initialism casing, and Cargo features/default-features | Crate identity, client name, and package metadata use shared fields. |
|
|
363
|
+
| Swift | Module name and the nullable-as-optional collapse | Client, environment and error naming use shared fields. |
|
|
364
|
+
| CLI | Pagination parameter names and the `skills` boolean | Go module and package identity use `package`. |
|
|
365
|
+
| MCP | Server identity, availability exclusions, tool filters and named toolsets, plus the TypeScript options | npm package identity, client and serialization behavior |
|
|
353
366
|
|
|
354
367
|
## Removed and deferred legacy configuration
|
|
355
368
|
|
|
@@ -359,8 +372,9 @@ the migration.
|
|
|
359
372
|
|
|
360
373
|
### Removed after finding no customer use and no sdk-gen-core equivalent
|
|
361
374
|
|
|
362
|
-
- Common Fern generation:
|
|
363
|
-
compatibility behavior instead of a second permanent switch.
|
|
375
|
+
- Common Fern generation: the omit platform-header override (`omitFernHeaders`). Output-profile
|
|
376
|
+
defaults own this compatibility behavior instead of a second permanent switch. The include side
|
|
377
|
+
was re-added as `client.userAgent.includePlatformInfo` once the Fern PHP generator documented it.
|
|
364
378
|
- Source import: optional-additional-properties defaults, environment grouping strategies,
|
|
365
379
|
discriminant removal, forward-compatible inference, default environment inference, const
|
|
366
380
|
coercion, endpoint filters, example-depth controls, alias resolution, single-schema oneOf
|