@skmtc/core 0.0.983 → 0.16.1

package/esm/parse/v3-1/number/toNumber.js

@@ -0,0 +1,112 @@
+import { OasNumber } from '../../../oas/number/Number.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { oasNumberData, numberFormat } from '../../../oas/number/number-types.js';
+import { parseNullable } from '../_helpers/parseNullable.js';
+import { parseEnum } from '../_helpers/parseEnum.js';
+import { parseExample } from '../_helpers/parseExample.js';
+import { parseDefault } from '../_helpers/parseDefault.js';
+import * as v from 'valibot';
+export const toNumber = ({ context, value, stackTrail }) => {
+    const { nullable, value: valueWithoutNullable } = parseNullable({
+        value,
+        context,
+        stackTrail
+    });
+    const { example: unparsedExample, ...valueWithoutExample } = valueWithoutNullable;
+    const example = parseExample({
+        value: unparsedExample,
+        context,
+        parent: valueWithoutNullable,
+        nullable,
+        check: isNumber,
+        toMessage: item => `Removed invalid example. Expected "number", got: ${item}`,
+        stackTrail
+    });
+    const { enum: unparsedEnums, ...valueWithoutEnums } = valueWithoutExample;
+    const enums = parseEnum({
+        value: unparsedEnums,
+        nullable,
+        stackTrail,
+        parent: valueWithoutExample,
+        context,
+        check: isNumber,
+        toMessage: item => `Removed invalid enum. Expected "number", got: ${item}`
+    });
+    const { default: unparsedDefaultValue, ...valueWithoutDefault } = valueWithoutEnums;
+    const defaultValue = parseDefault({
+        value: unparsedDefaultValue,
+        context,
+        parent: valueWithoutEnums,
+        nullable,
+        check: isNumber,
+        toMessage: item => `Removed invalid default. Expected "number", got: ${item}`,
+        stackTrail
+    });
+    return toParsedNumber({
+        context,
+        nullable,
+        example,
+        enums,
+        defaultValue,
+        value: valueWithoutDefault,
+        stackTrail
+    });
+};
+const toParsedNumber = ({ context, nullable, example, enums, defaultValue, value: valueWithoutEnums, stackTrail }) => {
+    const { format: unparsedFormat, ...valueWithoutFormat } = valueWithoutEnums;
+    const format = parseNumberFormat({
+        format: unparsedFormat,
+        context,
+        stackTrail,
+        parent: valueWithoutEnums
+    });
+    if (!v.is(oasNumberData, valueWithoutFormat)) {
+        v.parse(oasNumberData, valueWithoutFormat);
+    }
+    const { type: _type, title, description, multipleOf, maximum, exclusiveMaximum, minimum, exclusiveMinimum, readOnly, writeOnly, deprecated, ...skipped } = valueWithoutFormat;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: valueWithoutFormat,
+        context,
+        stackTrail,
+        parentType: 'schema:number'
+    });
+    return context.withStackTrail(stackTrail, () => new OasNumber({
+        title,
+        description,
+        nullable,
+        default: defaultValue,
+        extensionFields,
+        example,
+        enums,
+        format,
+        multipleOf,
+        maximum,
+        exclusiveMaximum,
+        minimum,
+        readOnly,
+        writeOnly,
+        exclusiveMinimum,
+        deprecated
+    }, context));
+};
+const parseNumberFormat = ({ format, context, parent, stackTrail }) => {
+    if (format === undefined) {
+        return undefined;
+    }
+    if (!v.is(numberFormat, format)) {
+        context.logIssue({
+            key: 'format',
+            level: 'warning',
+            message: `Invalid format: ${format}`,
+            parent,
+            stackTrail,
+            type: 'INVALID_FORMAT'
+        });
+        return undefined;
+    }
+    return format;
+};
+const isNumber = (value) => {
+    return typeof value === 'number';
+};

package/esm/parse/v3-1/object/toAdditionalPropertiesV3.d.ts

@@ -0,0 +1,12 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+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 ToAdditionalPropertiesV3Args = {
+    additionalProperties: boolean | OpenAPIV3.ReferenceObject | OpenAPIV3.SchemaObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toAdditionalPropertiesV3: ({ additionalProperties, stackTrail, context }: ToAdditionalPropertiesV3Args) => OasSchema | OasRef<"schema"> | boolean | undefined;
+//# sourceMappingURL=toAdditionalPropertiesV3.d.ts.map

package/esm/parse/v3-1/object/toAdditionalPropertiesV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toAdditionalPropertiesV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/object/toAdditionalPropertiesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AAC9D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,4BAA4B,GAAG;IACzC,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAAA;IAC9F,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,+CAItC,4BAA4B,KAAG,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,SAU1E,CAAA"}

package/esm/parse/v3-1/object/toAdditionalPropertiesV3.js

@@ -0,0 +1,10 @@
+import { toSchemaV3 } from '../schema/toSchemasV3.js';
+export const toAdditionalPropertiesV3 = ({ additionalProperties, stackTrail, context }) => {
+    if (typeof additionalProperties === 'boolean') {
+        return additionalProperties;
+    }
+    if (additionalProperties === undefined) {
+        return undefined;
+    }
+    return toSchemaV3({ schema: additionalProperties, stackTrail, context });
+};

package/esm/parse/v3-1/object/toObject.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasObject } from '../../../oas/object/Object.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToObjectArgs = {
+    value: OpenAPIV3.SchemaObject;
+    context: ParseContextType;
+    stackTrail: StackTrail;
+};
+export declare const toObject: ({ value, context, stackTrail }: ToObjectArgs) => OasObject;
+//# sourceMappingURL=toObject.d.ts.map

package/esm/parse/v3-1/object/toObject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toObject.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/object/toObject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAA;AASzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,SAAS,CAAC,YAAY,CAAA;IAC7B,OAAO,EAAE,gBAAgB,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,gCAAgC,YAAY,KAAG,SAoDvE,CAAA"}

package/esm/parse/v3-1/object/toObject.js

@@ -0,0 +1,88 @@
+import { OasObject } from '../../../oas/object/Object.js';
+import { toOptionalSchemasV3 } from '../schema/toSchemasV3.js';
+import { toAdditionalPropertiesV3 } from './toAdditionalPropertiesV3.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { parseNullable } from '../_helpers/parseNullable.js';
+import { parseEnum } from '../_helpers/parseEnum.js';
+import { parseExample } from '../_helpers/parseExample.js';
+import { parseDefault } from '../_helpers/parseDefault.js';
+export const toObject = ({ value, context, stackTrail }) => {
+    const { nullable, value: valueWithoutNullable } = parseNullable({
+        value,
+        context,
+        stackTrail
+    });
+    const { example: unparsedExample, ...valueWithoutExample } = valueWithoutNullable;
+    const example = parseExample({
+        value: unparsedExample,
+        context,
+        parent: valueWithoutNullable,
+        nullable,
+        check: isObject,
+        toMessage: item => `Removed invalid example. Expected "object", got: ${item}`,
+        stackTrail
+    });
+    const { enum: unparsedEnums, ...valueWithoutEnums } = valueWithoutExample;
+    const enums = parseEnum({
+        value: unparsedEnums,
+        nullable,
+        parent: valueWithoutExample,
+        context,
+        stackTrail,
+        check: isObject,
+        toMessage: item => `Removed invalid enum. Expected "object", got: ${item}`
+    });
+    const { default: unparsedDefaultValue, ...valueWithoutDefault } = valueWithoutEnums;
+    const defaultValue = parseDefault({
+        value: unparsedDefaultValue,
+        context,
+        parent: valueWithoutEnums,
+        nullable,
+        check: isObject,
+        toMessage: item => `Removed invalid default. Expected "object", got: ${item}`,
+        stackTrail
+    });
+    return toParsedObject({
+        context,
+        nullable,
+        example,
+        enums,
+        defaultValue,
+        value: valueWithoutDefault,
+        stackTrail
+    });
+};
+const toParsedObject = ({ context, stackTrail, nullable, example, enums, defaultValue, value }) => {
+    const { type: _type, title, description, deprecated, properties, required, maxProperties, minProperties, additionalProperties, readOnly, writeOnly, ...skipped } = value;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: value,
+        context,
+        stackTrail,
+        parentType: 'schema:object'
+    });
+    return context.withStackTrail(stackTrail, () => new OasObject({
+        title,
+        description,
+        nullable,
+        example,
+        enums,
+        properties: stackTrail.trace('properties', st => toOptionalSchemasV3({
+            schemas: properties,
+            stackTrail: st,
+            context
+        })),
+        required,
+        maxProperties,
+        minProperties,
+        additionalProperties: stackTrail.trace('additionalProperties', st => toAdditionalPropertiesV3({ additionalProperties, stackTrail: st, context })),
+        extensionFields,
+        default: defaultValue,
+        deprecated,
+        readOnly,
+        writeOnly
+    }, context));
+};
+const isObject = (value) => {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+};

package/esm/parse/v3-1/operation/toOperationsV3.d.ts

@@ -0,0 +1,26 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { Method } from '../../../types/Method.js';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasOperation } from '../../../oas/operation/Operation.js';
+import type { OasPathItem } from '../../../oas/pathItem/PathItem.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+type OperationInfo = {
+    method: Method;
+    path: string;
+    pathItem: OasPathItem | undefined;
+};
+export type ToOperationV3Args = {
+    operation: OpenAPIV3.OperationObject;
+    operationInfo: OperationInfo;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toOperationV3: ({ operation, operationInfo, stackTrail, context }: ToOperationV3Args) => OasOperation;
+export type ToOperationsV3Args = {
+    paths: OpenAPIV3.PathsObject | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toOperationsV3: ({ paths, stackTrail, context }: ToOperationsV3Args) => OasOperation[];
+export {};
+//# sourceMappingURL=toOperationsV3.d.ts.map

package/esm/parse/v3-1/operation/toOperationsV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toOperationsV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/operation/toOperationsV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAItE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAOpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAEhE,KAAK,aAAa,GAAG;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,WAAW,GAAG,SAAS,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,SAAS,CAAC,eAAe,CAAA;IACpC,aAAa,EAAE,aAAa,CAAA;IAC5B,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAOD,eAAO,MAAM,aAAa,GAAI,mDAK3B,iBAAiB,KAAG,YAmEtB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAG/B,KAAK,EAAE,SAAS,CAAC,WAAW,GAAG,SAAS,CAAA;IACxC,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,gCAI5B,kBAAkB,KAAG,YAAY,EAiFnC,CAAA"}

package/esm/parse/v3-1/operation/toOperationsV3.js

@@ -0,0 +1,116 @@
+import { toRequestBodyV3 } from '../requestBody/toRequestBodiesV3.js';
+import { toResponsesV3 } from '../response/toResponseV3.js';
+import { toParameterListV3 } from '../parameter/toParameterV3.js';
+import { OasOperation } from '../../../oas/operation/Operation.js';
+import { toPathItemV3 } from '../pathItem/toPathItemV3.js';
+import { methodValues } from '../../../types/Method.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import { toSecurityRequirementsV3 } from '../securityRequirement/toSecurityRequirement.js';
+import { isEmpty } from '../../../helpers/isEmpty.js';
+import { toExternalDocs } from '../externalDocs/toExternalDocs.js';
+import { toOptionalServersV3 } from '../server/toServerV3.js';
+export const toOperationV3 = ({ operation, operationInfo, stackTrail, context }) => {
+    const { method, path, pathItem } = operationInfo;
+    const { operationId, tags, summary, description, parameters, requestBody, responses, deprecated, security, externalDocs, servers, ...skipped } = operation;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: operation,
+        context,
+        stackTrail,
+        parentType: 'operation'
+    });
+    const parsedParameters = stackTrail.trace('parameters', st => toParameterListV3({ parameters, stackTrail: st, context }));
+    const parsedRequestBody = stackTrail.trace('requestBody', st => toRequestBodyV3({ requestBody, stackTrail: st, context }));
+    const parsedResponses = stackTrail.trace('responses', st => toResponsesV3({ responses, stackTrail: st, context }));
+    const parsedSecurity = stackTrail.trace('security', st => toSecurityRequirementsV3({ security, stackTrail: st, context }));
+    const parsedExternalDocs = stackTrail.trace('externalDocs', st => toExternalDocs({ externalDocs, stackTrail: st, context }));
+    const parsedServers = stackTrail.trace('servers', st => toOptionalServersV3({ servers, stackTrail: st, context }));
+    return context.withStackTrail(stackTrail, () => new OasOperation({
+        pathItem,
+        path,
+        method,
+        operationId,
+        summary,
+        tags,
+        description,
+        parameters: parsedParameters,
+        requestBody: parsedRequestBody,
+        responses: parsedResponses,
+        deprecated,
+        security: parsedSecurity,
+        externalDocs: parsedExternalDocs,
+        servers: parsedServers,
+        extensionFields
+    }, context));
+};
+export const toOperationsV3 = ({ paths, stackTrail, context }) => {
+    if (!paths) {
+        return [];
+    }
+    return Object.entries(paths).flatMap(([path, pathItem]) => {
+        return stackTrail.trace(path, pathStack => {
+            if (!pathItem) {
+                return [];
+            }
+            const cleaned = Object.entries(pathItem).reduce(({ rest, methodObject }, [key, operation]) => {
+                const isMethod = methodValues.includes(key);
+                if (isMethod) {
+                    const { [key]: _deleted, ...remaining } = rest;
+                    return {
+                        rest: remaining,
+                        methodObject: {
+                            ...methodObject,
+                            [key]: operation
+                        }
+                    };
+                }
+                return { rest, methodObject };
+            }, {
+                rest: pathItem,
+                methodObject: {}
+            });
+            const pathItemObject = !isEmpty(cleaned.rest)
+                ? toPathItemV3({ pathItem: cleaned.rest, stackTrail: pathStack, context })
+                : undefined;
+            return Object.entries(cleaned.methodObject)
+                .map(([method, operation]) => {
+                // Use `pathStack` (the trail with `path` already pushed),
+                // not the outer `stackTrail` — otherwise downstream traces
+                // record paths:<method>:... and lose the actual path
+                // segment, which breaks `OasDocument.removeItem` and the
+                // dependency-ref invalidation it backs.
+                return pathStack.trace(method, st => {
+                    if (!operation) {
+                        return;
+                    }
+                    try {
+                        return toOperationV3({
+                            operation,
+                            operationInfo: {
+                                method: method,
+                                path,
+                                pathItem: pathItemObject
+                            },
+                            stackTrail: st,
+                            context
+                        });
+                    }
+                    catch (error) {
+                        const normalized = error instanceof Error ? error : new Error(String(error));
+                        context.logIssue({
+                            key: method,
+                            parent: operation,
+                            level: 'error',
+                            message: normalized.message,
+                            cause: normalized,
+                            stackTrail: st,
+                            type: 'INVALID_OPERATION'
+                        });
+                        return undefined;
+                    }
+                });
+            })
+                .filter((item) => Boolean(item));
+        });
+    });
+};

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

@@ -0,0 +1,40 @@
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { type OasParameterLocation } 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';
+export type ToParameterListV3Args = {
+    parameters: (OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject)[] | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toParameterListV3: ({ parameters, stackTrail, context }: ToParameterListV3Args) => (OasParameter | OasRef<"parameter">)[] | undefined;
+export type ToParametersV3Args = {
+    parameters: Record<string, OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject>;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toParametersV3: ({ parameters, stackTrail, context }: ToParametersV3Args) => Record<string, OasParameter | OasRef<"parameter">>;
+export type ToOptionalParametersV3Args = {
+    parameters: Record<string, OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject> | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toOptionalParametersV3: ({ parameters, stackTrail, context }: ToOptionalParametersV3Args) => Record<string, OasParameter | OasRef<"parameter">> | undefined;
+export type ToParameterV3Args = {
+    parameter: OpenAPIV3.ParameterObject | OpenAPIV3.ReferenceObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export type ToStyleArgs = {
+    style: string | undefined;
+    location: OasParameterLocation;
+    stackTrail: StackTrail;
+};
+export type ToExplodeArgs = {
+    explode: boolean | undefined;
+    style: string | undefined;
+    stackTrail: StackTrail;
+};
+//# sourceMappingURL=toParameterV3.d.ts.map

package/esm/parse/v3-1/parameter/toParameterV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toParameterV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/parameter/toParameterV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAGtE,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,2CAA2C,CAAA;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAK9C,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,qBAAqB,GAAG;IAClC,UAAU,EAAE,CAAC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC,EAAE,GAAG,SAAS,CAAA;IACjF,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,qCAI/B,qBAAqB,KAAG,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,EAAE,GAAG,SAQnE,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC,CAAA;IACjF,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,qCAI5B,kBAAkB,KAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAiBxE,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAC,GAAG,SAAS,CAAA;IAC7F,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,qCAIpC,0BAA0B,KAAG,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,SAMpF,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,eAAe,CAAA;IAChE,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AA+ED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,QAAQ,EAAE,oBAAoB,CAAA;IAC9B,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAsBD,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA"}

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

@@ -0,0 +1,112 @@
+import { tryParseAt } from '../../../context/tryParseAt.js';
+import { isRef } from '../../../helpers/refFns.js';
+import { oasParameterLocation, oasParameterStyle } from '../../../oas/parameter/parameter-types.js';
+import { toExamplesV3 } from '../example/toExamplesV3.js';
+import { toRefV31 } from '../ref/toRefV31.js';
+import { toOptionalSchemaV3 } from '../schema/toSchemasV3.js';
+import { toOptionalMediaTypeItemsV3 } from '../mediaType/toMediaTypeItemV3.js';
+import { OasParameter } from '../../../oas/parameter/Parameter.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+import * as v from 'valibot';
+export const toParameterListV3 = ({ parameters, stackTrail, context }) => {
+    if (!parameters) {
+        return undefined;
+    }
+    return parameters.map((parameter, index) => {
+        return stackTrail.trace(`${index}`, st => toParameterV3({ parameter, stackTrail: st, context }));
+    });
+};
+export const toParametersV3 = ({ parameters, stackTrail, context }) => {
+    const output = {};
+    const entries = Object.entries(parameters);
+    for (const [key, parameter] of entries) {
+        const parsed = tryParseAt({
+            stackTrail,
+            key,
+            context,
+            type: 'INVALID_PARAMETER',
+            parent: parameter,
+            fn: st => toParameterV3({ parameter, stackTrail: st, context })
+        });
+        if (parsed !== undefined) {
+            output[key] = parsed;
+        }
+    }
+    return output;
+};
+export const toOptionalParametersV3 = ({ parameters, stackTrail, context }) => {
+    if (!parameters) {
+        return undefined;
+    }
+    return toParametersV3({ parameters, stackTrail, context });
+};
+const toParameterV3 = ({ parameter, stackTrail, context }) => {
+    if (isRef(parameter)) {
+        return toRefV31({ ref: parameter, refType: 'parameter', stackTrail, context });
+    }
+    const { name, in: location, description, required, deprecated, allowEmptyValue, allowReserved, schema, example, examples, content, style, explode, ...skipped } = parameter;
+    const extensionFields = toSpecificationExtensionsV3({
+        skipped,
+        parent: parameter,
+        context,
+        stackTrail,
+        parentType: 'parameter'
+    });
+    const parsedLocation = v.parse(oasParameterLocation, location);
+    if (parsedLocation === 'path' && !required) {
+        console.warn(`Path parameters must be required`);
+    }
+    // Set missing 'required' to true for path parameters and false for others
+    const defaultRequired = typeof required === 'undefined' ? (parsedLocation === 'path' ? true : false) : required;
+    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 })),
+        allowEmptyValue,
+        allowReserved,
+        schema: stackTrail.trace('schema', st => toOptionalSchemaV3({ schema, stackTrail: st, context })),
+        examples: stackTrail.trace('examples', st => toExamplesV3({
+            examples,
+            example,
+            exampleKey: `${name}-${parsedLocation}`,
+            stackTrail: st,
+            context
+        })),
+        content: stackTrail.trace('content', st => toOptionalMediaTypeItemsV3({ content, stackTrail: st, context })),
+        extensionFields
+    };
+    return context.withStackTrail(stackTrail, () => new OasParameter(fields, context));
+};
+const toStyle = ({ style, location, stackTrail }) => {
+    const parsed = v.parse(v.optional(oasParameterStyle), style);
+    if (parsed !== undefined) {
+        return parsed;
+    }
+    switch (location) {
+        case 'path':
+        case 'header':
+            return 'simple';
+        case 'query':
+        case 'cookie':
+            return 'form';
+        default: {
+            const _exhaustive = location;
+            throw new Error(`Unhandled location: ${_exhaustive}`);
+        }
+    }
+};
+const toExplode = ({ explode, style, stackTrail }) => {
+    if (explode !== undefined) {
+        return explode;
+    }
+    switch (style) {
+        case 'form':
+            return true;
+        default:
+            return false;
+    }
+};

package/esm/parse/v3-1/pathItem/toPathItemV3.d.ts

@@ -0,0 +1,11 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasPathItem } from '../../../oas/pathItem/PathItem.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToPathItemV3Args = {
+    pathItem: OpenAPIV3.PathItemObject;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toPathItemV3: ({ pathItem, stackTrail, context }: ToPathItemV3Args) => OasPathItem;
+//# sourceMappingURL=toPathItemV3.d.ts.map

package/esm/parse/v3-1/pathItem/toPathItemV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toPathItemV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/pathItem/toPathItemV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,SAAS,CAAC,cAAc,CAAA;IAClC,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,mCAAmC,gBAAgB,KAAG,WAiBlF,CAAA"}

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

@@ -0,0 +1,18 @@
+import { toParameterListV3 } from '../parameter/toParameterV3.js';
+import { OasPathItem } from '../../../oas/pathItem/PathItem.js';
+import { toSpecificationExtensionsV3 } from '../specificationExtensions/toSpecificationExtensionsV3.js';
+export const toPathItemV3 = ({ pathItem, stackTrail, context }) => {
+    const { summary, description, parameters, ...skipped } = pathItem;
+    return new OasPathItem({
+        summary,
+        description,
+        parameters: stackTrail.trace('parameters', st => toParameterListV3({ parameters, stackTrail: st, context })),
+        extensionFields: toSpecificationExtensionsV3({
+            skipped,
+            parent: pathItem,
+            context,
+            stackTrail,
+            parentType: 'pathItem'
+        })
+    });
+};

package/esm/parse/v3-1/ref/toRefV31.d.ts

@@ -0,0 +1,20 @@
+import type { OpenAPIV3_1 } from 'openapi-types';
+import type { OasRefData } from '../../../oas/ref/ref-types.js';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasRef } from '../../../oas/ref/Ref.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+type ToRefV31Args<T extends OasRefData['refType']> = {
+    ref: OpenAPIV3_1.ReferenceObject;
+    refType: T;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+    /**
+     * Use-site nullability to stamp on the OasRef node. Passed explicitly
+     * by the single-member `oneOf`/`anyOf` collapse for a nullable
+     * reference; omitted everywhere else (a plain `$ref` is non-nullable).
+     */
+    nullable?: boolean;
+};
+export declare const toRefV31: <T extends OasRefData["refType"]>({ ref, refType, stackTrail, context, nullable }: ToRefV31Args<T>) => OasRef<T>;
+export {};
+//# sourceMappingURL=toRefV31.d.ts.map

package/esm/parse/v3-1/ref/toRefV31.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toRefV31.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/ref/toRefV31.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,KAAK,YAAY,CAAC,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,IAAI;IACnD,GAAG,EAAE,WAAW,CAAC,eAAe,CAAA;IAChC,OAAO,EAAE,CAAC,CAAA;IACV,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,UAAU,CAAC,SAAS,CAAC,EAAE,iDAMvD,YAAY,CAAC,CAAC,CAAC,KAAG,MAAM,CAAC,CAAC,CAY5B,CAAA"}

package/esm/parse/v3-1/ref/toRefV31.js

@@ -0,0 +1,10 @@
+import { OasRef } from '../../../oas/ref/Ref.js';
+import { isEmpty } from '../../../helpers/isEmpty.js';
+export const toRefV31 = ({ ref, refType, stackTrail, context, nullable }) => {
+    const { $ref, ...skipped } = ref;
+    if (!isEmpty(skipped)) {
+        context.logSkippedFields({ skipped, parent: ref, parentType: 'ref', stackTrail });
+    }
+    context.registerRef(stackTrail.clone(), $ref);
+    return context.withStackTrail(stackTrail, () => new OasRef({ refType, $ref, nullable }, context));
+};

package/esm/parse/v3-1/requestBody/toRequestBodiesV3.d.ts

@@ -0,0 +1,19 @@
+import type { OpenAPIV3 } from 'openapi-types';
+import type { ParseContextType } from '../../../context/parseTypes.js';
+import { OasRequestBody } from '../../../oas/requestBody/RequestBody.js';
+import type { OasRef } from '../../../oas/ref/Ref.js';
+import type { StackTrail } from '../../../context/StackTrail.js';
+export type ToRequestBodyV3Args = {
+    requestBody: OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject | undefined;
+    forceRef?: boolean;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toRequestBodyV3: ({ requestBody, stackTrail, context }: ToRequestBodyV3Args) => OasRequestBody | OasRef<"requestBody"> | undefined;
+export type ToRequestBodiesV3Args = {
+    requestBodies: Record<string, OpenAPIV3.ReferenceObject | OpenAPIV3.RequestBodyObject> | undefined;
+    stackTrail: StackTrail;
+    context: ParseContextType;
+};
+export declare const toRequestBodiesV3: ({ requestBodies, stackTrail, context }: ToRequestBodiesV3Args) => Record<string, OasRequestBody | OasRef<"requestBody">> | undefined;
+//# sourceMappingURL=toRequestBodiesV3.d.ts.map

package/esm/parse/v3-1/requestBody/toRequestBodiesV3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toRequestBodiesV3.d.ts","sourceRoot":"","sources":["../../../../src/parse/v3-1/requestBody/toRequestBodiesV3.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAItE,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAA;AAChE,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,iBAAiB,GAAG,SAAS,CAAA;IAChF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,sCAI7B,mBAAmB,KAAG,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,SA6BjE,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAA;IAClG,UAAU,EAAE,UAAU,CAAA;IACtB,OAAO,EAAE,gBAAgB,CAAA;CAC1B,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,wCAI/B,qBAAqB,KAAG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,SAiBnF,CAAA"}