@kubb/oas 3.18.1 → 3.18.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- {"version":3,"file":"index.cjs","names":["BaseOas","oas","#options","schema","refSchema: OpenAPIV3.SchemaObject","availablecontentType: string | undefined","matchesMimeType","#getResponseBodyFactory","OASNormalize","OASNormalize"],"sources":["../src/types.ts","../src/Oas.ts","../src/utils.ts"],"sourcesContent":["import type * as OasTypes from 'oas/types'\n\n// external packages\nexport type { Operation } from 'oas/operation'\nexport type { HttpMethods as HttpMethod } from 'oas/types'\nexport type * as OasTypes from 'oas/types'\nexport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nexport type contentType = 'application/json' | (string & {})\n\nexport type SchemaObject = OasTypes.SchemaObject & {\n 'x-nullable'?: boolean\n $ref?: string\n}\n\nexport const HttpMethods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n TRACE: 'trace',\n} satisfies Record<Uppercase<OasTypes.HttpMethods>, OasTypes.HttpMethods>\n","import jsonpointer from 'jsonpointer'\nimport BaseOas from 'oas'\nimport type { Operation } from 'oas/operation'\nimport type { MediaTypeObject, OASDocument, ResponseObject, SchemaObject, User } from 'oas/types'\nimport { matchesMimeType } from 'oas/utils'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPIV3 } from 'openapi-types'\nimport type { OasTypes } from './index.ts'\nimport type { contentType } from './types.ts'\nimport { isDiscriminator, isReference } from './utils.ts'\n\ntype Options = {\n contentType?: contentType\n discriminator?: 'strict' | 'inherit'\n}\n\nexport class Oas<const TOAS = unknown> extends BaseOas {\n #options: Options = {\n discriminator: 'strict',\n }\n document: TOAS = undefined as unknown as TOAS\n\n constructor({ oas, user }: { oas: TOAS | OASDocument | string; user?: User }) {\n if (typeof oas === 'string') {\n oas = JSON.parse(oas)\n }\n\n super(oas as OASDocument, user)\n\n this.document = oas as TOAS\n }\n\n setOptions(options: Options) {\n this.#options = options\n }\n\n get options(): Options {\n return this.#options\n }\n\n get($ref: string) {\n const origRef = $ref\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n } else {\n return null\n }\n const current = jsonpointer.get(this.api, $ref)\n\n if (!current) {\n throw new Error(`Could not find a definition for ${origRef}.`)\n }\n return current\n }\n\n getKey($ref: string) {\n const key = $ref.split('/').pop()\n return key === '' ? undefined : key\n }\n set($ref: string, value: unknown) {\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n\n jsonpointer.set(this.api, $ref, value)\n }\n }\n\n getDiscriminator(schema: OasTypes.SchemaObject): OpenAPIV3.DiscriminatorObject | undefined {\n if (!isDiscriminator(schema)) {\n return undefined\n }\n\n const { mapping = {}, propertyName } = schema.discriminator\n\n if (this.#options.discriminator === 'inherit') {\n Object.entries(mapping).forEach(([mappingKey, mappingValue]) => {\n if (mappingValue) {\n const childSchema = this.get(mappingValue)\n if (!childSchema.properties) {\n childSchema.properties = {}\n }\n\n const property = childSchema.properties[propertyName] as SchemaObject\n\n if (childSchema.properties) {\n childSchema.properties[propertyName] = {\n ...(childSchema.properties ? childSchema.properties[propertyName] : {}),\n enum: [...(property?.enum?.filter((value) => value !== mappingKey) ?? []), mappingKey],\n }\n\n childSchema.required = [...(childSchema.required ?? []), propertyName]\n\n this.set(mappingValue, childSchema)\n }\n }\n })\n }\n\n // loop over oneOf and add default mapping when none is defined\n if (schema.oneOf) {\n schema.oneOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n if (schema.anyOf) {\n schema.anyOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n return {\n ...schema.discriminator,\n mapping,\n }\n }\n\n // TODO add better typing\n dereferenceWithRef(schema?: unknown) {\n if (isReference(schema)) {\n return {\n ...schema,\n ...this.get(schema.$ref),\n $ref: schema.$ref,\n }\n }\n\n return schema\n }\n\n /**\n * Oas does not have a getResponseBody(contentType)\n */\n #getResponseBodyFactory(responseBody: boolean | ResponseObject): (contentType?: string) => MediaTypeObject | false | [string, MediaTypeObject, ...string[]] {\n function hasResponseBody(res = responseBody): res is ResponseObject {\n return !!res\n }\n\n return (contentType) => {\n if (!hasResponseBody(responseBody)) {\n return false\n }\n\n if (isReference(responseBody)) {\n // If the request body is still a `$ref` pointer we should return false because this library\n // assumes that you've run dereferencing beforehand.\n return false\n }\n\n if (!responseBody.content) {\n return false\n }\n\n if (contentType) {\n if (!(contentType in responseBody.content)) {\n return false\n }\n\n return responseBody.content[contentType]!\n }\n\n // Since no media type was supplied we need to find either the first JSON-like media type that\n // we've got, or the first available of anything else if no JSON-like media types are present.\n let availablecontentType: string | undefined\n const contentTypes = Object.keys(responseBody.content)\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType && matchesMimeType.json(mt)) {\n availablecontentType = mt\n }\n })\n\n if (!availablecontentType) {\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType) {\n availablecontentType = mt\n }\n })\n }\n\n if (availablecontentType) {\n return [availablecontentType, responseBody.content[availablecontentType]!, ...(responseBody.description ? [responseBody.description] : [])]\n }\n\n return false\n }\n }\n\n getResponseSchema(operation: Operation, statusCode: string | number): SchemaObject {\n if (operation.schema.responses) {\n Object.keys(operation.schema.responses).forEach((key) => {\n const schema = operation.schema.responses![key]\n const $ref = isReference(schema) ? schema.$ref : undefined\n\n if (schema && $ref) {\n operation.schema.responses![key] = this.get($ref)\n }\n })\n }\n\n const getResponseBody = this.#getResponseBodyFactory(operation.getResponseByStatusCode(statusCode))\n\n const { contentType } = this.#options\n const responseBody = getResponseBody(contentType)\n\n if (responseBody === false) {\n // return empty object because response will always be defined(request does not need a body)\n return {}\n }\n\n const schema = Array.isArray(responseBody) ? responseBody[1].schema : responseBody.schema\n\n if (!schema) {\n // return empty object because response will always be defined(request does not need a body)\n\n return {}\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getRequestSchema(operation: Operation): SchemaObject | undefined {\n const { contentType } = this.#options\n\n if (operation.schema.requestBody) {\n operation.schema.requestBody = this.dereferenceWithRef(operation.schema.requestBody)\n }\n\n const requestBody = operation.getRequestBody(contentType)\n\n if (requestBody === false) {\n return undefined\n }\n\n const schema = Array.isArray(requestBody) ? requestBody[1].schema : requestBody.schema\n\n if (!schema) {\n return undefined\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getParametersSchema(operation: Operation, inKey: 'path' | 'query' | 'header'): SchemaObject | null {\n const { contentType = operation.getContentType() } = this.#options\n const params = operation\n .getParameters()\n .map((schema) => {\n return this.dereferenceWithRef(schema)\n })\n .filter((v) => v.in === inKey)\n\n if (!params.length) {\n return null\n }\n\n return params.reduce(\n (schema, pathParameters) => {\n const property = pathParameters.content?.[contentType]?.schema ?? (pathParameters.schema as SchemaObject)\n const required = [...(schema.required || ([] as any)), pathParameters.required ? pathParameters.name : undefined].filter(Boolean)\n\n return {\n ...schema,\n description: schema.description,\n deprecated: schema.deprecated,\n example: schema.example,\n required,\n properties: {\n ...schema.properties,\n [pathParameters.name]: {\n description: pathParameters.description,\n ...property,\n },\n },\n }\n },\n { type: 'object', required: [], properties: {} } as SchemaObject,\n )\n }\n\n async valdiate() {\n const oasNormalize = new OASNormalize(this.api, {\n enablePaths: true,\n colorizeErrors: true,\n })\n\n return oasNormalize.validate({\n parser: {\n validate: {\n errors: {\n colorize: true,\n },\n },\n },\n })\n }\n}\n","import type { OASDocument, ParameterObject, SchemaObject } from 'oas/types'\nimport { isRef, isSchema } from 'oas/types'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\nimport { isPlainObject, mergeDeep } from 'remeda'\nimport swagger2openapi from 'swagger2openapi'\nimport { Oas } from './Oas.ts'\n\nexport function isOpenApiV2Document(doc: any): doc is OpenAPIV2.Document {\n return doc && isPlainObject(doc) && !('openapi' in doc)\n}\nexport function isOpenApiV3Document(doc: any): doc is OpenAPIV3.Document {\n return doc && isPlainObject(doc) && 'openapi' in doc\n}\n\nexport function isOpenApiV3_1Document(doc: any): doc is OpenAPIV3_1.Document {\n return doc && isPlainObject<OpenAPIV3_1.Document>(doc) && 'openapi' in doc && doc.openapi.startsWith('3.1')\n}\n\nexport function isJSONSchema(obj?: unknown): obj is SchemaObject {\n return !!obj && isSchema(obj)\n}\n\nexport function isParameterObject(obj: ParameterObject | SchemaObject): obj is ParameterObject {\n return obj && 'in' in obj\n}\n\n/**\n * Determines if a schema is nullable, considering both the standard `nullable` property and the legacy `x-nullable` extension.\n *\n * @param schema - The schema object to check.\n * @returns `true` if the schema is marked as nullable; otherwise, `false`.\n */\nexport function isNullable(schema?: SchemaObject & { 'x-nullable'?: boolean }): boolean {\n return schema?.nullable ?? schema?.['x-nullable'] ?? false\n}\n\n/**\n * Determines if the given object is an OpenAPI ReferenceObject.\n *\n * @returns True if {@link obj} is a ReferenceObject; otherwise, false.\n */\nexport function isReference(obj?: any): obj is OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject {\n return !!obj && isRef(obj)\n}\n\n/**\n * Determines if the given object is a SchemaObject with a discriminator property of type DiscriminatorObject.\n *\n * @returns True if {@link obj} is a SchemaObject containing a non-string {@link discriminator} property.\n */\nexport function isDiscriminator(obj?: any): obj is SchemaObject & { discriminator: OpenAPIV3.DiscriminatorObject } {\n return !!obj && obj?.['discriminator'] && typeof obj.discriminator !== 'string'\n}\n\n/**\n * Determines whether a schema is required.\n *\n * Returns true if the schema has a non-empty {@link SchemaObject.required} array or a truthy {@link SchemaObject.required} property.\n *\n * @param schema - The schema object to check.\n * @returns True if the schema is required; otherwise, false.\n */\nexport function isRequired(schema?: SchemaObject): boolean {\n if (!schema) {\n return false\n }\n\n return Array.isArray(schema.required) ? !!schema.required?.length : !!schema.required\n}\n\nexport function isOptional(schema?: SchemaObject): boolean {\n return !isRequired(schema)\n}\n\nexport async function parse(\n pathOrApi: string | OASDocument,\n { oasClass = Oas, canBundle = true, enablePaths = true }: { oasClass?: typeof Oas; canBundle?: boolean; enablePaths?: boolean } = {},\n): Promise<Oas> {\n const { loadConfig, bundle } = await import('@redocly/openapi-core')\n\n if (typeof pathOrApi === 'string' && canBundle) {\n // resolve external refs\n const config = await loadConfig()\n const bundleResults = await bundle({ ref: pathOrApi, config, base: pathOrApi })\n\n return parse(bundleResults.bundle.parsed as string)\n }\n\n const oasNormalize = new OASNormalize(pathOrApi, {\n enablePaths,\n colorizeErrors: true,\n })\n const document = (await oasNormalize.load()) as OpenAPI.Document\n\n if (isOpenApiV2Document(document)) {\n const { openapi } = await swagger2openapi.convertObj(document, {\n anchors: true,\n })\n\n return new oasClass({ oas: openapi as OASDocument })\n }\n\n return new oasClass({ oas: document })\n}\n\nexport async function merge(pathOrApi: Array<string | OASDocument>, { oasClass = Oas }: { oasClass?: typeof Oas } = {}): Promise<Oas> {\n const instances = await Promise.all(pathOrApi.map((p) => parse(p, { oasClass, enablePaths: false, canBundle: false })))\n\n if (instances.length === 0) {\n throw new Error('No OAS instances provided for merging.')\n }\n\n const merged = instances.reduce(\n (acc, current) => {\n return mergeDeep(acc, current.document as OASDocument)\n },\n {\n openapi: '3.0.0',\n info: {\n title: 'Merged API',\n version: '1.0.0',\n },\n paths: {},\n components: {\n schemas: {},\n },\n } as any,\n )\n\n return parse(merged, { oasClass })\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.cjs","names":["BaseOas","oas","#options","schema","refSchema: OpenAPIV3.SchemaObject","availablecontentType: string | undefined","matchesMimeType","#getResponseBodyFactory","OASNormalize","OASNormalize"],"sources":["../src/types.ts","../src/Oas.ts","../src/utils.ts"],"sourcesContent":["import type * as OasTypes from 'oas/types'\n\n// external packages\nexport type { Operation } from 'oas/operation'\nexport type { HttpMethods as HttpMethod } from 'oas/types'\nexport type * as OasTypes from 'oas/types'\nexport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nexport type contentType = 'application/json' | (string & {})\n\nexport type SchemaObject = OasTypes.SchemaObject & {\n 'x-nullable'?: boolean\n $ref?: string\n}\n\nexport const HttpMethods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n TRACE: 'trace',\n} satisfies Record<Uppercase<OasTypes.HttpMethods>, OasTypes.HttpMethods>\n","import jsonpointer from 'jsonpointer'\nimport BaseOas from 'oas'\nimport type { Operation } from 'oas/operation'\nimport type { MediaTypeObject, OASDocument, ResponseObject, SchemaObject, User } from 'oas/types'\nimport { matchesMimeType } from 'oas/utils'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPIV3 } from 'openapi-types'\nimport type { OasTypes } from './index.ts'\nimport type { contentType } from './types.ts'\nimport { isDiscriminator, isReference } from './utils.ts'\n\ntype Options = {\n contentType?: contentType\n discriminator?: 'strict' | 'inherit'\n}\n\nexport class Oas<const TOAS = unknown> extends BaseOas {\n #options: Options = {\n discriminator: 'strict',\n }\n document: TOAS = undefined as unknown as TOAS\n\n constructor({ oas, user }: { oas: TOAS | OASDocument | string; user?: User }) {\n if (typeof oas === 'string') {\n oas = JSON.parse(oas)\n }\n\n super(oas as OASDocument, user)\n\n this.document = oas as TOAS\n }\n\n setOptions(options: Options) {\n this.#options = options\n }\n\n get options(): Options {\n return this.#options\n }\n\n get($ref: string) {\n const origRef = $ref\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n } else {\n return null\n }\n const current = jsonpointer.get(this.api, $ref)\n\n if (!current) {\n throw new Error(`Could not find a definition for ${origRef}.`)\n }\n return current\n }\n\n getKey($ref: string) {\n const key = $ref.split('/').pop()\n return key === '' ? undefined : key\n }\n set($ref: string, value: unknown) {\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n\n jsonpointer.set(this.api, $ref, value)\n }\n }\n\n getDiscriminator(schema: OasTypes.SchemaObject): OpenAPIV3.DiscriminatorObject | undefined {\n if (!isDiscriminator(schema)) {\n return undefined\n }\n\n const { mapping = {}, propertyName } = schema.discriminator\n\n if (this.#options.discriminator === 'inherit') {\n Object.entries(mapping).forEach(([mappingKey, mappingValue]) => {\n if (mappingValue) {\n const childSchema = this.get(mappingValue)\n if (!childSchema.properties) {\n childSchema.properties = {}\n }\n\n const property = childSchema.properties[propertyName] as SchemaObject\n\n if (childSchema.properties) {\n childSchema.properties[propertyName] = {\n ...(childSchema.properties ? childSchema.properties[propertyName] : {}),\n enum: [...(property?.enum?.filter((value) => value !== mappingKey) ?? []), mappingKey],\n }\n\n childSchema.required = [...(childSchema.required ?? []), propertyName]\n\n this.set(mappingValue, childSchema)\n }\n }\n })\n }\n\n // loop over oneOf and add default mapping when none is defined\n if (schema.oneOf) {\n schema.oneOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n if (schema.anyOf) {\n schema.anyOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n return {\n ...schema.discriminator,\n mapping,\n }\n }\n\n // TODO add better typing\n dereferenceWithRef(schema?: unknown) {\n if (isReference(schema)) {\n return {\n ...schema,\n ...this.get(schema.$ref),\n $ref: schema.$ref,\n }\n }\n\n return schema\n }\n\n /**\n * Oas does not have a getResponseBody(contentType)\n */\n #getResponseBodyFactory(responseBody: boolean | ResponseObject): (contentType?: string) => MediaTypeObject | false | [string, MediaTypeObject, ...string[]] {\n function hasResponseBody(res = responseBody): res is ResponseObject {\n return !!res\n }\n\n return (contentType) => {\n if (!hasResponseBody(responseBody)) {\n return false\n }\n\n if (isReference(responseBody)) {\n // If the request body is still a `$ref` pointer we should return false because this library\n // assumes that you've run dereferencing beforehand.\n return false\n }\n\n if (!responseBody.content) {\n return false\n }\n\n if (contentType) {\n if (!(contentType in responseBody.content)) {\n return false\n }\n\n return responseBody.content[contentType]!\n }\n\n // Since no media type was supplied we need to find either the first JSON-like media type that\n // we've got, or the first available of anything else if no JSON-like media types are present.\n let availablecontentType: string | undefined\n const contentTypes = Object.keys(responseBody.content)\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType && matchesMimeType.json(mt)) {\n availablecontentType = mt\n }\n })\n\n if (!availablecontentType) {\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType) {\n availablecontentType = mt\n }\n })\n }\n\n if (availablecontentType) {\n return [availablecontentType, responseBody.content[availablecontentType]!, ...(responseBody.description ? [responseBody.description] : [])]\n }\n\n return false\n }\n }\n\n getResponseSchema(operation: Operation, statusCode: string | number): SchemaObject {\n if (operation.schema.responses) {\n Object.keys(operation.schema.responses).forEach((key) => {\n const schema = operation.schema.responses![key]\n const $ref = isReference(schema) ? schema.$ref : undefined\n\n if (schema && $ref) {\n operation.schema.responses![key] = this.get($ref)\n }\n })\n }\n\n const getResponseBody = this.#getResponseBodyFactory(operation.getResponseByStatusCode(statusCode))\n\n const { contentType } = this.#options\n const responseBody = getResponseBody(contentType)\n\n if (responseBody === false) {\n // return empty object because response will always be defined(request does not need a body)\n return {}\n }\n\n const schema = Array.isArray(responseBody) ? responseBody[1].schema : responseBody.schema\n\n if (!schema) {\n // return empty object because response will always be defined(request does not need a body)\n\n return {}\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getRequestSchema(operation: Operation): SchemaObject | undefined {\n const { contentType } = this.#options\n\n if (operation.schema.requestBody) {\n operation.schema.requestBody = this.dereferenceWithRef(operation.schema.requestBody)\n }\n\n const requestBody = operation.getRequestBody(contentType)\n\n if (requestBody === false) {\n return undefined\n }\n\n const schema = Array.isArray(requestBody) ? requestBody[1].schema : requestBody.schema\n\n if (!schema) {\n return undefined\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getParametersSchema(operation: Operation, inKey: 'path' | 'query' | 'header'): SchemaObject | null {\n const { contentType = operation.getContentType() } = this.#options\n const params = operation\n .getParameters()\n .map((schema) => {\n return this.dereferenceWithRef(schema)\n })\n .filter((v) => v.in === inKey)\n\n if (!params.length) {\n return null\n }\n\n return params.reduce(\n (schema, pathParameters) => {\n const property = pathParameters.content?.[contentType]?.schema ?? (pathParameters.schema as SchemaObject)\n const required = [...(schema.required || ([] as any)), pathParameters.required ? pathParameters.name : undefined].filter(Boolean)\n\n return {\n ...schema,\n description: schema.description,\n deprecated: schema.deprecated,\n example: schema.example,\n required,\n properties: {\n ...schema.properties,\n [pathParameters.name]: {\n description: pathParameters.description,\n ...property,\n },\n },\n }\n },\n { type: 'object', required: [], properties: {} } as SchemaObject,\n )\n }\n\n async valdiate() {\n const oasNormalize = new OASNormalize(this.api, {\n enablePaths: true,\n colorizeErrors: true,\n })\n\n return oasNormalize.validate({\n parser: {\n validate: {\n errors: {\n colorize: true,\n },\n },\n },\n })\n }\n}\n","import type { OASDocument, ParameterObject, SchemaObject } from 'oas/types'\nimport { isRef, isSchema } from 'oas/types'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\nimport { isPlainObject, mergeDeep } from 'remeda'\nimport swagger2openapi from 'swagger2openapi'\nimport { Oas } from './Oas.ts'\n\nexport function isOpenApiV2Document(doc: any): doc is OpenAPIV2.Document {\n return doc && isPlainObject(doc) && !('openapi' in doc)\n}\nexport function isOpenApiV3Document(doc: any): doc is OpenAPIV3.Document {\n return doc && isPlainObject(doc) && 'openapi' in doc\n}\n\nexport function isOpenApiV3_1Document(doc: any): doc is OpenAPIV3_1.Document {\n return doc && isPlainObject<OpenAPIV3_1.Document>(doc) && 'openapi' in doc && doc.openapi.startsWith('3.1')\n}\n\nexport function isJSONSchema(obj?: unknown): obj is SchemaObject {\n return !!obj && isSchema(obj)\n}\n\nexport function isParameterObject(obj: ParameterObject | SchemaObject): obj is ParameterObject {\n return obj && 'in' in obj\n}\n\n/**\n * Determines if a schema is nullable, considering both the standard `nullable` property and the legacy `x-nullable` extension.\n *\n * @param schema - The schema object to check.\n * @returns `true` if the schema is marked as nullable; otherwise, `false`.\n */\nexport function isNullable(schema?: SchemaObject & { 'x-nullable'?: boolean }): boolean {\n return schema?.nullable ?? schema?.['x-nullable'] ?? false\n}\n\n/**\n * Determines if the given object is an OpenAPI ReferenceObject.\n *\n * @returns True if {@link obj} is a ReferenceObject; otherwise, false.\n */\nexport function isReference(obj?: any): obj is OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject {\n return !!obj && isRef(obj)\n}\n\n/**\n * Determines if the given object is a SchemaObject with a discriminator property of type DiscriminatorObject.\n *\n * @returns True if {@link obj} is a SchemaObject containing a non-string {@link discriminator} property.\n */\nexport function isDiscriminator(obj?: any): obj is SchemaObject & { discriminator: OpenAPIV3.DiscriminatorObject } {\n return !!obj && obj?.['discriminator'] && typeof obj.discriminator !== 'string'\n}\n\n/**\n * Determines whether a schema is required.\n *\n * Returns true if the schema has a non-empty {@link SchemaObject.required} array or a truthy {@link SchemaObject.required} property.\n *\n * @param schema - The schema object to check.\n * @returns True if the schema is required; otherwise, false.\n */\nexport function isRequired(schema?: SchemaObject): boolean {\n if (!schema) {\n return false\n }\n\n return Array.isArray(schema.required) ? !!schema.required?.length : !!schema.required\n}\n\nexport function isOptional(schema?: SchemaObject): boolean {\n return !isRequired(schema)\n}\n\nexport async function parse(\n pathOrApi: string | OASDocument,\n { oasClass = Oas, canBundle = true, enablePaths = true }: { oasClass?: typeof Oas; canBundle?: boolean; enablePaths?: boolean } = {},\n): Promise<Oas> {\n const { loadConfig, bundle } = await import('@redocly/openapi-core')\n\n if (typeof pathOrApi === 'string' && canBundle) {\n // resolve external refs\n const config = await loadConfig()\n const bundleResults = await bundle({ ref: pathOrApi, config, base: pathOrApi })\n\n return parse(bundleResults.bundle.parsed as string)\n }\n\n const oasNormalize = new OASNormalize(pathOrApi, {\n enablePaths,\n colorizeErrors: true,\n })\n const document = (await oasNormalize.load()) as OpenAPI.Document\n\n if (isOpenApiV2Document(document)) {\n const { openapi } = await swagger2openapi.convertObj(document, {\n anchors: true,\n })\n\n return new oasClass({ oas: openapi as OASDocument })\n }\n\n return new oasClass({ oas: document })\n}\n\nexport async function merge(pathOrApi: Array<string | OASDocument>, { oasClass = Oas }: { oasClass?: typeof Oas } = {}): Promise<Oas> {\n const instances = await Promise.all(pathOrApi.map((p) => parse(p, { oasClass, enablePaths: false, canBundle: false })))\n\n if (instances.length === 0) {\n throw new Error('No OAS instances provided for merging.')\n }\n\n const merged = instances.reduce(\n (acc, current) => {\n return mergeDeep(acc, current.document as OASDocument)\n },\n {\n openapi: '3.0.0',\n info: {\n title: 'Merged API',\n version: '1.0.0',\n },\n paths: {},\n components: {\n schemas: {},\n },\n } as any,\n )\n\n return parse(merged, { oasClass })\n}\n"],"mappings":"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"}
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","names":["#options","schema","refSchema: OpenAPIV3.SchemaObject","availablecontentType: string | undefined","matchesMimeType","#getResponseBodyFactory"],"sources":["../src/types.ts","../src/Oas.ts","../src/utils.ts"],"sourcesContent":["import type * as OasTypes from 'oas/types'\n\n// external packages\nexport type { Operation } from 'oas/operation'\nexport type { HttpMethods as HttpMethod } from 'oas/types'\nexport type * as OasTypes from 'oas/types'\nexport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nexport type contentType = 'application/json' | (string & {})\n\nexport type SchemaObject = OasTypes.SchemaObject & {\n 'x-nullable'?: boolean\n $ref?: string\n}\n\nexport const HttpMethods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n TRACE: 'trace',\n} satisfies Record<Uppercase<OasTypes.HttpMethods>, OasTypes.HttpMethods>\n","import jsonpointer from 'jsonpointer'\nimport BaseOas from 'oas'\nimport type { Operation } from 'oas/operation'\nimport type { MediaTypeObject, OASDocument, ResponseObject, SchemaObject, User } from 'oas/types'\nimport { matchesMimeType } from 'oas/utils'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPIV3 } from 'openapi-types'\nimport type { OasTypes } from './index.ts'\nimport type { contentType } from './types.ts'\nimport { isDiscriminator, isReference } from './utils.ts'\n\ntype Options = {\n contentType?: contentType\n discriminator?: 'strict' | 'inherit'\n}\n\nexport class Oas<const TOAS = unknown> extends BaseOas {\n #options: Options = {\n discriminator: 'strict',\n }\n document: TOAS = undefined as unknown as TOAS\n\n constructor({ oas, user }: { oas: TOAS | OASDocument | string; user?: User }) {\n if (typeof oas === 'string') {\n oas = JSON.parse(oas)\n }\n\n super(oas as OASDocument, user)\n\n this.document = oas as TOAS\n }\n\n setOptions(options: Options) {\n this.#options = options\n }\n\n get options(): Options {\n return this.#options\n }\n\n get($ref: string) {\n const origRef = $ref\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n } else {\n return null\n }\n const current = jsonpointer.get(this.api, $ref)\n\n if (!current) {\n throw new Error(`Could not find a definition for ${origRef}.`)\n }\n return current\n }\n\n getKey($ref: string) {\n const key = $ref.split('/').pop()\n return key === '' ? undefined : key\n }\n set($ref: string, value: unknown) {\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n\n jsonpointer.set(this.api, $ref, value)\n }\n }\n\n getDiscriminator(schema: OasTypes.SchemaObject): OpenAPIV3.DiscriminatorObject | undefined {\n if (!isDiscriminator(schema)) {\n return undefined\n }\n\n const { mapping = {}, propertyName } = schema.discriminator\n\n if (this.#options.discriminator === 'inherit') {\n Object.entries(mapping).forEach(([mappingKey, mappingValue]) => {\n if (mappingValue) {\n const childSchema = this.get(mappingValue)\n if (!childSchema.properties) {\n childSchema.properties = {}\n }\n\n const property = childSchema.properties[propertyName] as SchemaObject\n\n if (childSchema.properties) {\n childSchema.properties[propertyName] = {\n ...(childSchema.properties ? childSchema.properties[propertyName] : {}),\n enum: [...(property?.enum?.filter((value) => value !== mappingKey) ?? []), mappingKey],\n }\n\n childSchema.required = [...(childSchema.required ?? []), propertyName]\n\n this.set(mappingValue, childSchema)\n }\n }\n })\n }\n\n // loop over oneOf and add default mapping when none is defined\n if (schema.oneOf) {\n schema.oneOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n if (schema.anyOf) {\n schema.anyOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n return {\n ...schema.discriminator,\n mapping,\n }\n }\n\n // TODO add better typing\n dereferenceWithRef(schema?: unknown) {\n if (isReference(schema)) {\n return {\n ...schema,\n ...this.get(schema.$ref),\n $ref: schema.$ref,\n }\n }\n\n return schema\n }\n\n /**\n * Oas does not have a getResponseBody(contentType)\n */\n #getResponseBodyFactory(responseBody: boolean | ResponseObject): (contentType?: string) => MediaTypeObject | false | [string, MediaTypeObject, ...string[]] {\n function hasResponseBody(res = responseBody): res is ResponseObject {\n return !!res\n }\n\n return (contentType) => {\n if (!hasResponseBody(responseBody)) {\n return false\n }\n\n if (isReference(responseBody)) {\n // If the request body is still a `$ref` pointer we should return false because this library\n // assumes that you've run dereferencing beforehand.\n return false\n }\n\n if (!responseBody.content) {\n return false\n }\n\n if (contentType) {\n if (!(contentType in responseBody.content)) {\n return false\n }\n\n return responseBody.content[contentType]!\n }\n\n // Since no media type was supplied we need to find either the first JSON-like media type that\n // we've got, or the first available of anything else if no JSON-like media types are present.\n let availablecontentType: string | undefined\n const contentTypes = Object.keys(responseBody.content)\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType && matchesMimeType.json(mt)) {\n availablecontentType = mt\n }\n })\n\n if (!availablecontentType) {\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType) {\n availablecontentType = mt\n }\n })\n }\n\n if (availablecontentType) {\n return [availablecontentType, responseBody.content[availablecontentType]!, ...(responseBody.description ? [responseBody.description] : [])]\n }\n\n return false\n }\n }\n\n getResponseSchema(operation: Operation, statusCode: string | number): SchemaObject {\n if (operation.schema.responses) {\n Object.keys(operation.schema.responses).forEach((key) => {\n const schema = operation.schema.responses![key]\n const $ref = isReference(schema) ? schema.$ref : undefined\n\n if (schema && $ref) {\n operation.schema.responses![key] = this.get($ref)\n }\n })\n }\n\n const getResponseBody = this.#getResponseBodyFactory(operation.getResponseByStatusCode(statusCode))\n\n const { contentType } = this.#options\n const responseBody = getResponseBody(contentType)\n\n if (responseBody === false) {\n // return empty object because response will always be defined(request does not need a body)\n return {}\n }\n\n const schema = Array.isArray(responseBody) ? responseBody[1].schema : responseBody.schema\n\n if (!schema) {\n // return empty object because response will always be defined(request does not need a body)\n\n return {}\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getRequestSchema(operation: Operation): SchemaObject | undefined {\n const { contentType } = this.#options\n\n if (operation.schema.requestBody) {\n operation.schema.requestBody = this.dereferenceWithRef(operation.schema.requestBody)\n }\n\n const requestBody = operation.getRequestBody(contentType)\n\n if (requestBody === false) {\n return undefined\n }\n\n const schema = Array.isArray(requestBody) ? requestBody[1].schema : requestBody.schema\n\n if (!schema) {\n return undefined\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getParametersSchema(operation: Operation, inKey: 'path' | 'query' | 'header'): SchemaObject | null {\n const { contentType = operation.getContentType() } = this.#options\n const params = operation\n .getParameters()\n .map((schema) => {\n return this.dereferenceWithRef(schema)\n })\n .filter((v) => v.in === inKey)\n\n if (!params.length) {\n return null\n }\n\n return params.reduce(\n (schema, pathParameters) => {\n const property = pathParameters.content?.[contentType]?.schema ?? (pathParameters.schema as SchemaObject)\n const required = [...(schema.required || ([] as any)), pathParameters.required ? pathParameters.name : undefined].filter(Boolean)\n\n return {\n ...schema,\n description: schema.description,\n deprecated: schema.deprecated,\n example: schema.example,\n required,\n properties: {\n ...schema.properties,\n [pathParameters.name]: {\n description: pathParameters.description,\n ...property,\n },\n },\n }\n },\n { type: 'object', required: [], properties: {} } as SchemaObject,\n )\n }\n\n async valdiate() {\n const oasNormalize = new OASNormalize(this.api, {\n enablePaths: true,\n colorizeErrors: true,\n })\n\n return oasNormalize.validate({\n parser: {\n validate: {\n errors: {\n colorize: true,\n },\n },\n },\n })\n }\n}\n","import type { OASDocument, ParameterObject, SchemaObject } from 'oas/types'\nimport { isRef, isSchema } from 'oas/types'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\nimport { isPlainObject, mergeDeep } from 'remeda'\nimport swagger2openapi from 'swagger2openapi'\nimport { Oas } from './Oas.ts'\n\nexport function isOpenApiV2Document(doc: any): doc is OpenAPIV2.Document {\n return doc && isPlainObject(doc) && !('openapi' in doc)\n}\nexport function isOpenApiV3Document(doc: any): doc is OpenAPIV3.Document {\n return doc && isPlainObject(doc) && 'openapi' in doc\n}\n\nexport function isOpenApiV3_1Document(doc: any): doc is OpenAPIV3_1.Document {\n return doc && isPlainObject<OpenAPIV3_1.Document>(doc) && 'openapi' in doc && doc.openapi.startsWith('3.1')\n}\n\nexport function isJSONSchema(obj?: unknown): obj is SchemaObject {\n return !!obj && isSchema(obj)\n}\n\nexport function isParameterObject(obj: ParameterObject | SchemaObject): obj is ParameterObject {\n return obj && 'in' in obj\n}\n\n/**\n * Determines if a schema is nullable, considering both the standard `nullable` property and the legacy `x-nullable` extension.\n *\n * @param schema - The schema object to check.\n * @returns `true` if the schema is marked as nullable; otherwise, `false`.\n */\nexport function isNullable(schema?: SchemaObject & { 'x-nullable'?: boolean }): boolean {\n return schema?.nullable ?? schema?.['x-nullable'] ?? false\n}\n\n/**\n * Determines if the given object is an OpenAPI ReferenceObject.\n *\n * @returns True if {@link obj} is a ReferenceObject; otherwise, false.\n */\nexport function isReference(obj?: any): obj is OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject {\n return !!obj && isRef(obj)\n}\n\n/**\n * Determines if the given object is a SchemaObject with a discriminator property of type DiscriminatorObject.\n *\n * @returns True if {@link obj} is a SchemaObject containing a non-string {@link discriminator} property.\n */\nexport function isDiscriminator(obj?: any): obj is SchemaObject & { discriminator: OpenAPIV3.DiscriminatorObject } {\n return !!obj && obj?.['discriminator'] && typeof obj.discriminator !== 'string'\n}\n\n/**\n * Determines whether a schema is required.\n *\n * Returns true if the schema has a non-empty {@link SchemaObject.required} array or a truthy {@link SchemaObject.required} property.\n *\n * @param schema - The schema object to check.\n * @returns True if the schema is required; otherwise, false.\n */\nexport function isRequired(schema?: SchemaObject): boolean {\n if (!schema) {\n return false\n }\n\n return Array.isArray(schema.required) ? !!schema.required?.length : !!schema.required\n}\n\nexport function isOptional(schema?: SchemaObject): boolean {\n return !isRequired(schema)\n}\n\nexport async function parse(\n pathOrApi: string | OASDocument,\n { oasClass = Oas, canBundle = true, enablePaths = true }: { oasClass?: typeof Oas; canBundle?: boolean; enablePaths?: boolean } = {},\n): Promise<Oas> {\n const { loadConfig, bundle } = await import('@redocly/openapi-core')\n\n if (typeof pathOrApi === 'string' && canBundle) {\n // resolve external refs\n const config = await loadConfig()\n const bundleResults = await bundle({ ref: pathOrApi, config, base: pathOrApi })\n\n return parse(bundleResults.bundle.parsed as string)\n }\n\n const oasNormalize = new OASNormalize(pathOrApi, {\n enablePaths,\n colorizeErrors: true,\n })\n const document = (await oasNormalize.load()) as OpenAPI.Document\n\n if (isOpenApiV2Document(document)) {\n const { openapi } = await swagger2openapi.convertObj(document, {\n anchors: true,\n })\n\n return new oasClass({ oas: openapi as OASDocument })\n }\n\n return new oasClass({ oas: document })\n}\n\nexport async function merge(pathOrApi: Array<string | OASDocument>, { oasClass = Oas }: { oasClass?: typeof Oas } = {}): Promise<Oas> {\n const instances = await Promise.all(pathOrApi.map((p) => parse(p, { oasClass, enablePaths: false, canBundle: false })))\n\n if (instances.length === 0) {\n throw new Error('No OAS instances provided for merging.')\n }\n\n const merged = instances.reduce(\n (acc, current) => {\n return mergeDeep(acc, current.document as OASDocument)\n },\n {\n openapi: '3.0.0',\n info: {\n title: 'Merged API',\n version: '1.0.0',\n },\n paths: {},\n components: {\n schemas: {},\n },\n } as any,\n )\n\n return parse(merged, { oasClass })\n}\n"],"mappings":";;;;;;;;;AAeA,MAAa,cAAc;CACzB,KAAK;CACL,MAAM;CACN,KAAK;CACL,OAAO;CACP,QAAQ;CACR,MAAM;CACN,SAAS;CACT,OAAO;CACR;;;;ACRD,IAAa,MAAb,cAA+C,QAAQ;CACrD,WAAoB,EAClB,eAAe,UAChB;CACD,WAAiB;CAEjB,YAAY,EAAE,KAAK,MAAyD,EAAE;AAC5E,MAAI,OAAO,QAAQ,SACjB,OAAM,KAAK,MAAM;AAGnB,QAAM,KAAoB;AAE1B,OAAK,WAAW;CACjB;CAED,WAAW,SAAkB;AAC3B,QAAKA,UAAW;CACjB;CAED,IAAI,UAAmB;AACrB,SAAO,MAAKA;CACb;CAED,IAAI,MAAc;EAChB,MAAM,UAAU;AAChB,SAAO,KAAK;AACZ,MAAI,SAAS,GACX,QAAO;AAET,MAAI,KAAK,WAAW,KAClB,QAAO,WAAW,mBAAmB,KAAK,UAAU;MAEpD,QAAO;EAET,MAAM,UAAU,YAAY,IAAI,KAAK,KAAK;AAE1C,MAAI,CAAC,QACH,OAAM,IAAI,MAAM,mCAAmC,QAAQ;AAE7D,SAAO;CACR;CAED,OAAO,MAAc;EACnB,MAAM,MAAM,KAAK,MAAM,KAAK;AAC5B,SAAO,QAAQ,KAAK,SAAY;CACjC;CACD,IAAI,MAAc,OAAgB;AAChC,SAAO,KAAK;AACZ,MAAI,SAAS,GACX,QAAO;AAET,MAAI,KAAK,WAAW,MAAM;AACxB,UAAO,WAAW,mBAAmB,KAAK,UAAU;AAEpD,eAAY,IAAI,KAAK,KAAK,MAAM;EACjC;CACF;CAED,iBAAiB,QAA0E;AACzF,MAAI,CAAC,gBAAgB,QACnB,QAAO;EAGT,MAAM,EAAE,UAAU,EAAE,EAAE,cAAc,GAAG,OAAO;AAE9C,MAAI,MAAKA,QAAS,kBAAkB,UAClC,QAAO,QAAQ,SAAS,SAAS,CAAC,YAAY,aAAa,KAAK;AAC9D,OAAI,cAAc;IAChB,MAAM,cAAc,KAAK,IAAI;AAC7B,QAAI,CAAC,YAAY,WACf,aAAY,aAAa,EAAE;IAG7B,MAAM,WAAW,YAAY,WAAW;AAExC,QAAI,YAAY,YAAY;AAC1B,iBAAY,WAAW,gBAAgB;MACrC,GAAI,YAAY,aAAa,YAAY,WAAW,gBAAgB,EAAE;MACtE,MAAM,CAAC,GAAI,UAAU,MAAM,QAAQ,UAAU,UAAU,eAAe,EAAE,EAAG,WAAW;MACvF;AAED,iBAAY,WAAW,CAAC,GAAI,YAAY,YAAY,EAAE,EAAG,aAAa;AAEtE,UAAK,IAAI,cAAc;IACxB;GACF;EACF;AAIH,MAAI,OAAO,MACT,QAAO,MAAM,SAAS,aAAW;AAC/B,OAAI,YAAYC,WAAS;IACvB,MAAM,MAAM,KAAK,OAAOA,SAAO;IAC/B,MAAMC,YAAoC,KAAK,IAAID,SAAO;IAE1D,MAAM,iBAAiB,UAAU,aAAa;IAC9C,MAAM,SAAS,OAAO,CAAC,OAAO,OAAO,SAAS,SAASA,SAAO;AAE9D,QAAI,UAAU,gBAAgB,MAAM,WAAW,EAC7C,SAAQ,eAAe,KAAK,MAAMA,SAAO;aAChC,OACT,SAAQ,OAAOA,SAAO;GAEzB;EACF;AAGH,MAAI,OAAO,MACT,QAAO,MAAM,SAAS,aAAW;AAC/B,OAAI,YAAYA,WAAS;IACvB,MAAM,MAAM,KAAK,OAAOA,SAAO;IAC/B,MAAMC,YAAoC,KAAK,IAAID,SAAO;IAE1D,MAAM,iBAAiB,UAAU,aAAa;IAC9C,MAAM,SAAS,OAAO,CAAC,OAAO,OAAO,SAAS,SAASA,SAAO;AAE9D,QAAI,UAAU,gBAAgB,MAAM,WAAW,EAC7C,SAAQ,eAAe,KAAK,MAAMA,SAAO;aAChC,OACT,SAAQ,OAAOA,SAAO;GAEzB;EACF;AAGH,SAAO;GACL,GAAG,OAAO;GACV;GACD;CACF;CAGD,mBAAmB,QAAkB;AACnC,MAAI,YAAY,QACd,QAAO;GACL,GAAG;GACH,GAAG,KAAK,IAAI,OAAO;GACnB,MAAM,OAAO;GACd;AAGH,SAAO;CACR;;;;CAKD,wBAAwB,cAAoI;EAC1J,SAAS,gBAAgB,MAAM,cAAqC;AAClE,UAAO,CAAC,CAAC;EACV;AAED,UAAQ,gBAAgB;AACtB,OAAI,CAAC,gBAAgB,cACnB,QAAO;AAGT,OAAI,YAAY,cAGd,QAAO;AAGT,OAAI,CAAC,aAAa,QAChB,QAAO;AAGT,OAAI,aAAa;AACf,QAAI,EAAE,eAAe,aAAa,SAChC,QAAO;AAGT,WAAO,aAAa,QAAQ;GAC7B;GAID,IAAIE;GACJ,MAAM,eAAe,OAAO,KAAK,aAAa;AAC9C,gBAAa,SAAS,OAAe;AACnC,QAAI,CAAC,wBAAwBC,kBAAgB,KAAK,IAChD,wBAAuB;GAE1B;AAED,OAAI,CAAC,qBACH,cAAa,SAAS,OAAe;AACnC,QAAI,CAAC,qBACH,wBAAuB;GAE1B;AAGH,OAAI,qBACF,QAAO;IAAC;IAAsB,aAAa,QAAQ;IAAwB,GAAI,aAAa,cAAc,CAAC,aAAa,YAAY,GAAG,EAAE;IAAE;AAG7I,UAAO;EACR;CACF;CAED,kBAAkB,WAAsB,YAA2C;AACjF,MAAI,UAAU,OAAO,UACnB,QAAO,KAAK,UAAU,OAAO,WAAW,SAAS,QAAQ;GACvD,MAAMH,WAAS,UAAU,OAAO,UAAW;GAC3C,MAAM,OAAO,YAAYA,YAAUA,SAAO,OAAO;AAEjD,OAAIA,YAAU,KACZ,WAAU,OAAO,UAAW,OAAO,KAAK,IAAI;EAE/C;EAGH,MAAM,kBAAkB,MAAKI,uBAAwB,UAAU,wBAAwB;EAEvF,MAAM,EAAE,aAAa,GAAG,MAAKL;EAC7B,MAAM,eAAe,gBAAgB;AAErC,MAAI,iBAAiB,MAEnB,QAAO,EAAE;EAGX,MAAM,SAAS,MAAM,QAAQ,gBAAgB,aAAa,GAAG,SAAS,aAAa;AAEnF,MAAI,CAAC,OAGH,QAAO,EAAE;AAGX,SAAO,KAAK,mBAAmB;CAChC;CAED,iBAAiB,WAAgD;EAC/D,MAAM,EAAE,aAAa,GAAG,MAAKA;AAE7B,MAAI,UAAU,OAAO,YACnB,WAAU,OAAO,cAAc,KAAK,mBAAmB,UAAU,OAAO;EAG1E,MAAM,cAAc,UAAU,eAAe;AAE7C,MAAI,gBAAgB,MAClB,QAAO;EAGT,MAAM,SAAS,MAAM,QAAQ,eAAe,YAAY,GAAG,SAAS,YAAY;AAEhF,MAAI,CAAC,OACH,QAAO;AAGT,SAAO,KAAK,mBAAmB;CAChC;CAED,oBAAoB,WAAsB,OAAyD;EACjG,MAAM,EAAE,cAAc,UAAU,kBAAkB,GAAG,MAAKA;EAC1D,MAAM,SAAS,UACZ,gBACA,KAAK,WAAW;AACf,UAAO,KAAK,mBAAmB;EAChC,GACA,QAAQ,MAAM,EAAE,OAAO;AAE1B,MAAI,CAAC,OAAO,OACV,QAAO;AAGT,SAAO,OAAO,QACX,QAAQ,mBAAmB;GAC1B,MAAM,WAAW,eAAe,UAAU,cAAc,UAAW,eAAe;GAClF,MAAM,WAAW,CAAC,GAAI,OAAO,YAAa,EAAE,EAAW,eAAe,WAAW,eAAe,OAAO,OAAU,CAAC,OAAO;AAEzH,UAAO;IACL,GAAG;IACH,aAAa,OAAO;IACpB,YAAY,OAAO;IACnB,SAAS,OAAO;IAChB;IACA,YAAY;KACV,GAAG,OAAO;MACT,eAAe,OAAO;MACrB,aAAa,eAAe;MAC5B,GAAG;MACJ;KACF;IACF;EACF,GACD;GAAE,MAAM;GAAU,UAAU,EAAE;GAAE,YAAY,EAAE;GAAE;CAEnD;CAED,MAAM,WAAW;EACf,MAAM,eAAe,IAAI,aAAa,KAAK,KAAK;GAC9C,aAAa;GACb,gBAAgB;GACjB;AAED,SAAO,aAAa,SAAS,EAC3B,QAAQ,EACN,UAAU,EACR,QAAQ,EACN,UAAU,MACX,EACF,EACF,EACF;CACF;AACF;;;;AC/TD,SAAgB,oBAAoB,KAAqC;AACvE,QAAO,OAAO,cAAc,QAAQ,EAAE,aAAa;AACpD;AAKD,SAAgB,sBAAsB,KAAuC;AAC3E,QAAO,OAAO,cAAoC,QAAQ,aAAa,OAAO,IAAI,QAAQ,WAAW;AACtG;AAMD,SAAgB,kBAAkB,KAA6D;AAC7F,QAAO,OAAO,QAAQ;AACvB;;;;;;;AAQD,SAAgB,WAAW,QAA6D;AACtF,QAAO,QAAQ,YAAY,SAAS,iBAAiB;AACtD;;;;;;AAOD,SAAgB,YAAY,KAA2E;AACrG,QAAO,CAAC,CAAC,OAAO,MAAM;AACvB;;;;;;AAOD,SAAgB,gBAAgB,KAAmF;AACjH,QAAO,CAAC,CAAC,OAAO,MAAM,oBAAoB,OAAO,IAAI,kBAAkB;AACxE;;;;;;;;;AAUD,SAAgB,WAAW,QAAgC;AACzD,KAAI,CAAC,OACH,QAAO;AAGT,QAAO,MAAM,QAAQ,OAAO,YAAY,CAAC,CAAC,OAAO,UAAU,SAAS,CAAC,CAAC,OAAO;AAC9E;AAED,SAAgB,WAAW,QAAgC;AACzD,QAAO,CAAC,WAAW;AACpB;AAED,eAAsB,MACpB,WACA,EAAE,WAAW,KAAK,YAAY,MAAM,cAAc,MAA6E,GAAG,EAAE,EACtH;CACd,MAAM,EAAE,YAAY,QAAQ,GAAG,MAAM,OAAO;AAE5C,KAAI,OAAO,cAAc,YAAY,WAAW;EAE9C,MAAM,SAAS,MAAM;EACrB,MAAM,gBAAgB,MAAM,OAAO;GAAE,KAAK;GAAW;GAAQ,MAAM;GAAW;AAE9E,SAAO,MAAM,cAAc,OAAO;CACnC;CAED,MAAM,eAAe,IAAI,aAAa,WAAW;EAC/C;EACA,gBAAgB;EACjB;CACD,MAAM,WAAY,MAAM,aAAa;AAErC,KAAI,oBAAoB,WAAW;EACjC,MAAM,EAAE,SAAS,GAAG,MAAM,gBAAgB,WAAW,UAAU,EAC7D,SAAS,MACV;AAED,SAAO,IAAI,SAAS,EAAE,KAAK,SAAwB;CACpD;AAED,QAAO,IAAI,SAAS,EAAE,KAAK,UAAU;AACtC;AAED,eAAsB,MAAM,WAAwC,EAAE,WAAW,KAAgC,GAAG,EAAE,EAAgB;CACpI,MAAM,YAAY,MAAM,QAAQ,IAAI,UAAU,KAAK,MAAM,MAAM,GAAG;EAAE;EAAU,aAAa;EAAO,WAAW;EAAO;AAEpH,KAAI,UAAU,WAAW,EACvB,OAAM,IAAI,MAAM;CAGlB,MAAM,SAAS,UAAU,QACtB,KAAK,YAAY;AAChB,SAAO,UAAU,KAAK,QAAQ;CAC/B,GACD;EACE,SAAS;EACT,MAAM;GACJ,OAAO;GACP,SAAS;GACV;EACD,OAAO,EAAE;EACT,YAAY,EACV,SAAS,EAAE,EACZ;EACF;AAGH,QAAO,MAAM,QAAQ,EAAE,UAAU;AAClC"}
1
+ {"version":3,"file":"index.js","names":["#options","schema","refSchema: OpenAPIV3.SchemaObject","availablecontentType: string | undefined","matchesMimeType","#getResponseBodyFactory"],"sources":["../src/types.ts","../src/Oas.ts","../src/utils.ts"],"sourcesContent":["import type * as OasTypes from 'oas/types'\n\n// external packages\nexport type { Operation } from 'oas/operation'\nexport type { HttpMethods as HttpMethod } from 'oas/types'\nexport type * as OasTypes from 'oas/types'\nexport type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\n\nexport type contentType = 'application/json' | (string & {})\n\nexport type SchemaObject = OasTypes.SchemaObject & {\n 'x-nullable'?: boolean\n $ref?: string\n}\n\nexport const HttpMethods = {\n GET: 'get',\n POST: 'post',\n PUT: 'put',\n PATCH: 'patch',\n DELETE: 'delete',\n HEAD: 'head',\n OPTIONS: 'options',\n TRACE: 'trace',\n} satisfies Record<Uppercase<OasTypes.HttpMethods>, OasTypes.HttpMethods>\n","import jsonpointer from 'jsonpointer'\nimport BaseOas from 'oas'\nimport type { Operation } from 'oas/operation'\nimport type { MediaTypeObject, OASDocument, ResponseObject, SchemaObject, User } from 'oas/types'\nimport { matchesMimeType } from 'oas/utils'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPIV3 } from 'openapi-types'\nimport type { OasTypes } from './index.ts'\nimport type { contentType } from './types.ts'\nimport { isDiscriminator, isReference } from './utils.ts'\n\ntype Options = {\n contentType?: contentType\n discriminator?: 'strict' | 'inherit'\n}\n\nexport class Oas<const TOAS = unknown> extends BaseOas {\n #options: Options = {\n discriminator: 'strict',\n }\n document: TOAS = undefined as unknown as TOAS\n\n constructor({ oas, user }: { oas: TOAS | OASDocument | string; user?: User }) {\n if (typeof oas === 'string') {\n oas = JSON.parse(oas)\n }\n\n super(oas as OASDocument, user)\n\n this.document = oas as TOAS\n }\n\n setOptions(options: Options) {\n this.#options = options\n }\n\n get options(): Options {\n return this.#options\n }\n\n get($ref: string) {\n const origRef = $ref\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n } else {\n return null\n }\n const current = jsonpointer.get(this.api, $ref)\n\n if (!current) {\n throw new Error(`Could not find a definition for ${origRef}.`)\n }\n return current\n }\n\n getKey($ref: string) {\n const key = $ref.split('/').pop()\n return key === '' ? undefined : key\n }\n set($ref: string, value: unknown) {\n $ref = $ref.trim()\n if ($ref === '') {\n return false\n }\n if ($ref.startsWith('#')) {\n $ref = globalThis.decodeURIComponent($ref.substring(1))\n\n jsonpointer.set(this.api, $ref, value)\n }\n }\n\n getDiscriminator(schema: OasTypes.SchemaObject): OpenAPIV3.DiscriminatorObject | undefined {\n if (!isDiscriminator(schema)) {\n return undefined\n }\n\n const { mapping = {}, propertyName } = schema.discriminator\n\n if (this.#options.discriminator === 'inherit') {\n Object.entries(mapping).forEach(([mappingKey, mappingValue]) => {\n if (mappingValue) {\n const childSchema = this.get(mappingValue)\n if (!childSchema.properties) {\n childSchema.properties = {}\n }\n\n const property = childSchema.properties[propertyName] as SchemaObject\n\n if (childSchema.properties) {\n childSchema.properties[propertyName] = {\n ...(childSchema.properties ? childSchema.properties[propertyName] : {}),\n enum: [...(property?.enum?.filter((value) => value !== mappingKey) ?? []), mappingKey],\n }\n\n childSchema.required = [...(childSchema.required ?? []), propertyName]\n\n this.set(mappingValue, childSchema)\n }\n }\n })\n }\n\n // loop over oneOf and add default mapping when none is defined\n if (schema.oneOf) {\n schema.oneOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n if (schema.anyOf) {\n schema.anyOf.forEach((schema) => {\n if (isReference(schema)) {\n const key = this.getKey(schema.$ref)\n const refSchema: OpenAPIV3.SchemaObject = this.get(schema.$ref)\n // special case where enum in the schema is set without mapping being defined, see https://github.com/kubb-labs/kubb/issues/1669\n const propertySchema = refSchema.properties?.[propertyName] as OpenAPIV3.SchemaObject\n const canAdd = key && !Object.values(mapping).includes(schema.$ref)\n\n if (canAdd && propertySchema?.enum?.length === 1) {\n mapping[propertySchema.enum[0]] = schema.$ref\n } else if (canAdd) {\n mapping[key] = schema.$ref\n }\n }\n })\n }\n\n return {\n ...schema.discriminator,\n mapping,\n }\n }\n\n // TODO add better typing\n dereferenceWithRef(schema?: unknown) {\n if (isReference(schema)) {\n return {\n ...schema,\n ...this.get(schema.$ref),\n $ref: schema.$ref,\n }\n }\n\n return schema\n }\n\n /**\n * Oas does not have a getResponseBody(contentType)\n */\n #getResponseBodyFactory(responseBody: boolean | ResponseObject): (contentType?: string) => MediaTypeObject | false | [string, MediaTypeObject, ...string[]] {\n function hasResponseBody(res = responseBody): res is ResponseObject {\n return !!res\n }\n\n return (contentType) => {\n if (!hasResponseBody(responseBody)) {\n return false\n }\n\n if (isReference(responseBody)) {\n // If the request body is still a `$ref` pointer we should return false because this library\n // assumes that you've run dereferencing beforehand.\n return false\n }\n\n if (!responseBody.content) {\n return false\n }\n\n if (contentType) {\n if (!(contentType in responseBody.content)) {\n return false\n }\n\n return responseBody.content[contentType]!\n }\n\n // Since no media type was supplied we need to find either the first JSON-like media type that\n // we've got, or the first available of anything else if no JSON-like media types are present.\n let availablecontentType: string | undefined\n const contentTypes = Object.keys(responseBody.content)\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType && matchesMimeType.json(mt)) {\n availablecontentType = mt\n }\n })\n\n if (!availablecontentType) {\n contentTypes.forEach((mt: string) => {\n if (!availablecontentType) {\n availablecontentType = mt\n }\n })\n }\n\n if (availablecontentType) {\n return [availablecontentType, responseBody.content[availablecontentType]!, ...(responseBody.description ? [responseBody.description] : [])]\n }\n\n return false\n }\n }\n\n getResponseSchema(operation: Operation, statusCode: string | number): SchemaObject {\n if (operation.schema.responses) {\n Object.keys(operation.schema.responses).forEach((key) => {\n const schema = operation.schema.responses![key]\n const $ref = isReference(schema) ? schema.$ref : undefined\n\n if (schema && $ref) {\n operation.schema.responses![key] = this.get($ref)\n }\n })\n }\n\n const getResponseBody = this.#getResponseBodyFactory(operation.getResponseByStatusCode(statusCode))\n\n const { contentType } = this.#options\n const responseBody = getResponseBody(contentType)\n\n if (responseBody === false) {\n // return empty object because response will always be defined(request does not need a body)\n return {}\n }\n\n const schema = Array.isArray(responseBody) ? responseBody[1].schema : responseBody.schema\n\n if (!schema) {\n // return empty object because response will always be defined(request does not need a body)\n\n return {}\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getRequestSchema(operation: Operation): SchemaObject | undefined {\n const { contentType } = this.#options\n\n if (operation.schema.requestBody) {\n operation.schema.requestBody = this.dereferenceWithRef(operation.schema.requestBody)\n }\n\n const requestBody = operation.getRequestBody(contentType)\n\n if (requestBody === false) {\n return undefined\n }\n\n const schema = Array.isArray(requestBody) ? requestBody[1].schema : requestBody.schema\n\n if (!schema) {\n return undefined\n }\n\n return this.dereferenceWithRef(schema)\n }\n\n getParametersSchema(operation: Operation, inKey: 'path' | 'query' | 'header'): SchemaObject | null {\n const { contentType = operation.getContentType() } = this.#options\n const params = operation\n .getParameters()\n .map((schema) => {\n return this.dereferenceWithRef(schema)\n })\n .filter((v) => v.in === inKey)\n\n if (!params.length) {\n return null\n }\n\n return params.reduce(\n (schema, pathParameters) => {\n const property = pathParameters.content?.[contentType]?.schema ?? (pathParameters.schema as SchemaObject)\n const required = [...(schema.required || ([] as any)), pathParameters.required ? pathParameters.name : undefined].filter(Boolean)\n\n return {\n ...schema,\n description: schema.description,\n deprecated: schema.deprecated,\n example: schema.example,\n required,\n properties: {\n ...schema.properties,\n [pathParameters.name]: {\n description: pathParameters.description,\n ...property,\n },\n },\n }\n },\n { type: 'object', required: [], properties: {} } as SchemaObject,\n )\n }\n\n async valdiate() {\n const oasNormalize = new OASNormalize(this.api, {\n enablePaths: true,\n colorizeErrors: true,\n })\n\n return oasNormalize.validate({\n parser: {\n validate: {\n errors: {\n colorize: true,\n },\n },\n },\n })\n }\n}\n","import type { OASDocument, ParameterObject, SchemaObject } from 'oas/types'\nimport { isRef, isSchema } from 'oas/types'\nimport OASNormalize from 'oas-normalize'\nimport type { OpenAPI, OpenAPIV2, OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'\nimport { isPlainObject, mergeDeep } from 'remeda'\nimport swagger2openapi from 'swagger2openapi'\nimport { Oas } from './Oas.ts'\n\nexport function isOpenApiV2Document(doc: any): doc is OpenAPIV2.Document {\n return doc && isPlainObject(doc) && !('openapi' in doc)\n}\nexport function isOpenApiV3Document(doc: any): doc is OpenAPIV3.Document {\n return doc && isPlainObject(doc) && 'openapi' in doc\n}\n\nexport function isOpenApiV3_1Document(doc: any): doc is OpenAPIV3_1.Document {\n return doc && isPlainObject<OpenAPIV3_1.Document>(doc) && 'openapi' in doc && doc.openapi.startsWith('3.1')\n}\n\nexport function isJSONSchema(obj?: unknown): obj is SchemaObject {\n return !!obj && isSchema(obj)\n}\n\nexport function isParameterObject(obj: ParameterObject | SchemaObject): obj is ParameterObject {\n return obj && 'in' in obj\n}\n\n/**\n * Determines if a schema is nullable, considering both the standard `nullable` property and the legacy `x-nullable` extension.\n *\n * @param schema - The schema object to check.\n * @returns `true` if the schema is marked as nullable; otherwise, `false`.\n */\nexport function isNullable(schema?: SchemaObject & { 'x-nullable'?: boolean }): boolean {\n return schema?.nullable ?? schema?.['x-nullable'] ?? false\n}\n\n/**\n * Determines if the given object is an OpenAPI ReferenceObject.\n *\n * @returns True if {@link obj} is a ReferenceObject; otherwise, false.\n */\nexport function isReference(obj?: any): obj is OpenAPIV3.ReferenceObject | OpenAPIV3_1.ReferenceObject {\n return !!obj && isRef(obj)\n}\n\n/**\n * Determines if the given object is a SchemaObject with a discriminator property of type DiscriminatorObject.\n *\n * @returns True if {@link obj} is a SchemaObject containing a non-string {@link discriminator} property.\n */\nexport function isDiscriminator(obj?: any): obj is SchemaObject & { discriminator: OpenAPIV3.DiscriminatorObject } {\n return !!obj && obj?.['discriminator'] && typeof obj.discriminator !== 'string'\n}\n\n/**\n * Determines whether a schema is required.\n *\n * Returns true if the schema has a non-empty {@link SchemaObject.required} array or a truthy {@link SchemaObject.required} property.\n *\n * @param schema - The schema object to check.\n * @returns True if the schema is required; otherwise, false.\n */\nexport function isRequired(schema?: SchemaObject): boolean {\n if (!schema) {\n return false\n }\n\n return Array.isArray(schema.required) ? !!schema.required?.length : !!schema.required\n}\n\nexport function isOptional(schema?: SchemaObject): boolean {\n return !isRequired(schema)\n}\n\nexport async function parse(\n pathOrApi: string | OASDocument,\n { oasClass = Oas, canBundle = true, enablePaths = true }: { oasClass?: typeof Oas; canBundle?: boolean; enablePaths?: boolean } = {},\n): Promise<Oas> {\n const { loadConfig, bundle } = await import('@redocly/openapi-core')\n\n if (typeof pathOrApi === 'string' && canBundle) {\n // resolve external refs\n const config = await loadConfig()\n const bundleResults = await bundle({ ref: pathOrApi, config, base: pathOrApi })\n\n return parse(bundleResults.bundle.parsed as string)\n }\n\n const oasNormalize = new OASNormalize(pathOrApi, {\n enablePaths,\n colorizeErrors: true,\n })\n const document = (await oasNormalize.load()) as OpenAPI.Document\n\n if (isOpenApiV2Document(document)) {\n const { openapi } = await swagger2openapi.convertObj(document, {\n anchors: true,\n })\n\n return new oasClass({ oas: openapi as OASDocument })\n }\n\n return new oasClass({ oas: document })\n}\n\nexport async function merge(pathOrApi: Array<string | OASDocument>, { oasClass = Oas }: { oasClass?: typeof Oas } = {}): Promise<Oas> {\n const instances = await Promise.all(pathOrApi.map((p) => parse(p, { oasClass, enablePaths: false, canBundle: false })))\n\n if (instances.length === 0) {\n throw new Error('No OAS instances provided for merging.')\n }\n\n const merged = instances.reduce(\n (acc, current) => {\n return mergeDeep(acc, current.document as OASDocument)\n },\n {\n openapi: '3.0.0',\n info: {\n title: 'Merged API',\n version: '1.0.0',\n },\n paths: {},\n components: {\n schemas: {},\n },\n } as any,\n )\n\n return parse(merged, { oasClass })\n}\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kubb/oas",
3
- "version": "3.18.1",
3
+ "version": "3.18.3",
4
4
  "description": "OpenAPI Specification (OAS) utilities and helpers for Kubb, providing parsing, normalization, and manipulation of OpenAPI/Swagger schemas.",
5
5
  "keywords": [
6
6
  "openapi",
@@ -49,7 +49,7 @@
49
49
  "!/**/__tests__/**"
50
50
  ],
51
51
  "dependencies": {
52
- "@redocly/openapi-core": "^2.0.7",
52
+ "@redocly/openapi-core": "^2.0.8",
53
53
  "hotscript": "^1.0.13",
54
54
  "json-schema-to-ts": "^3.1.1",
55
55
  "jsonpointer": "^5.0.1",
@@ -63,9 +63,9 @@
63
63
  "devDependencies": {
64
64
  "@stoplight/yaml": "^4.3.0",
65
65
  "@types/swagger2openapi": "^7.0.4",
66
- "tsdown": "^0.14.1",
66
+ "tsdown": "^0.14.2",
67
67
  "typescript": "^5.9.2",
68
- "@kubb/config-ts": "3.18.1"
68
+ "@kubb/config-ts": "3.18.3"
69
69
  },
70
70
  "engines": {
71
71
  "node": ">=20"