@skmtc/core 0.30.1 → 0.32.0

package/script/oas/mediaType/toContentSchema.d.ts

@@ -0,0 +1,8 @@
+import type { OasRef } from '../ref/Ref.js';
+import type { OasSchema } from '../schema/Schema.js';
+import type { OasMediaType } from './MediaType.js';
+/**
+ * The schema a `toSchema(mediaType?)` lookup returns: an exact key lookup when
+ * `mediaType` is given, else the schema of `toJsonContent`.
+ */
+export declare const toContentSchema: (content: Record<string, OasMediaType> | undefined, mediaType: string | undefined) => OasSchema | OasRef<"schema"> | undefined;

package/script/oas/mediaType/toContentSchema.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toContentSchema = void 0;
+const jsonMediaType_js_1 = require("./jsonMediaType.js");
+/**
+ * The schema a `toSchema(mediaType?)` lookup returns: an exact key lookup when
+ * `mediaType` is given, else the schema of `toJsonContent`.
+ */
+const toContentSchema = (content, mediaType) => mediaType === undefined ? (0, jsonMediaType_js_1.toJsonContent)(content)?.schema : content?.[mediaType]?.schema;
+exports.toContentSchema = toContentSchema;

package/script/oas/operation/Operation.d.ts

@@ -60,6 +60,14 @@ export type OperationFields = {
 export type ToRequestBodyMapArgs = {
     schema: OasSchema | OasRef<'schema'>;
     requestBody: OasRequestBody;
+    /** The `content` key the schema was read from. */
+    mediaType: string;
+    /**
+     * The media type to send the body as: the explicit media type when one was
+     * passed, else `contentType` of `OasRequestBody.toJsonContent` (the
+     * JSON-like key, or `application/json` for a body read from `*\/*`).
+     */
+    contentType: string;
 };
 export declare class OasOperation extends OasBase {
     /** Type identifier for OAS operation objects */
@@ -120,7 +128,7 @@ export declare class OasOperation extends OasBase {
      * Maps the request body schema to a custom value using the provided mapping function.
      *
      * @param map - Function to transform the request body schema and metadata
-     * @param mediaType - Media type to extract schema from (default: 'application/json')
+     * @param mediaType - Media type to extract schema from, an exact lookup. Omitted: the media type `OasRequestBody.toJsonContent` picks.
      * @returns Mapped value or undefined if no request body schema found
      */
     toRequestBody<V>(map: ({ schema, requestBody }: ToRequestBodyMapArgs) => V, mediaType?: string): V | undefined;
@@ -133,7 +141,7 @@ export declare class OasOperation extends OasBase {
      * {@link traverseSchema}.
      *
      * @param path - Schema path; `path[0]` must be `'SuccessResponse'` or `'RequestBody'`.
-     * @param mediaType - Media type the body schema is read from (default `application/json`).
+     * @param mediaType - Media type the body schema is read from, an exact lookup. Omitted: the JSON media type (`application/json`, else the first JSON-like type, else `*\/*`).
      * @returns The schema at the path (may be an unresolved `$ref`).
      * @throws Error on an unknown root, a missing response/request body, or a non-navigable segment.
      */

package/script/oas/operation/Operation.js

@@ -167,13 +167,25 @@ class OasOperation extends OasBase_js_1.OasBase {
      * Maps the request body schema to a custom value using the provided mapping function.
      *
      * @param map - Function to transform the request body schema and metadata
-     * @param mediaType - Media type to extract schema from (default: 'application/json')
+     * @param mediaType - Media type to extract schema from, an exact lookup. Omitted: the media type `OasRequestBody.toJsonContent` picks.
      * @returns Mapped value or undefined if no request body schema found
      */
-    toRequestBody(map, mediaType = 'application/json') {
+    toRequestBody(map, mediaType) {
         const requestBody = this.requestBody?.resolve();
-        const schema = requestBody?.content[mediaType]?.schema;
-        return schema ? map({ schema, requestBody }) : undefined;
+        if (!requestBody) {
+            return undefined;
+        }
+        const chosen = mediaType === undefined
+            ? requestBody.toJsonContent()
+            : { mediaType, contentType: mediaType, schema: requestBody.toSchema(mediaType) };
+        return chosen?.schema
+            ? map({
+                schema: chosen.schema,
+                requestBody,
+                mediaType: chosen.mediaType,
+                contentType: chosen.contentType
+            })
+            : undefined;
     }
     /**
      * Navigate into this operation's response or request body schema along an
@@ -184,11 +196,11 @@ class OasOperation extends OasBase_js_1.OasBase {
      * {@link traverseSchema}.
      *
      * @param path - Schema path; `path[0]` must be `'SuccessResponse'` or `'RequestBody'`.
-     * @param mediaType - Media type the body schema is read from (default `application/json`).
+     * @param mediaType - Media type the body schema is read from, an exact lookup. Omitted: the JSON media type (`application/json`, else the first JSON-like type, else `*\/*`).
      * @returns The schema at the path (may be an unresolved `$ref`).
      * @throws Error on an unknown root, a missing response/request body, or a non-navigable segment.
      */
-    traverse(path, mediaType = 'application/json') {
+    traverse(path, mediaType) {
         const [root, ...rest] = path;
         let rootSchema;
         switch (root) {
@@ -203,7 +215,8 @@ class OasOperation extends OasBase_js_1.OasBase {
         }
         if (!rootSchema) {
             const label = root === 'SuccessResponse' ? 'success response' : 'request body';
-            throw new Error(`Operation "${this.method} ${this.path}" has no ${label} schema for media type "${mediaType}"`);
+            const mediaTypeLabel = mediaType === undefined ? 'a JSON media type' : `media type "${mediaType}"`;
+            throw new Error(`Operation "${this.method} ${this.path}" has no ${label} schema for ${mediaTypeLabel}`);
         }
         return (0, traverseSchema_js_1.traverseSchema)(rootSchema, rest);
     }

package/script/oas/parameter/Parameter.d.ts

@@ -243,7 +243,7 @@ export declare class OasParameter extends OasBase {
      * for the specified media type. When `content` has exactly one entry, its
      * schema is used whatever the media type.
      *
-     * @param mediaType - Media type to extract schema from when using content definitions
+     * @param mediaType - Media type to extract schema from when using content definitions, an exact lookup. Omitted: the JSON media type (`application/json`, else the first JSON-like type, else `*\/*`).
      * @returns The parameter's schema object
      * @throws Error if no schema is found for the specified media type
      */

package/script/oas/parameter/Parameter.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasParameter = void 0;
 require("../../_dnt.polyfills.js");
 const OasBase_js_1 = require("../../types/OasBase.js");
+const toContentSchema_js_1 = require("../mediaType/toContentSchema.js");
 /**
  * Represents a Parameter Object in the OpenAPI Specification.
  *
@@ -298,19 +299,21 @@ class OasParameter extends OasBase_js_1.OasBase {
      * for the specified media type. When `content` has exactly one entry, its
      * schema is used whatever the media type.
      *
-     * @param mediaType - Media type to extract schema from when using content definitions
+     * @param mediaType - Media type to extract schema from when using content definitions, an exact lookup. Omitted: the JSON media type (`application/json`, else the first JSON-like type, else `*\/*`).
      * @returns The parameter's schema object
      * @throws Error if no schema is found for the specified media type
      */
-    toSchema(mediaType = 'application/json') {
+    toSchema(mediaType) {
         if (this.schema) {
             return this.schema;
         }
         const contentEntries = Object.values(this.content ?? {});
         const onlyEntry = contentEntries.length === 1 ? contentEntries[0] : undefined;
-        const schema = this.content?.[mediaType]?.schema ?? onlyEntry?.schema;
+        const schema = (0, toContentSchema_js_1.toContentSchema)(this.content, mediaType) ?? onlyEntry?.schema;
         if (!schema) {
-            throw new Error(`Schema not found for media type ${mediaType}`);
+            throw new Error(mediaType === undefined
+                ? 'Schema not found for a JSON media type'
+                : `Schema not found for media type "${mediaType}"`);
         }
         return schema;
     }

package/script/oas/pathItem/PathItem.d.ts

@@ -1,5 +1,6 @@
 import type { OasParameter } from '../parameter/Parameter.js';
 import type { OasRef } from '../ref/Ref.js';
+import type { OasServer } from '../server/Server.js';
 /**
  * Constructor fields for {@link OasPathItem}.
  */
@@ -10,6 +11,8 @@ export type PathItemFields = {
     description?: string | undefined;
     /** Parameters that are applicable for all operations on this path */
     parameters?: (OasParameter | OasRef<'parameter'>)[] | undefined;
+    /** Servers that replace the document's servers for all operations on this path */
+    servers?: OasServer[] | undefined;
     /** Custom extension fields (x-* properties) */
     extensionFields?: Record<string, unknown>;
 };
@@ -103,6 +106,8 @@ export declare class OasPathItem {
     summary: string | undefined;
     description: string | undefined;
     parameters: (OasParameter | OasRef<'parameter'>)[] | undefined;
+    /** Servers that replace the document's servers for all operations on this path */
+    servers: OasServer[] | undefined;
     extensionFields: Record<string, unknown> | undefined;
     constructor(fields?: PathItemFields);
 }

package/script/oas/pathItem/PathItem.js

@@ -112,6 +112,13 @@ class OasPathItem {
             writable: true,
             value: void 0
         });
+        /** Servers that replace the document's servers for all operations on this path */
+        Object.defineProperty(this, "servers", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "extensionFields", {
             enumerable: true,
             configurable: true,
@@ -121,6 +128,7 @@ class OasPathItem {
         this.summary = fields.summary;
         this.description = fields.description;
         this.parameters = fields.parameters;
+        this.servers = fields.servers;
         this.extensionFields = fields.extensionFields;
     }
 }

package/script/oas/requestBody/RequestBody.d.ts

@@ -6,6 +6,7 @@ import type { ToJsonSchemaOptions } from '../schema/Schema.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasBase } from '../../types/OasBase.js';
 import type { ParseContextType } from '../../context/parseTypes.js';
+import type { JsonContent } from '../mediaType/jsonMediaType.js';
 /**
  * Constructor fields for {@link OasRequestBody}.
  */
@@ -286,6 +287,16 @@ export declare class OasRequestBody extends OasBase {
     isRef(): this is OasRef<'requestBody'>;
     resolve(): OasRequestBody;
     resolveOnce(): OasRequestBody;
+    /**
+     * The body schema for `mediaType`, an exact key lookup. Without
+     * `mediaType`, the schema of the JSON media type that {@link toJsonContent}
+     * picks: `application/json`, else the first JSON-like type such as
+     * `application/json;v=1.0` or `application/vnd.api+json`, else `*\/*`
+     * when its schema is an object, array, union or `$ref`.
+     * `undefined` when there is no such media type or it has no schema.
+     */
     toSchema(mediaType?: string): OasSchema | OasRef<'schema'> | undefined;
+    /** The media type this body is read from (JSON-like, or `*\/*`), and its schema. See {@link toJsonContent}. */
+    toJsonContent(): JsonContent | undefined;
     toJsonSchema(options: ToJsonSchemaOptions): OpenAPIV3.RequestBodyObject;
 }

package/script/oas/requestBody/RequestBody.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasRequestBody = void 0;
 require("../../_dnt.polyfills.js");
 const OasBase_js_1 = require("../../types/OasBase.js");
+const jsonMediaType_js_1 = require("../mediaType/jsonMediaType.js");
+const toContentSchema_js_1 = require("../mediaType/toContentSchema.js");
 /**
  * Represents a Request Body Object in the OpenAPI Specification.
  *
@@ -307,8 +309,20 @@ class OasRequestBody extends OasBase_js_1.OasBase {
     resolveOnce() {
         return this;
     }
-    toSchema(mediaType = 'application/json') {
-        return this.content?.[mediaType]?.schema;
+    /**
+     * The body schema for `mediaType`, an exact key lookup. Without
+     * `mediaType`, the schema of the JSON media type that {@link toJsonContent}
+     * picks: `application/json`, else the first JSON-like type such as
+     * `application/json;v=1.0` or `application/vnd.api+json`, else `*\/*`
+     * when its schema is an object, array, union or `$ref`.
+     * `undefined` when there is no such media type or it has no schema.
+     */
+    toSchema(mediaType) {
+        return (0, toContentSchema_js_1.toContentSchema)(this.content, mediaType);
+    }
+    /** The media type this body is read from (JSON-like, or `*\/*`), and its schema. See {@link toJsonContent}. */
+    toJsonContent() {
+        return (0, jsonMediaType_js_1.toJsonContent)(this.content);
     }
     toJsonSchema(options) {
         return {

package/script/oas/response/Response.d.ts

@@ -8,6 +8,7 @@ import type { ToJsonSchemaOptions } from '../schema/Schema.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasBase } from '../../types/OasBase.js';
 import type { ParseContextType } from '../../context/parseTypes.js';
+import type { JsonContent } from '../mediaType/jsonMediaType.js';
 /**
  * Constructor fields for {@link OasResponse}.
  */
@@ -220,7 +221,17 @@ export declare class OasResponse extends OasBase {
     isRef(): this is OasRef<'response'>;
     resolve(): OasResponse;
     resolveOnce(): OasResponse;
+    /**
+     * The body schema for `mediaType`, an exact key lookup. Without
+     * `mediaType`, the schema of the JSON media type that {@link toJsonContent}
+     * picks: `application/json`, else the first JSON-like type such as
+     * `application/json;v=1.0` or `application/vnd.api+json`, else `*\/*`
+     * when its schema is an object, array, union or `$ref`.
+     * `undefined` when there is no such media type or it has no schema.
+     */
     toSchema(mediaType?: string): OasSchema | OasRef<'schema'> | undefined;
+    /** The media type this response is read from (JSON-like, or `*\/*`), and its schema. See {@link toJsonContent}. */
+    toJsonContent(): JsonContent | undefined;
     toJsonSchema(options: ToJsonSchemaOptions): OpenAPIV3.ResponseObject & {
         summary?: string;
     };

package/script/oas/response/Response.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OasResponse = void 0;
 require("../../_dnt.polyfills.js");
 const OasBase_js_1 = require("../../types/OasBase.js");
+const jsonMediaType_js_1 = require("../mediaType/jsonMediaType.js");
+const toContentSchema_js_1 = require("../mediaType/toContentSchema.js");
 /**
  * Represents a Response Object in the OpenAPI Specification.
  *
@@ -247,8 +249,20 @@ class OasResponse extends OasBase_js_1.OasBase {
     resolveOnce() {
         return this;
     }
-    toSchema(mediaType = 'application/json') {
-        return this.content?.[mediaType]?.schema;
+    /**
+     * The body schema for `mediaType`, an exact key lookup. Without
+     * `mediaType`, the schema of the JSON media type that {@link toJsonContent}
+     * picks: `application/json`, else the first JSON-like type such as
+     * `application/json;v=1.0` or `application/vnd.api+json`, else `*\/*`
+     * when its schema is an object, array, union or `$ref`.
+     * `undefined` when there is no such media type or it has no schema.
+     */
+    toSchema(mediaType) {
+        return (0, toContentSchema_js_1.toContentSchema)(this.content, mediaType);
+    }
+    /** The media type this response is read from (JSON-like, or `*\/*`), and its schema. See {@link toJsonContent}. */
+    toJsonContent() {
+        return (0, jsonMediaType_js_1.toJsonContent)(this.content);
     }
     toJsonSchema(options) {
         return {

package/script/oas/webhook/Webhook.d.ts

@@ -113,10 +113,10 @@ export declare class OasWebhook extends OasBase {
      */
     toPayload(): OasRequestBody | undefined;
     /**
-     * The schema of the received payload for `mediaType` (default
-     * `application/json`) — the inbound body shape a handler generator emits a
-     * type for. `undefined` when there is no body or no schema for that media
-     * type.
+     * The schema of the received payload for `mediaType`, an exact lookup —
+     * the inbound body shape a handler generator writes a type for. Without
+     * `mediaType`, the media type `OasRequestBody.toJsonContent` picks.
+     * `undefined` when there is no body or no schema for that media type.
      */
     toPayloadSchema(mediaType?: string): OasSchema | OasRef<'schema'> | undefined;
     /**

package/script/oas/webhook/Webhook.js

@@ -160,13 +160,13 @@ class OasWebhook extends OasBase_js_1.OasBase {
         return this.requestBody?.resolve();
     }
     /**
-     * The schema of the received payload for `mediaType` (default
-     * `application/json`) — the inbound body shape a handler generator emits a
-     * type for. `undefined` when there is no body or no schema for that media
-     * type.
+     * The schema of the received payload for `mediaType`, an exact lookup —
+     * the inbound body shape a handler generator writes a type for. Without
+     * `mediaType`, the media type `OasRequestBody.toJsonContent` picks.
+     * `undefined` when there is no body or no schema for that media type.
      */
-    toPayloadSchema(mediaType = 'application/json') {
-        return this.toPayload()?.content[mediaType]?.schema;
+    toPayloadSchema(mediaType) {
+        return this.toPayload()?.toSchema(mediaType);
     }
     /**
      * Resolve the inbound parameters (e.g. the signature/headers a handler

package/script/parse/logBodyMediaTypes.d.ts

@@ -0,0 +1,27 @@
+import type { ParseContextType } from '../context/parseTypes.js';
+import type { StackTrail } from '../context/StackTrail.js';
+import type { OasMediaType } from '../oas/mediaType/MediaType.js';
+export type LogBodyMediaTypesArgs = {
+    /** The parsed `content` map of a response or request body. */
+    content: Record<string, OasMediaType> | undefined;
+    /** Trail of the response or request body; the issue is logged at its `content` key. */
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+/**
+ * Log at most one issue for a parsed response or request body, from the same
+ * choice the lookups make (`toJsonContent`), so the issue and the lookup
+ * cannot disagree. Called after the body is built, so a body that fails to
+ * parse logs nothing.
+ *
+ * - `WILDCARD_MEDIA_TYPE` (`warning`): the body is read from `*\/*` as JSON,
+ *   though the document does not say its format.
+ * - `NO_JSON_MEDIA_TYPE` (`debug`): no lookup reads the body, and its keys
+ *   include a range (`*\/*` with a scalar schema, `application/*`), so its
+ *   format is unknown.
+ *
+ * A body with only specific non-JSON types (`multipart/form-data`,
+ * `application/octet-stream`, `text/plain`) logs nothing: that is a normal
+ * text, form or binary body.
+ */
+export declare const logBodyMediaTypes: ({ content, stackTrail, context }: LogBodyMediaTypesArgs) => void;

package/script/parse/logBodyMediaTypes.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logBodyMediaTypes = void 0;
+const jsonMediaType_js_1 = require("../oas/mediaType/jsonMediaType.js");
+/**
+ * Log at most one issue for a parsed response or request body, from the same
+ * choice the lookups make (`toJsonContent`), so the issue and the lookup
+ * cannot disagree. Called after the body is built, so a body that fails to
+ * parse logs nothing.
+ *
+ * - `WILDCARD_MEDIA_TYPE` (`warning`): the body is read from `*\/*` as JSON,
+ *   though the document does not say its format.
+ * - `NO_JSON_MEDIA_TYPE` (`debug`): no lookup reads the body, and its keys
+ *   include a range (`*\/*` with a scalar schema, `application/*`), so its
+ *   format is unknown.
+ *
+ * A body with only specific non-JSON types (`multipart/form-data`,
+ * `application/octet-stream`, `text/plain`) logs nothing: that is a normal
+ * text, form or binary body.
+ */
+const logBodyMediaTypes = ({ content, stackTrail, context }) => {
+    const mediaTypes = Object.keys(content ?? {});
+    if (mediaTypes.length === 0) {
+        return;
+    }
+    const listed = mediaTypes.map(mediaType => `"${mediaType}"`).join(', ');
+    // `parent` is only the keys: the issue log serializes it on every issue.
+    const parent = { mediaTypes };
+    const chosen = (0, jsonMediaType_js_1.toJsonContent)(content);
+    if (chosen !== undefined) {
+        if ((0, jsonMediaType_js_1.isAnyMediaType)(chosen.mediaType)) {
+            context.logIssue({
+                key: 'content',
+                level: 'warning',
+                type: 'WILDCARD_MEDIA_TYPE',
+                message: `Content has no JSON media type (${listed}), so the body is read from "*/*" as JSON although the document does not say its format`,
+                parent,
+                stackTrail
+            });
+        }
+        return;
+    }
+    if (mediaTypes.some(mediaType => (0, jsonMediaType_js_1.toMediaTypeEssence)(mediaType).includes('*'))) {
+        context.logIssue({
+            key: 'content',
+            level: 'debug',
+            type: 'NO_JSON_MEDIA_TYPE',
+            message: `Content names only a media type range or non-JSON types (${listed}), so no lookup without a media type reads its schema`,
+            parent,
+            stackTrail
+        });
+    }
+};
+exports.logBodyMediaTypes = logBodyMediaTypes;

package/script/parse/v3-0/parameter/toParameterV3.d.ts

@@ -1,10 +1,11 @@
 import type { ParseContextType } from '../../../context/parseTypes.js';
-import type { OasParameterLocation } from '../../../oas/parameter/parameter-types.js';
+import type { OasParameterLocation, OasParameterStyle } from '../../../oas/parameter/parameter-types.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasParameter } from '../../../oas/parameter/Parameter.js';
 import type { OasRef } from '../../../oas/ref/Ref.js';
 import type { StackTrail } from '../../../context/StackTrail.js';
 type ParameterLocation = Exclude<OasParameterLocation, 'querystring'>;
+type ParameterStyle = Exclude<OasParameterStyle, 'cookie'>;
 export type ToParameterListV3Args = {
     parameters: (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined;
     stackTrail: StackTrail;
@@ -35,7 +36,7 @@ export type ToStyleArgs = {
 };
 export type ToExplodeArgs = {
     explode: boolean | undefined;
-    style: string | undefined;
+    style: ParameterStyle;
     stackTrail: StackTrail;
 };
 export {};

package/script/parse/v3-0/parameter/toParameterV3.js

@@ -111,14 +111,15 @@ const toParameterV3 = ({ parameter, stackTrail, context }) => {
     }
     // Set missing 'required' to true for path parameters and false for others
     const defaultRequired = typeof required === 'undefined' ? (parsedLocation === 'path' ? true : false) : required;
+    const parsedStyle = stackTrail.trace('style', st => toStyle({ style, location: parsedLocation, stackTrail: st }));
     const fields = {
         name,
         location: parsedLocation,
         description,
         required: defaultRequired,
         deprecated,
-        style: stackTrail.trace('style', st => toStyle({ style, location: parsedLocation, stackTrail: st })),
-        explode: stackTrail.trace('explode', st => toExplode({ explode, style, stackTrail: st })),
+        style: parsedStyle,
+        explode: stackTrail.trace('explode', st => toExplode({ explode, style: parsedStyle, stackTrail: st })),
         allowEmptyValue,
         allowReserved,
         schema: stackTrail.trace('schema', st => (0, toSchemasV3_js_1.toOptionalSchemaV3)({ schema, stackTrail: st, context })),

package/script/parse/v3-0/pathItem/toPathItemV3.js

@@ -3,13 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toPathItemV3 = void 0;
 const toParameterV3_js_1 = require("../parameter/toParameterV3.js");
 const PathItem_js_1 = require("../../../oas/pathItem/PathItem.js");
+const toServerV3_js_1 = require("../server/toServerV3.js");
+const tryParseAt_js_1 = require("../../../context/tryParseAt.js");
 const toSpecificationExtensionsV3_js_1 = require("../specificationExtensions/toSpecificationExtensionsV3.js");
 const toPathItemV3 = ({ pathItem, stackTrail, context }) => {
-    const { summary, description, parameters, ...skipped } = pathItem;
+    const { summary, description, parameters, servers, ...skipped } = pathItem;
     return new PathItem_js_1.OasPathItem({
         summary,
         description,
         parameters: stackTrail.trace('parameters', st => (0, toParameterV3_js_1.toParameterListV3)({ parameters, stackTrail: st, context })),
+        servers: (0, tryParseAt_js_1.tryParseAt)({
+            stackTrail,
+            key: 'servers',
+            context,
+            type: 'INVALID_OPERATION',
+            parent: pathItem,
+            fn: st => (0, toServerV3_js_1.toOptionalServersV3)({ servers, stackTrail: st, context })
+        }),
         extensionFields: (0, toSpecificationExtensionsV3_js_1.toSpecificationExtensionsV3)({
             skipped,
             parent: pathItem,

package/script/parse/v3-0/requestBody/toRequestBodiesV3.js

@@ -6,6 +6,7 @@ const toRefV31_js_1 = require("../ref/toRefV31.js");
 const toMediaTypeItemV3_js_1 = require("../mediaType/toMediaTypeItemV3.js");
 const RequestBody_js_1 = require("../../../oas/requestBody/RequestBody.js");
 const toSpecificationExtensionsV3_js_1 = require("../specificationExtensions/toSpecificationExtensionsV3.js");
+const logBodyMediaTypes_js_1 = require("../../logBodyMediaTypes.js");
 const toRequestBodyV3 = ({ requestBody, stackTrail, context }) => {
     if (!requestBody) {
         return undefined;
@@ -29,7 +30,9 @@ const toRequestBodyV3 = ({ requestBody, stackTrail, context }) => {
         required,
         extensionFields
     };
-    return context.withStackTrail(stackTrail, () => new RequestBody_js_1.OasRequestBody(fields, context));
+    const parsed = context.withStackTrail(stackTrail, () => new RequestBody_js_1.OasRequestBody(fields, context));
+    (0, logBodyMediaTypes_js_1.logBodyMediaTypes)({ content: fields.content, stackTrail, context });
+    return parsed;
 };
 exports.toRequestBodyV3 = toRequestBodyV3;
 const toRequestBodiesV3 = ({ requestBodies, stackTrail, context }) => {

package/script/parse/v3-0/response/toResponseV3.js

@@ -9,6 +9,7 @@ const toMediaTypeItemV3_js_1 = require("../mediaType/toMediaTypeItemV3.js");
 const Response_js_1 = require("../../../oas/response/Response.js");
 const toSpecificationExtensionsV3_js_1 = require("../specificationExtensions/toSpecificationExtensionsV3.js");
 const tryParseAt_js_1 = require("../../../context/tryParseAt.js");
+const logBodyMediaTypes_js_1 = require("../../logBodyMediaTypes.js");
 const toResponsesV3 = ({ responses, stackTrail, context }) => {
     const output = {};
     const entries = Object.entries(responses);
@@ -50,12 +51,14 @@ const toResponseV3 = ({ response, stackTrail, context }) => {
     const parsedHeaders = stackTrail.trace('headers', st => (0, toHeadersV3_js_1.toHeadersV3)({ headers, stackTrail: st, context }));
     const parsedLinks = stackTrail.trace('links', st => (0, toLinksV3_js_1.toLinksV3)({ links, stackTrail: st, context }));
     const parsedContent = stackTrail.trace('content', st => (0, toMediaTypeItemV3_js_1.toOptionalMediaTypeItemsV3)({ content, stackTrail: st, context }));
-    return context.withStackTrail(stackTrail, () => new Response_js_1.OasResponse({
+    const parsed = context.withStackTrail(stackTrail, () => new Response_js_1.OasResponse({
         description,
         headers: parsedHeaders,
         links: parsedLinks,
         content: parsedContent,
         extensionFields
     }, context));
+    (0, logBodyMediaTypes_js_1.logBodyMediaTypes)({ content: parsedContent, stackTrail, context });
+    return parsed;
 };
 exports.toResponseV3 = toResponseV3;

package/script/parse/v3-1/parameter/toParameterV3.d.ts

@@ -1,10 +1,11 @@
 import type { ParseContextType } from '../../../context/parseTypes.js';
-import type { OasParameterLocation } from '../../../oas/parameter/parameter-types.js';
+import type { OasParameterLocation, OasParameterStyle } from '../../../oas/parameter/parameter-types.js';
 import type { OpenAPIV3 } from 'openapi-types';
 import { OasParameter } from '../../../oas/parameter/Parameter.js';
 import type { OasRef } from '../../../oas/ref/Ref.js';
 import type { StackTrail } from '../../../context/StackTrail.js';
 type ParameterLocation = Exclude<OasParameterLocation, 'querystring'>;
+type ParameterStyle = Exclude<OasParameterStyle, 'cookie'>;
 export type ToParameterListV3Args = {
     parameters: (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined;
     stackTrail: StackTrail;
@@ -35,7 +36,7 @@ export type ToStyleArgs = {
 };
 export type ToExplodeArgs = {
     explode: boolean | undefined;
-    style: string | undefined;
+    style: ParameterStyle;
     stackTrail: StackTrail;
 };
 export {};

package/script/parse/v3-1/parameter/toParameterV3.js

@@ -111,14 +111,15 @@ const toParameterV3 = ({ parameter, stackTrail, context }) => {
     }
     // Set missing 'required' to true for path parameters and false for others
     const defaultRequired = typeof required === 'undefined' ? (parsedLocation === 'path' ? true : false) : required;
+    const parsedStyle = stackTrail.trace('style', st => toStyle({ style, location: parsedLocation, stackTrail: st }));
     const fields = {
         name,
         location: parsedLocation,
         description,
         required: defaultRequired,
         deprecated,
-        style: stackTrail.trace('style', st => toStyle({ style, location: parsedLocation, stackTrail: st })),
-        explode: stackTrail.trace('explode', st => toExplode({ explode, style, stackTrail: st })),
+        style: parsedStyle,
+        explode: stackTrail.trace('explode', st => toExplode({ explode, style: parsedStyle, stackTrail: st })),
         allowEmptyValue,
         allowReserved,
         schema: stackTrail.trace('schema', st => (0, toSchemasV3_js_1.toOptionalSchemaV3)({ schema, stackTrail: st, context })),

package/script/parse/v3-1/pathItem/toPathItemV3.js

@@ -3,13 +3,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.toPathItemV3 = void 0;
 const toParameterV3_js_1 = require("../parameter/toParameterV3.js");
 const PathItem_js_1 = require("../../../oas/pathItem/PathItem.js");
+const toServerV3_js_1 = require("../server/toServerV3.js");
+const tryParseAt_js_1 = require("../../../context/tryParseAt.js");
 const toSpecificationExtensionsV3_js_1 = require("../specificationExtensions/toSpecificationExtensionsV3.js");
 const toPathItemV3 = ({ pathItem, stackTrail, context }) => {
-    const { summary, description, parameters, ...skipped } = pathItem;
+    const { summary, description, parameters, servers, ...skipped } = pathItem;
     return new PathItem_js_1.OasPathItem({
         summary,
         description,
         parameters: stackTrail.trace('parameters', st => (0, toParameterV3_js_1.toParameterListV3)({ parameters, stackTrail: st, context })),
+        servers: (0, tryParseAt_js_1.tryParseAt)({
+            stackTrail,
+            key: 'servers',
+            context,
+            type: 'INVALID_OPERATION',
+            parent: pathItem,
+            fn: st => (0, toServerV3_js_1.toOptionalServersV3)({ servers, stackTrail: st, context })
+        }),
         extensionFields: (0, toSpecificationExtensionsV3_js_1.toSpecificationExtensionsV3)({
             skipped,
             parent: pathItem,

package/script/parse/v3-1/requestBody/toRequestBodiesV3.js

@@ -6,6 +6,7 @@ const toRefV31_js_1 = require("../ref/toRefV31.js");
 const toMediaTypeItemV3_js_1 = require("../mediaType/toMediaTypeItemV3.js");
 const RequestBody_js_1 = require("../../../oas/requestBody/RequestBody.js");
 const toSpecificationExtensionsV3_js_1 = require("../specificationExtensions/toSpecificationExtensionsV3.js");
+const logBodyMediaTypes_js_1 = require("../../logBodyMediaTypes.js");
 const toRequestBodyV3 = ({ requestBody, stackTrail, context }) => {
     if (!requestBody) {
         return undefined;
@@ -29,7 +30,9 @@ const toRequestBodyV3 = ({ requestBody, stackTrail, context }) => {
         required,
         extensionFields
     };
-    return context.withStackTrail(stackTrail, () => new RequestBody_js_1.OasRequestBody(fields, context));
+    const parsed = context.withStackTrail(stackTrail, () => new RequestBody_js_1.OasRequestBody(fields, context));
+    (0, logBodyMediaTypes_js_1.logBodyMediaTypes)({ content: fields.content, stackTrail, context });
+    return parsed;
 };
 exports.toRequestBodyV3 = toRequestBodyV3;
 const toRequestBodiesV3 = ({ requestBodies, stackTrail, context }) => {