@skmtc/core 0.0.984 → 0.16.2

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

@@ -0,0 +1,44 @@
+import { isRef } from '../../../helpers/refFns.js';
+import { toRefV31 } from '../ref/toRefV31.js';
+import { toMediaTypeItemsV3 } from '../mediaType/toMediaTypeItemV3.js';
+import { OasRequestBody } from '../../../oas/requestBody/RequestBody.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+export const toRequestBodyV3 = ({ requestBody, stackTrail, context }) => {
+    if (!requestBody) {
+        return undefined;
+    }
+    if (isRef(requestBody)) {
+        return toRefV31({ ref: requestBody, refType: 'requestBody', stackTrail, context });
+    }
+    const { description, content, required, ...skipped } = requestBody;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: requestBody,
+        context,
+        stackTrail,
+        parentType: 'requestBody'
+    });
+    const fields = {
+        description,
+        content: stackTrail.trace('content', st => {
+            return toMediaTypeItemsV3({ content, stackTrail: st, context });
+        }),
+        required,
+        extensionFields
+    };
+    return context.withStackTrail(stackTrail, () => new OasRequestBody(fields, context));
+};
+export const toRequestBodiesV3 = ({ requestBodies, stackTrail, context }) => {
+    if (!requestBodies) {
+        return undefined;
+    }
+    const entries = Object.entries(requestBodies)
+        .map(([key, value]) => {
+        return [
+            key,
+            stackTrail.trace(key, st => toRequestBodyV3({ requestBody: value, stackTrail: st, context }))
+        ];
+    })
+        .filter(([, value]) => Boolean(value));
+    return Object.fromEntries(entries);
+};

package/esm/parse/v3-1/response/toResponseV3.d.ts

@@ -0,0 +1,24 @@
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import { OasResponse } from '../../../oas/response/Response.js';
+import type { OasRef } from '../../../oas/ref/Ref.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToResponsesV3Args = {
+    responses: OpenAPIV3.ResponsesObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toResponsesV3: ({ responses, stackTrail, context }: ToResponsesV3Args) => Record<string, OasResponse | OasRef<"response">>;
+export type ToOptionalResponsesV3Args = {
+    responses: OpenAPIV3.ResponsesObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toOptionalResponsesV3: ({ responses, stackTrail, context }: ToOptionalResponsesV3Args) => Record<string, OasResponse | OasRef<"response">> | undefined;
+export type ToResponseV3Args = {
+    response: OpenAPIV3.ReferenceObject | OpenAPIV3.ResponseObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toResponseV3: ({ response, stackTrail, context }: ToResponseV3Args) => OasResponse | OasRef<"response">;
+//# sourceMappingURL=toResponseV3.d.ts.map

package/esm/parse/v3-1/response/toResponseV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toResponseV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/response/toResponseV3.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,SAAS,CAAC,eAAe,CAAA;IACpC,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,oCAI3B,iBAAiB,KAAG,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAkBrE,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAA;IAChD,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,oCAInC,yBAAyB,KAAG,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,SAMjF,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,cAAc,CAAA;IAC9D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,mCAI1B,gBAAgB,KAAG,WAAW,GAAG,MAAM,CAAC,UAAU,CAiCpD,CAAA"}

package/esm/parse/v3-1/response/toResponseV3.js

@@ -0,0 +1,52 @@
+import { toRefV31 } from '../ref/toRefV31.js';
+import { toHeadersV3 } from '../header/toHeadersV3.js';
+import { isRef } from '../../../helpers/refFns.js';
+import { toOptionalMediaTypeItemsV3 } from '../mediaType/toMediaTypeItemV3.js';
+import { OasResponse } from '../../../oas/response/Response.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { tryParseAt } from '../../../context/tryParseAt.js';
+export const toResponsesV3 = ({ responses, stackTrail, context }) => {
+    const output = {};
+    const entries = Object.entries(responses);
+    for (const [key, value] of entries) {
+        const parsed = tryParseAt({
+            stackTrail,
+            key,
+            context,
+            type: 'INVALID_RESPONSE',
+            parent: value,
+            fn: st => toResponseV3({ response: value, stackTrail: st, context })
+        });
+        if (parsed !== undefined) {
+            output[key] = parsed;
+        }
+    }
+    return output;
+};
+export const toOptionalResponsesV3 = ({ responses, stackTrail, context }) => {
+    if (!responses) {
+        return undefined;
+    }
+    return toResponsesV3({ responses, stackTrail, context });
+};
+export const toResponseV3 = ({ response, stackTrail, context }) => {
+    if (isRef(response)) {
+        return toRefV31({ ref: response, refType: 'response', stackTrail, context });
+    }
+    const { description, headers, content, ...skipped } = response;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: response,
+        context,
+        stackTrail,
+        parentType: 'response'
+    });
+    const parsedHeaders = stackTrail.trace('headers', st => toHeadersV3({ headers, stackTrail: st, context }));
+    const parsedContent = stackTrail.trace('content', st => toOptionalMediaTypeItemsV3({ content, stackTrail: st, context }));
+    return context.withStackTrail(stackTrail, () => new OasResponse({
+        description,
+        headers: parsedHeaders,
+        content: parsedContent,
+        extensionFields
+    }, context));
+};

package/esm/parse/v3-1/schema/toSchemasV3.d.ts

@@ -0,0 +1,30 @@
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import type { OpenAPIV3 } from 'openapi-types';
+import type { OasSchema } from '../../../oas/schema/Schema.js';
+import type { OasRef } from '../../../oas/ref/Ref.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToSchemasV3Args = {
+    schemas: Record<string, OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject>;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toSchemasV3: ({ schemas, stackTrail, context }: ToSchemasV3Args) => Record<string, OasSchema | OasRef<"schema">>;
+export type ToOptionalSchemasV3Args = {
+    schemas: Record<string, OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject> | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toOptionalSchemasV3: ({ schemas, stackTrail, context }: ToOptionalSchemasV3Args) => Record<string, OasSchema | OasRef<"schema">> | undefined;
+export type ToSchemaV3Args = {
+    schema: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toSchemaV3: ({ schema, stackTrail, context }: ToSchemaV3Args) => OasSchema | OasRef<"schema">;
+export type ToOptionalSchemaV3Args = {
+    schema: OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toOptionalSchemaV3: ({ schema, stackTrail, context }: ToOptionalSchemaV3Args) => OasSchema | OasRef<"schema"> | undefined;
+//# sourceMappingURL=toSchemasV3.d.ts.map

package/esm/parse/v3-1/schema/toSchemasV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSchemasV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/schema/toSchemasV3.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAarD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,CAAA;IAC3E,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,WAAW,GAAI,kCAIzB,eAAe,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAmB/D,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,GAAG,SAAS,CAAA;IACvF,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,kCAIjC,uBAAuB,KAAG,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,SAM3E,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,CAAA;IAC1D,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAuPD,eAAO,MAAM,UAAU,GAAI,iCAIxB,cAAc,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CA8O9C,CAAA;AA+CD,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAAA;IACtE,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,iCAIhC,sBAAsB,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,SAM1D,CAAA"}

package/esm/parse/v3-1/schema/toSchemasV3.js

@@ -0,0 +1,478 @@
+import { toRefV31 } from '../ref/toRefV31.js';
+import { isRef } from '../../../helpers/refFns.js';
+import { toArray } from '../array/toArray.js';
+import { toObject } from '../object/toObject.js';
+import { toInteger } from '../integer/toInteger.js';
+import { toNumber } from '../number/toNumber.js';
+import { toBoolean } from '../boolean/toBoolean.js';
+import { toString } from '../string/toString.js';
+import { toUnknown } from '../unknown/toUnknown.js';
+import { toUnion } from '../union/toUnion.js';
+import { toGetRef } from '../../../helpers/refFns.js';
+import { mergeIntersection } from '../_merge-all-of/merge-intersection.js';
+import { mergeUnion } from '../_merge-all-of/merge-union.js';
+import { tryParseAt } from '../../../context/tryParseAt.js';
+export const toSchemasV3 = ({ schemas, stackTrail, context }) => {
+    const output = {};
+    const entries = Object.entries(schemas);
+    for (const [key, schema] of entries) {
+        const value = tryParseAt({
+            stackTrail,
+            key,
+            context,
+            type: 'INVALID_SCHEMA',
+            parent: schema,
+            fn: st => toSchemaV3({ schema, stackTrail: st, context })
+        });
+        if (value !== undefined) {
+            output[key] = value;
+        }
+    }
+    return output;
+};
+export const toOptionalSchemasV3 = ({ schemas, stackTrail, context }) => {
+    if (!schemas) {
+        return undefined;
+    }
+    return toSchemasV3({ schemas, stackTrail, context });
+};
+/**
+ * OpenAPI 3.1 lets a schema's `type` be an ARRAY (e.g. `['string', 'null']`),
+ * which the shared IR — modelling a single `type` plus a `nullable` flag —
+ * does not. Normalize the array form into shapes the rest of the dispatcher
+ * already understands:
+ *
+ *   - `['T', 'null']`   (one non-null type)  → `{ type: 'T', nullable: true }`
+ *   - `['T1', 'T2', …]` (several non-null)   → a `oneOf` of the bare types,
+ *     i.e. the 3.1 multi-type union. 3.0 cannot express this — it is the
+ *     CASE-2 gap where the v3-0 parser degrades to OasUnknown.
+ *   - `['null']`        (only null)          → left unchanged → OasUnknown,
+ *     since there is no first-class OasNull IR node yet (a documented gap).
+ *
+ * The hoisted `nullable` flag is the IR's representation of nullability; the
+ * leaf parsers read it via `parseNullable`. A non-array `type` passes through.
+ */
+const normalizeTypeArray = (schema) => {
+    const rawType = schema.type;
+    if (!Array.isArray(rawType)) {
+        return schema;
+    }
+    const members = rawType.filter(member => member !== 'null');
+    const nullable = rawType.length !== members.length || schema.nullable;
+    // Only `null` (`type: ['null']`): no OasNull node yet — fall through.
+    if (members.length === 0) {
+        return schema;
+    }
+    // Several non-null types: a 3.1 multi-type union. Model it as a `oneOf`
+    // of the bare types and let the oneOf branch build the OasUnion.
+    if (members.length > 1) {
+        const { type: _type, ...rest } = schema;
+        return { ...rest, nullable, oneOf: members.map(member => ({ type: member })) };
+    }
+    // Exactly one non-null type: dispatch as that type, carrying nullability.
+    switch (members[0]) {
+        case 'object':
+        case 'integer':
+        case 'number':
+        case 'boolean':
+        case 'string':
+            return { ...schema, type: members[0], nullable };
+        case 'array':
+            return 'items' in schema ? { ...schema, type: members[0], nullable } : schema;
+        default:
+            return schema;
+    }
+};
+/**
+ * OpenAPI 3.1 `const: X` is the single-value form of `enum` (3.0 expresses a
+ * literal as a one-element `enum`). Rewrite it so the existing enum-aware leaf
+ * parsers handle it; matches down-convert's `convertConstToEnum`, so a 3.0
+ * `enum:[X]` and a 3.1 `const:X` land on the same IR.
+ */
+const normalizeConst = (schema) => {
+    if (!('const' in schema)) {
+        return schema;
+    }
+    // `const` is a 3.1 keyword the 3.0-typed SchemaObject does not model; read
+    // it via an annotated destructure rather than a cast.
+    const { const: constValue, ...rest } = schema;
+    return { ...rest, enum: [constValue] };
+};
+/**
+ * OpenAPI 3.1 schemas carry `examples` (an array, JSON Schema 2020-12); 3.0
+ * and the IR use a single `example`. Adopt the first array element as the IR
+ * `example` when no singular `example` is set, and drop the array. Matches
+ * down-convert's `convertJsonSchemaExamples`.
+ */
+const normalizeExamples = (schema) => {
+    if ('example' in schema || !('examples' in schema)) {
+        return schema;
+    }
+    // `examples` is a 3.1 keyword the 3.0-typed SchemaObject does not model.
+    const { examples, ...rest } = schema;
+    if (!Array.isArray(examples) || examples.length === 0) {
+        return rest;
+    }
+    return { ...rest, example: examples[0] };
+};
+/**
+ * OpenAPI 3.1 expresses exclusive bounds as NUMBERS (`exclusiveMinimum: 5`
+ * means "> 5"); the shared IR (and 3.0) model them as a boolean flag paired
+ * with `minimum`/`maximum`. Convert the numeric form so the number/integer
+ * leaves validate. Matches down-convert's `convertExclusiveMinMax`, so a 3.0
+ * `{minimum:5, exclusiveMinimum:true}` and a 3.1 `{exclusiveMinimum:5}` land
+ * on the same IR.
+ */
+const normalizeExclusiveBounds = (schema) => {
+    // `exclusiveMinimum`/`exclusiveMaximum` are 3.0-typed boolean here; in 3.1
+    // they arrive as numbers, so read them loosely.
+    const exclusiveMinimum = schema.exclusiveMinimum;
+    const exclusiveMaximum = schema.exclusiveMaximum;
+    if (typeof exclusiveMinimum !== 'number' && typeof exclusiveMaximum !== 'number') {
+        return schema;
+    }
+    const next = { ...schema };
+    if (typeof exclusiveMinimum === 'number') {
+        next.minimum = exclusiveMinimum;
+        next.exclusiveMinimum = true;
+    }
+    if (typeof exclusiveMaximum === 'number') {
+        next.maximum = exclusiveMaximum;
+        next.exclusiveMaximum = true;
+    }
+    return next;
+};
+/**
+ * OpenAPI 3.1 / JSON Schema 2020-12 expresses a binary string payload with
+ * `contentMediaType: 'application/octet-stream'` and base64 with
+ * `contentEncoding: 'base64'`; the shared IR (and 3.0) carry these as a string
+ * `format` (`binary` / `byte`, both in the format allow-list). Map them so the
+ * format reaches the IR. Mirrors down-convert's
+ * `convertJsonSchemaContentMediaType` / `convertJsonSchemaContentEncoding`:
+ * string schemas only, and a pre-existing (conflicting) `format` wins — the
+ * content keyword is dropped, not overwritten. Without this, retiring
+ * down-convert would silently lose the `format` signal on 3.1 binary uploads.
+ */
+const normalizeContentFormat = (schema) => {
+    if (schema.type !== 'string') {
+        return schema;
+    }
+    // `contentMediaType`/`contentEncoding` are 3.1 keywords the 3.0-typed
+    // SchemaObject does not model; read them loosely.
+    const view = schema;
+    const derivedFormat = view.contentMediaType === 'application/octet-stream'
+        ? 'binary'
+        : view.contentEncoding === 'base64'
+            ? 'byte'
+            : undefined;
+    if (derivedFormat === undefined) {
+        return schema;
+    }
+    const { contentMediaType: _contentMediaType, contentEncoding: _contentEncoding, ...rest } = view;
+    return 'format' in rest ? rest : { ...rest, format: derivedFormat };
+};
+/**
+ * Map the 3.1-only schema-shape encodings onto the shared IR shape before
+ * dispatching: type arrays, `const`, `examples[]`, numeric exclusive bounds,
+ * and binary/base64 content keywords. Each step returns its input unchanged
+ * when it does not apply, so the composed result is referentially equal to
+ * `schema` when nothing matched — letting the dispatcher re-dispatch only when
+ * needed.
+ */
+const normalizeSchemaShape = (schema) => {
+    return normalizeExclusiveBounds(normalizeExamples(normalizeConst(normalizeContentFormat(normalizeTypeArray(schema)))));
+};
+/**
+ * Is this a 3.1 `{ type: 'null' }` schema member? (`'null'` is a 3.1 type
+ * literal the 3.0-typed SchemaObject does not model, so read it loosely.)
+ */
+const isNullTypeSchema = (member) => {
+    if (isRef(member)) {
+        return false;
+    }
+    const type = member.type;
+    return type === 'null';
+};
+/**
+ * Split `oneOf`/`anyOf` members into the non-null members plus whether a
+ * `{ type: 'null' }` member was present. In 3.1 that null member is how a
+ * union expresses nullability (3.0 used the hoisted `nullable` keyword);
+ * folding it into a flag lets the collapse/union logic stay unchanged.
+ */
+const partitionNullMember = (members) => {
+    const nonNull = members.filter(member => !isNullTypeSchema(member));
+    return { members: nonNull, nullable: nonNull.length !== members.length };
+};
+/**
+ * Collapse a single-member `oneOf`/`anyOf` into its surviving member.
+ *
+ * The wrapper's sibling keywords must ride into the member rather than
+ * being discarded. The critical one is `nullable`: the 3.1 idiom
+ * `oneOf:[{type:'string'},{type:'null'}]` ("string or null") has its
+ * `{type:'null'}` member folded out by `partitionNullMember` above, leaving
+ * `oneOf:[{type:'string'}]` + `nullable:true` on the wrapper. Re-dispatching
+ * `members[0]` alone would drop the wrapper (`...value`) and silently turn
+ * `string | null` back into a non-nullable `string`.
+ * `description`/`title`/`readOnly`/... ride along the same way.
+ *
+ * Precedence: the member is the more specific schema, so it wins direct
+ * conflicts (`{ ...value, ...member }`). `nullable` is the exception — it
+ * OR-ins, because a nullable wrapper makes the whole schema nullable even
+ * when the member itself is not.
+ *
+ * A ref member only reaches here when the wrapper carries no `nullable`
+ * (the nullable-ref case stamps `nullable` on the OasRef node at the call
+ * site, via `toRefV31`). Any other wrapper siblings on a bare `$ref` are
+ * ignored per 3.0 ref semantics, so the ref is returned untouched.
+ */
+const collapseSingleMember = (value, member) => {
+    if (isRef(member)) {
+        return member;
+    }
+    const merged = { ...value, ...member };
+    if (value.nullable || member.nullable) {
+        merged.nullable = true;
+    }
+    return merged;
+};
+export const toSchemaV3 = ({ schema, stackTrail, context }) => {
+    if (isRef(schema)) {
+        return toRefV31({ ref: schema, refType: 'schema', stackTrail, context });
+    }
+    const normalized = normalizeSchemaShape(schema);
+    if (normalized !== schema) {
+        return toSchemaV3({ schema: normalized, stackTrail, context });
+    }
+    if ('allOf' in schema && Array.isArray(schema.allOf)) {
+        return stackTrail.trace('allOf', st => {
+            const merged = mergeIntersection({
+                schema,
+                getRef: toGetRef(context.documentObject)
+            });
+            return toSchemaV3({ schema: merged, stackTrail: st, context });
+        });
+    }
+    if ('oneOf' in schema && Array.isArray(schema.oneOf)) {
+        return stackTrail.trace('oneOf', st => {
+            // 3.1: a `{ type: 'null' }` member makes the union nullable. Fold it
+            // into a `nullable` flag the collapse/union logic already understands.
+            const { members: oneOfWithoutNull, nullable: hasNullMember } = partitionNullMember(schema.oneOf ?? []);
+            const withoutNull = hasNullMember
+                ? { ...schema, oneOf: oneOfWithoutNull, nullable: true }
+                : schema;
+            const merged = mergeUnion({
+                schema: withoutNull,
+                getRef: toGetRef(context.documentObject),
+                groupType: 'oneOf'
+            });
+            if (!('oneOf' in merged) || !Array.isArray(merged.oneOf)) {
+                throw new Error('Missing "oneOf" array');
+            }
+            const { oneOf: members, ...value } = merged;
+            if (members.length === 0) {
+                throw new Error('"oneOf" array is empty');
+            }
+            if (members.length === 1) {
+                const [soleMember] = members;
+                // A 3.1 nullable reference `oneOf:[{$ref},{type:'null'}]` becomes a
+                // single `$ref` member + `nullable:true` once the null member above
+                // is folded out. Nullability here is a *use-site* property — the same
+                // refName may be referenced nullable at one site and not another — so
+                // it rides the OasRef node itself, NOT the shared referent and NOT a
+                // synthetic union. Generators read `ref.nullable` and render
+                // `Foo | null`; `ModelDriver` builds the un-nullable shared `Foo` from
+                // the refName. See
+                // notes/openapi-3.1-webhooks-and-parser-architecture.md §3.4.
+                if (isRef(soleMember) && value.nullable) {
+                    return toRefV31({
+                        ref: soleMember,
+                        refType: 'schema',
+                        nullable: true,
+                        stackTrail: st,
+                        context
+                    });
+                }
+                return toSchemaV3({
+                    schema: collapseSingleMember(value, soleMember),
+                    stackTrail: st,
+                    context
+                });
+            }
+            return toUnion({ value, members, parentType: 'oneOf', stackTrail: st, context });
+        });
+    }
+    if ('anyOf' in schema && Array.isArray(schema.anyOf)) {
+        return stackTrail.trace('anyOf', st => {
+            // deno-lint-ignore ban-ts-comment
+            // @ts-expect-error
+            if (schema['x-expansionResources'] && Array.isArray(schema.anyOf)) {
+                const { anyOf, ...value } = schema;
+                return toUnion({ value, members: anyOf, parentType: 'anyOf', stackTrail: st, context });
+            }
+            // 3.1: a `{ type: 'null' }` member makes the union nullable (mirrors
+            // the oneOf branch above).
+            const { members: anyOfWithoutNull, nullable: hasNullMember } = partitionNullMember(schema.anyOf ?? []);
+            const withoutNull = hasNullMember
+                ? { ...schema, anyOf: anyOfWithoutNull, nullable: true }
+                : schema;
+            const merged = mergeUnion({
+                schema: withoutNull,
+                getRef: toGetRef(context.documentObject),
+                groupType: 'anyOf'
+            });
+            if (!('anyOf' in merged) || !Array.isArray(merged.anyOf)) {
+                throw new Error('Missing "anyOf" array');
+            }
+            const { anyOf: members, ...value } = merged;
+            if (members.length === 0) {
+                throw new Error('"anyOf" array is empty');
+            }
+            if (members.length === 1) {
+                const [soleMember] = members;
+                // See the oneOf branch: a single `$ref` carrying a hoisted `nullable`
+                // sets `nullable` on the OasRef node itself.
+                if (isRef(soleMember) && value.nullable) {
+                    return toRefV31({
+                        ref: soleMember,
+                        refType: 'schema',
+                        nullable: true,
+                        stackTrail: st,
+                        context
+                    });
+                }
+                return toSchemaV3({
+                    schema: collapseSingleMember(value, soleMember),
+                    stackTrail: st,
+                    context
+                });
+            }
+            return toUnion({ value, members, parentType: 'anyOf', stackTrail: st, context });
+        });
+    }
+    if ('type' in schema) {
+        switch (schema.type) {
+            case 'object':
+                return toObject({ value: schema, stackTrail, context });
+            case 'array':
+                return toArray({ value: schema, stackTrail, context });
+            case 'integer':
+                return toInteger({ value: schema, stackTrail, context });
+            case 'number':
+                return toNumber({ value: schema, stackTrail, context });
+            case 'boolean':
+                return toBoolean({ value: schema, stackTrail, context });
+            case 'string':
+                return toString({ value: schema, stackTrail, context });
+        }
+    }
+    // Otherwise cases
+    if (possibleObject(schema)) {
+        context.logIssueNoKey({
+            level: 'warning',
+            message: 'Object has "properties" property, but is missing type="object" property',
+            parent: schema,
+            stackTrail,
+            type: 'MISSING_OBJECT_TYPE'
+        });
+        return toObject({
+            value: {
+                ...schema,
+                type: 'object'
+            },
+            stackTrail,
+            context
+        });
+    }
+    if (possibleArray(schema)) {
+        context.logIssueNoKey({
+            level: 'warning',
+            message: 'Object has "items" property, but is missing type="array" property',
+            parent: schema,
+            stackTrail,
+            type: 'MISSING_ARRAY_TYPE'
+        });
+        return toArray({
+            value: {
+                ...schema,
+                type: 'array'
+                // Adding cast here since {} is a valid value for items
+            },
+            stackTrail,
+            context
+        });
+    }
+    if (possibleBoolean(schema)) {
+        context.logIssueNoKey({
+            level: 'warning',
+            message: 'Object has a boolean "default" or "example" property, but is missing type="boolean" property',
+            parent: schema,
+            stackTrail,
+            type: 'MISSING_BOOLEAN_TYPE'
+        });
+        return toBoolean({
+            value: {
+                ...schema,
+                type: 'boolean'
+            },
+            stackTrail,
+            context
+        });
+    }
+    if (possibleString(schema)) {
+        context.logIssueNoKey({
+            level: 'warning',
+            message: 'Object has a string "default" or "example" property, but is missing type="string" property',
+            parent: schema,
+            stackTrail,
+            type: 'MISSING_STRING_TYPE'
+        });
+        return toString({
+            value: {
+                ...schema,
+                type: 'string'
+            },
+            stackTrail,
+            context
+        });
+    }
+    return toUnknown({ value: schema, stackTrail, context });
+};
+const possibleString = (value) => {
+    return (value &&
+        typeof value === 'object' &&
+        (('default' in value && typeof value.default === 'string') ||
+            ('example' in value && typeof value.example === 'string') ||
+            ('enum' in value &&
+                Array.isArray(value.enum) &&
+                value.enum.every(item => typeof item === 'string')) ||
+            ('format' in value &&
+                typeof value.format === 'string' &&
+                ['date', 'date-time', 'binary', 'byte'].includes(value.format))));
+};
+const possibleBoolean = (value) => {
+    return (value &&
+        typeof value === 'object' &&
+        (('default' in value && typeof value.default === 'boolean') ||
+            ('example' in value && typeof value.example === 'boolean')));
+};
+const possibleArray = (value) => {
+    return (value &&
+        typeof value === 'object' &&
+        'items' in value &&
+        value.items &&
+        typeof value.items === 'object' &&
+        value.items);
+};
+const possibleObject = (value) => {
+    return (value &&
+        typeof value === 'object' &&
+        'properties' in value &&
+        typeof value.properties === 'object' &&
+        value.properties);
+};
+export const toOptionalSchemaV3 = ({ schema, stackTrail, context }) => {
+    if (!schema) {
+        return undefined;
+    }
+    return toSchemaV3({ schema, stackTrail, context });
+};

package/esm/parse/v3-1/securityRequirement/toSecurityRequirement.d.ts

@@ -0,0 +1,10 @@
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasSecurityRequirement } from '../../../oas/securityRequirement/SecurityRequirement.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToSecurityRequirementsV3Args = {
+    security: Record<string, string[]>[] | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toSecurityRequirementsV3: ({ security, stackTrail, context }: ToSecurityRequirementsV3Args) => OasSecurityRequirement[] | undefined;
+//# sourceMappingURL=toSecurityRequirement.d.ts.map

package/esm/parse/v3-1/securityRequirement/toSecurityRequirement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toSecurityRequirement.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/securityRequirement/toSecurityRequirement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAA;AAChG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,4BAA4B,GAAG;IACzC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,SAAS,CAAA;IAChD,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,mCAItC,4BAA4B,KAAG,sBAAsB,EAAE,GAAG,SAQ5D,CAAA"}

package/esm/parse/v3-1/securityRequirement/toSecurityRequirement.js

@@ -0,0 +1,9 @@
+import { OasSecurityRequirement } from '../../../oas/securityRequirement/SecurityRequirement.js';
+export const toSecurityRequirementsV3 = ({ security, stackTrail, context }) => {
+    if (!security) {
+        return undefined;
+    }
+    return security.map(requirement => {
+        return new OasSecurityRequirement({ requirement }, context.oasDocument);
+    });
+};