@skmtc/core 0.29.0 → 0.31.0

package/script/oas/parameter/parameter-types.js

@@ -37,6 +37,7 @@ exports.oasParameterStyle = exports.oasParameterLocation = void 0;
 const v = __importStar(require("valibot"));
 exports.oasParameterLocation = v.enum({
     query: 'query',
+    querystring: 'querystring',
     header: 'header',
     path: 'path',
     cookie: 'cookie'
@@ -48,5 +49,6 @@ exports.oasParameterStyle = v.enum({
     simple: 'simple',
     spaceDelimited: 'spaceDelimited',
     pipeDelimited: 'pipeDelimited',
-    deepObject: 'deepObject'
+    deepObject: 'deepObject',
+    cookie: 'cookie'
 });

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,10 +8,13 @@ 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}.
  */
 export type ResponseFields = {
+    /** A short summary of the response (OpenAPI 3.2) */
+    summary?: string | undefined;
     /** A description of the response */
     description?: string | undefined;
     /** Response headers that can be sent */
@@ -208,6 +211,7 @@ export type ResponseFields = {
  */
 export declare class OasResponse extends OasBase {
     oasType: 'response';
+    summary: string | undefined;
     description: string | undefined;
     headers: Record<string, OasHeader | OasRef<'header'>> | undefined;
     links: Record<string, OasLink | OasRef<'link'>> | undefined;
@@ -217,6 +221,18 @@ 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;
-    toJsonSchema(options: ToJsonSchemaOptions): OpenAPIV3.ResponseObject;
+    /** 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.
  *
@@ -195,6 +197,12 @@ class OasResponse extends OasBase_js_1.OasBase {
             writable: true,
             value: 'response'
         });
+        Object.defineProperty(this, "summary", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "description", {
             enumerable: true,
             configurable: true,
@@ -225,6 +233,7 @@ class OasResponse extends OasBase_js_1.OasBase {
             writable: true,
             value: void 0
         });
+        this.summary = fields.summary;
         this.description = fields.description;
         this.headers = fields.headers;
         this.links = fields.links;
@@ -240,11 +249,24 @@ 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 {
+            ...(this.summary !== undefined ? { summary: this.summary } : {}),
             description: this.description ?? '',
             headers: this.headers
                 ? Object.fromEntries(Object.entries(this.headers).map(([header, headerObject]) => [

package/script/oas/securitySchemes/SecurityScheme.d.ts

@@ -3,16 +3,20 @@ import type { OpenAPIV3 } from 'openapi-types';
 export type SecuritySchemeFields = HttpSecuritySchemeFields | ApiKeySecuritySchemeFields | OAuth2SecuritySchemeFields | OpenIdSecuritySchemeFields;
 export type HttpSecuritySchemeFields = {
     description?: string;
+    deprecated?: boolean;
     scheme: string;
     bearerFormat?: string;
 };
 export type ApiKeySecuritySchemeFields = {
     description?: string;
+    deprecated?: boolean;
     name: string;
     in: 'header' | 'query' | 'cookie';
 };
 export type OAuth2SecuritySchemeFields = {
     description?: string;
+    deprecated?: boolean;
+    oauth2MetadataUrl?: string;
     flows: {
         authorizationCode?: {
             authorizationUrl: string;
@@ -35,40 +39,72 @@ export type OAuth2SecuritySchemeFields = {
             refreshUrl?: string | undefined;
             scopes: Record<string, string>;
         };
+        deviceAuthorization?: {
+            deviceAuthorizationUrl: string;
+            tokenUrl: string;
+            refreshUrl?: string | undefined;
+            scopes?: Record<string, string> | undefined;
+        };
     };
 };
 export type OpenIdSecuritySchemeFields = {
     description?: string;
+    deprecated?: boolean;
     openIdConnectUrl: string;
 };
+/** `OpenAPIV3.HttpSecurityScheme` with the OpenAPI 3.2 `deprecated` field. */
+export type HttpSecuritySchemeJson = OpenAPIV3.HttpSecurityScheme & {
+    deprecated?: boolean;
+};
+/** `OpenAPIV3.ApiKeySecurityScheme` with the OpenAPI 3.2 `deprecated` field. */
+export type ApiKeySecuritySchemeJson = OpenAPIV3.ApiKeySecurityScheme & {
+    deprecated?: boolean;
+};
+/** `OpenAPIV3.OpenIdSecurityScheme` with the OpenAPI 3.2 `deprecated` field. */
+export type OpenIdSecuritySchemeJson = OpenAPIV3.OpenIdSecurityScheme & {
+    deprecated?: boolean;
+};
 export declare class OasHttpSecurityScheme {
     oasType: 'securityScheme';
     type: 'http';
     description: string | undefined;
+    deprecated: boolean | undefined;
     scheme: string;
     bearerFormat: string | undefined;
     constructor(fields: HttpSecuritySchemeFields);
     isRef(): this is OasRef<'securityScheme'>;
     resolve(): OasHttpSecurityScheme;
     resolveOnce(): OasHttpSecurityScheme;
-    toJsonSchema(): OpenAPIV3.HttpSecurityScheme;
+    toJsonSchema(): HttpSecuritySchemeJson;
 }
 export declare class OasApiKeySecurityScheme {
     oasType: 'securityScheme';
     type: 'apiKey';
     description: string | undefined;
+    deprecated: boolean | undefined;
     name: string;
     location: 'query' | 'header' | 'cookie';
     constructor(fields: ApiKeySecuritySchemeFields);
     isRef(): this is OasRef<'securityScheme'>;
     resolve(): OasApiKeySecurityScheme;
     resolveOnce(): OasApiKeySecurityScheme;
-    toJsonSchema(): OpenAPIV3.ApiKeySecurityScheme;
+    toJsonSchema(): ApiKeySecuritySchemeJson;
 }
+/**
+ * `OpenAPIV3.OAuth2SecurityScheme` with the OpenAPI 3.2 fields:
+ * `deprecated`, `oauth2MetadataUrl` and the `deviceAuthorization` flow.
+ */
+export type OAuth2SecuritySchemeJson = OpenAPIV3.OAuth2SecurityScheme & {
+    deprecated?: boolean;
+    oauth2MetadataUrl?: string;
+    flows: OAuth2SecuritySchemeFields['flows'];
+};
 export declare class OasOAuth2SecurityScheme {
     oasType: 'securityScheme';
     type: 'oauth2';
     description: string | undefined;
+    deprecated: boolean | undefined;
+    oauth2MetadataUrl: string | undefined;
     flows: {
         authorizationCode?: {
             authorizationUrl: string;
@@ -91,22 +127,29 @@ export declare class OasOAuth2SecurityScheme {
             refreshUrl?: string | undefined;
             scopes: Record<string, string>;
         };
+        deviceAuthorization?: {
+            deviceAuthorizationUrl: string;
+            tokenUrl: string;
+            refreshUrl?: string | undefined;
+            scopes?: Record<string, string> | undefined;
+        };
     };
     constructor(fields: OAuth2SecuritySchemeFields);
     isRef(): this is OasRef<'securityScheme'>;
     resolve(): OasOAuth2SecurityScheme;
     resolveOnce(): OasOAuth2SecurityScheme;
-    toJsonSchema(): OpenAPIV3.OAuth2SecurityScheme;
+    toJsonSchema(): OAuth2SecuritySchemeJson;
 }
 export declare class OasOpenIdSecurityScheme {
     oasType: 'securityScheme';
     type: 'openIdConnect';
     description: string | undefined;
+    deprecated: boolean | undefined;
     openIdConnectUrl: string;
     constructor(fields: OpenIdSecuritySchemeFields);
     isRef(): this is OasRef<'securityScheme'>;
     resolve(): OasOpenIdSecurityScheme;
     resolveOnce(): OasOpenIdSecurityScheme;
-    toJsonSchema(): OpenAPIV3.OpenIdSecurityScheme;
+    toJsonSchema(): OpenIdSecuritySchemeJson;
 }
 export type OasSecurityScheme = OasHttpSecurityScheme | OasApiKeySecurityScheme | OasOAuth2SecurityScheme | OasOpenIdSecurityScheme;

package/script/oas/securitySchemes/SecurityScheme.js

@@ -21,6 +21,12 @@ class OasHttpSecurityScheme {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "deprecated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "scheme", {
             enumerable: true,
             configurable: true,
@@ -34,6 +40,7 @@ class OasHttpSecurityScheme {
             value: void 0
         });
         this.description = fields.description;
+        this.deprecated = fields.deprecated;
         this.scheme = fields.scheme;
         this.bearerFormat = fields.bearerFormat;
     }
@@ -50,6 +57,7 @@ class OasHttpSecurityScheme {
         return {
             type: 'http',
             description: this.description,
+            ...(this.deprecated === undefined ? {} : { deprecated: this.deprecated }),
             scheme: this.scheme,
             bearerFormat: this.bearerFormat
         };
@@ -76,6 +84,12 @@ class OasApiKeySecurityScheme {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "deprecated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "name", {
             enumerable: true,
             configurable: true,
@@ -89,6 +103,7 @@ class OasApiKeySecurityScheme {
             value: void 0
         });
         this.description = fields.description;
+        this.deprecated = fields.deprecated;
         this.name = fields.name;
         this.location = fields.in;
     }
@@ -104,6 +119,7 @@ class OasApiKeySecurityScheme {
     toJsonSchema() {
         return {
             type: 'apiKey',
+            ...(this.deprecated === undefined ? {} : { deprecated: this.deprecated }),
             name: this.name,
             in: this.location
         };
@@ -130,6 +146,18 @@ class OasOAuth2SecurityScheme {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "deprecated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "oauth2MetadataUrl", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "flows", {
             enumerable: true,
             configurable: true,
@@ -137,6 +165,8 @@ class OasOAuth2SecurityScheme {
             value: void 0
         });
         this.description = fields.description;
+        this.deprecated = fields.deprecated;
+        this.oauth2MetadataUrl = fields.oauth2MetadataUrl;
         this.flows = fields.flows;
     }
     isRef() {
@@ -152,11 +182,18 @@ class OasOAuth2SecurityScheme {
         return {
             type: 'oauth2',
             description: this.description,
+            ...(this.deprecated === undefined ? {} : { deprecated: this.deprecated }),
+            ...(this.oauth2MetadataUrl === undefined
+                ? {}
+                : { oauth2MetadataUrl: this.oauth2MetadataUrl }),
             flows: {
                 authorizationCode: this.flows.authorizationCode,
                 clientCredentials: this.flows.clientCredentials,
                 implicit: this.flows.implicit,
-                password: this.flows.password
+                password: this.flows.password,
+                ...(this.flows.deviceAuthorization === undefined
+                    ? {}
+                    : { deviceAuthorization: this.flows.deviceAuthorization })
             }
         };
     }
@@ -182,6 +219,12 @@ class OasOpenIdSecurityScheme {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "deprecated", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         Object.defineProperty(this, "openIdConnectUrl", {
             enumerable: true,
             configurable: true,
@@ -189,6 +232,7 @@ class OasOpenIdSecurityScheme {
             value: void 0
         });
         this.description = fields.description;
+        this.deprecated = fields.deprecated;
         this.openIdConnectUrl = fields.openIdConnectUrl;
     }
     isRef() {
@@ -204,6 +248,7 @@ class OasOpenIdSecurityScheme {
         return {
             type: 'openIdConnect',
             description: this.description,
+            ...(this.deprecated === undefined ? {} : { deprecated: this.deprecated }),
             openIdConnectUrl: this.openIdConnectUrl
         };
     }

package/script/oas/securitySchemes/security-scheme-types.d.ts

@@ -10,6 +10,8 @@ export type OasHttpSecuritySchemeData = {
     type: 'http';
     /** Human-readable description of the security scheme */
     description?: string;
+    /** Whether the scheme is deprecated (OpenAPI 3.2) */
+    deprecated?: boolean;
     /** HTTP authorization scheme (e.g., 'basic', 'bearer') */
     scheme: string;
     /** Format hint for bearer tokens (e.g., 'JWT') */
@@ -35,6 +37,8 @@ export type OasApiKeySecuritySchemeData = {
     type: 'apiKey';
     /** Human-readable description of the security scheme */
     description?: string;
+    /** Whether the scheme is deprecated (OpenAPI 3.2) */
+    deprecated?: boolean;
     /** Name of the header, query parameter, or cookie */
     name: string;
     /** Location where the API key should be sent */
@@ -128,11 +132,25 @@ export declare const oasPasswordOAuth2FlowData: v.ObjectSchema<{
     readonly refreshUrl: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly scopes: v.RecordSchema<v.StringSchema<undefined>, v.StringSchema<undefined>, undefined>;
 }, undefined>;
+/**
+ * Data type for the OAuth2 device authorization flow (OpenAPI 3.2).
+ */
+export type OasDeviceAuthorizationOAuth2FlowData = {
+    /** URL for the OAuth2 device authorization endpoint */
+    deviceAuthorizationUrl: string;
+    /** URL for the OAuth2 token endpoint */
+    tokenUrl: string;
+    /** Optional URL for token refresh */
+    refreshUrl?: string | undefined;
+    /** Available scopes mapped to their descriptions */
+    scopes?: Record<string, string> | undefined;
+};
 export type OasOAuth2FlowsData = {
     authorizationCode?: OasAuthorizationCodeOAuth2FlowData;
     clientCredentials?: OasClientCredentialsOAuth2FlowData;
     implicit?: OasImplicitOAuth2FlowData;
     password?: OasPasswordOAuth2FlowData;
+    deviceAuthorization?: OasDeviceAuthorizationOAuth2FlowData;
 };
 export declare const oasOAuth2FlowsData: v.ObjectSchema<{
     readonly authorizationCode: v.OptionalSchema<v.ObjectSchema<{
@@ -160,6 +178,8 @@ export declare const oasOAuth2FlowsData: v.ObjectSchema<{
 export type OasOAuth2SecuritySchemeData = {
     type: 'oauth2';
     description?: string;
+    deprecated?: boolean;
+    oauth2MetadataUrl?: string;
     flows: OasOAuth2FlowsData;
 };
 export declare const oasOAuth2SecuritySchemeData: v.ObjectSchema<{
@@ -192,6 +212,7 @@ export declare const oasOAuth2SecuritySchemeData: v.ObjectSchema<{
 export type OasOpenIdSecuritySchemeData = {
     type: 'openIdConnect';
     description?: string;
+    deprecated?: boolean;
     openIdConnectUrl: string;
 };
 export declare const oasOpenIdSecuritySchemeData: v.ObjectSchema<{

package/script/oas/server/Server.d.ts

@@ -10,6 +10,8 @@ import type { OasServerVariable } from '../serverVariable/ServerVariable.js';
  */
 export type ServerFields = {
     description?: string | undefined;
+    /** Name that identifies the server (OpenAPI 3.2) */
+    name?: string | undefined;
     url: string;
     variables?: Record<string, OasServerVariable> | undefined;
     extensionFields?: Record<string, unknown>;
@@ -54,6 +56,8 @@ export declare class OasServer {
     oasType: 'server';
     /** Human-readable description of the server */
     description: string | undefined;
+    /** Name that identifies the server (OpenAPI 3.2) */
+    name: string | undefined;
     /** Server URL with optional variable templating */
     url: string;
     /** Variable definitions for URL templating */
@@ -88,7 +92,9 @@ export declare class OasServer {
      * Converts this OAS server to an OpenAPI v3 JSON schema representation.
      *
      * @param _options - Conversion options (currently unused for server objects)
-     * @returns OpenAPI v3 server object with URL, description, and variables
+     * @returns OpenAPI v3 server object with URL, description, variables and, when set, name
      */
-    toJsonSchema(_options: ToJsonSchemaOptions): OpenAPIV3.ServerObject;
+    toJsonSchema(_options: ToJsonSchemaOptions): OpenAPIV3.ServerObject & {
+        name?: string;
+    };
 }

package/script/oas/server/Server.js

@@ -58,6 +58,13 @@ class OasServer {
             writable: true,
             value: void 0
         });
+        /** Name that identifies the server (OpenAPI 3.2) */
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         /** Server URL with optional variable templating */
         Object.defineProperty(this, "url", {
             enumerable: true,
@@ -80,6 +87,7 @@ class OasServer {
             value: void 0
         });
         this.description = fields.description;
+        this.name = fields.name;
         this.url = fields.url;
         this.variables = fields.variables;
         this.extensionFields = fields.extensionFields;
@@ -112,11 +120,12 @@ class OasServer {
      * Converts this OAS server to an OpenAPI v3 JSON schema representation.
      *
      * @param _options - Conversion options (currently unused for server objects)
-     * @returns OpenAPI v3 server object with URL, description, and variables
+     * @returns OpenAPI v3 server object with URL, description, variables and, when set, name
      */
     toJsonSchema(_options) {
         return {
             description: this.description,
+            ...(this.name !== undefined ? { name: this.name } : {}),
             url: this.url,
             variables: this.variables
         };

package/script/oas/tag/Tag.d.ts

@@ -3,6 +3,12 @@ import type { OasExternalDocs } from '../externalDocs/ExternalDocs.js';
 export type TagFields = {
     name: string;
     description: string | undefined;
+    /** Short summary of the tag (OpenAPI 3.2) */
+    summary?: string;
+    /** Name of the tag this tag nests under (OpenAPI 3.2) */
+    parent?: string;
+    /** Kind of tag, e.g. `nav`, `badge` or `audience` (OpenAPI 3.2, open registry) */
+    kind?: string;
     externalDocs?: OasExternalDocs;
     extensionFields?: Record<string, unknown>;
 };
@@ -12,6 +18,9 @@ export declare class OasTag {
     constructor(fields: TagFields);
     get name(): string;
     get description(): string | undefined;
+    get summary(): string | undefined;
+    get parent(): string | undefined;
+    get kind(): string | undefined;
     get externalDocs(): OasExternalDocs | undefined;
     /** Specification Extension fields */
     get extensionFields(): Record<string, unknown> | undefined;

package/script/oas/tag/Tag.js

@@ -31,6 +31,15 @@ class OasTag {
     get description() {
         return __classPrivateFieldGet(this, _OasTag_fields, "f").description;
     }
+    get summary() {
+        return __classPrivateFieldGet(this, _OasTag_fields, "f").summary;
+    }
+    get parent() {
+        return __classPrivateFieldGet(this, _OasTag_fields, "f").parent;
+    }
+    get kind() {
+        return __classPrivateFieldGet(this, _OasTag_fields, "f").kind;
+    }
     get externalDocs() {
         return __classPrivateFieldGet(this, _OasTag_fields, "f").externalDocs;
     }

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;