@visulima/jsdoc-open-api 2.0.12 → 2.0.14

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## @visulima/jsdoc-open-api [2.0.14](https://github.com/visulima/visulima/compare/@visulima/jsdoc-open-api@2.0.13...@visulima/jsdoc-open-api@2.0.14) (2024-03-04)
+
+
+### Bug Fixes
+
+* fixed all found type issues ([eaa40d1](https://github.com/visulima/visulima/commit/eaa40d11f3fc056dfddcc25404bf109587ef2862))
+* minifyWhitespace on prod build, removed @tsconfig/* configs ([410cb73](https://github.com/visulima/visulima/commit/410cb737c44c445a0479bdd49b4100d5daf2d83d))
+
+
+
+### Dependencies
+
+* **@visulima/readdir:** upgraded to 2.0.12
+
+## @visulima/jsdoc-open-api [2.0.13](https://github.com/visulima/visulima/compare/@visulima/jsdoc-open-api@2.0.12...@visulima/jsdoc-open-api@2.0.13) (2024-02-26)
+
+
+### Bug Fixes
+
+* update yaml to 2.4.0 ([42961b9](https://github.com/visulima/visulima/commit/42961b98dd7e8c177525c9c92d27ce59301957d2))
+
 ## @visulima/jsdoc-open-api [2.0.12](https://github.com/visulima/visulima/compare/@visulima/jsdoc-open-api@2.0.11...@visulima/jsdoc-open-api@2.0.12) (2024-01-19)
 
 

package/dist/chunk-5I4AUUK5.mjs

@@ -0,0 +1,19 @@
+import { parse } from 'comment-parser';
+import w from 'lodash.mergewith';
+import { readFileSync } from 'fs';
+import R from 'path';
+import I from 'yaml';
+import V from '@apidevtools/swagger-parser';
+
+var S=(t,s)=>{if(Array.isArray(t))return [...t,...s]},d=S;var k=t=>{t.security&&(t.security=Object.keys(t.security).map(s=>({[s]:t.security[s]})));},P=new Set(["integer","number","string","boolean","object","array"]),h={binary:"string",byte:"string",date:"string","date-time":"string",double:"number",float:"number",int32:"integer",int64:"integer",password:"string"},$=t=>{let s=t.type,r=s.endsWith("[]"),e=s.replace(/\[]$/,""),a=P.has(e),n=Object.keys(h).includes(e),o;if(t.default)switch(e){case"integer":case"int32":case"int64":{o=Number.parseInt(t.default,10);break}case"number":case"double":case"float":{o=Number.parseFloat(t.default);break}default:{o=t.default;break}}let c;a?c={default:o,type:e}:n?c={default:o,format:e,type:h[e]}:c={$ref:`#/components/schemas/${e}`};let m=r?{items:{...c},type:"array"}:{...c};e===""&&(m=void 0);let u=t.description.trim().replace(/^- /u,"");return u===""&&(u=void 0),{description:u,name:t.name,rawType:s,required:!t.optional,schema:m}},C=(t,s)=>t.map(r=>{let e=$(r),a="";switch(e.name&&(a+=e.name),e.description&&(a+=` ${e.description.trim()}`),r.tag){case"operationId":case"summary":case"description":return {[r.tag]:a};case"deprecated":return {deprecated:!0};case"externalDocs":return {externalDocs:{description:e.description,url:e.name}};case"server":return {servers:[{description:e.description,url:e.name}]};case"tag":return {tags:[a]};case"cookieParam":case"headerParam":case"queryParam":case"pathParam":return {parameters:[{description:e.description,in:r.tag.replace(/Param$/u,""),name:e.name,required:e.required,schema:e.schema}]};case"bodyContent":return {requestBody:{content:{[e.name.replace("*\\/*","*/*")]:{schema:e.schema}}}};case"bodyExample":{let[n,o]=e.name.split(".");return {requestBody:{content:{[n]:{examples:{[o]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}case"bodyDescription":return {requestBody:{description:a}};case"bodyRequired":return {requestBody:{required:!0}};case"response":return {responses:{[e.name]:{description:e.description}}};case"callback":return {callbacks:{[e.name]:{$ref:`#/components/callbacks/${e.rawType}`}}};case"responseContent":{let[n,o]=e.name.split(".");return {responses:{[n]:{content:{[o]:{schema:e.schema}}}}}}case"responseHeaderComponent":{let[n,o]=e.name.split(".");return {responses:{[n]:{headers:{[o]:{$ref:`#/components/headers/${e.rawType}`}}}}}}case"responseHeader":{let[n,o]=e.name.split(".");return {responses:{[n]:{headers:{[o]:{description:e.description,schema:e.schema}}}}}}case"responseExample":{let[n,o,c]=e.name.split(".");return {responses:{[n]:{content:{[o]:{examples:{[c]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}}case"responseLink":{let[n,o]=e.name.split(".");return {responses:{[n]:{links:{[o]:{$ref:`#/components/links/${e.rawType}`}}}}}}case"bodyComponent":return {requestBody:{$ref:`#/components/requestBodies/${e.rawType}`}};case"responseComponent":return {responses:{[e.name]:{$ref:`#/components/responses/${e.rawType}`}}};case"paramComponent":return {parameters:[{$ref:`#/components/parameters/${e.rawType}`}]};case"security":{let[n,o]=e.name.split("."),c=[];return o&&(c=[o]),{security:{[n]:c}}}default:return {}}}),D=(t,s)=>{let r=/^(GET|PUT|POST|DELETE|OPTIONS|HEAD|PATCH|TRACE) \/.*$/;return parse(t,{spacing:"preserve"}).filter(a=>r.test(a.description.trim())).map(a=>{let n=a.tags.length+1,o=w({},...C(a.tags),d);k(o);let[c,m]=a.description.split(" "),u={[m.trim()]:{[c.toLowerCase().trim()]:{...o}}},A=JSON.parse(JSON.stringify({paths:u}));return {loc:n,spec:A}})},ee=D;var q=t=>t.split(/\r\n|\r|\n/u).filter(e=>/^\s*(#\s*(?:\S.*)?)?$/u.test(e)?!1:e.trim().length>0).length,b=q;var O=new Set(["openapi","info","servers","security","tags","externalDocs","components","paths"]),l=class extends Error{filePath},M=(t,s,r)=>{let e=readFileSync(t,{encoding:"utf8"}),a=R.extname(t);if(a===".yaml"||a===".yml"){let n=I.parse(e),o=Object.keys(n).filter(c=>!O.has(c));if(o.length>0){let c=new l(`Unexpected keys: ${o.join(", ")}`);throw c.filePath=t,c}return Object.keys(n).some(c=>O.has(c))?[{loc:b(e),spec:n}]:[]}try{return s(e,r)}catch(n){throw n.filePath=t,n}},pe=M;var Y=(t,s)=>{Object.keys(s).forEach(r=>{t[r]===void 0?t[r]={...s[r]}:Object.keys(s[r]).forEach(e=>{t[r][e]={...t[r][e],...s[r][e]};});});},j=Y;var f=class{components;externalDocs;info;openapi;paths;security;servers;tags;constructor(s){this.openapi=s.openapi,this.info=s.info,this.paths=s.paths??{},s.servers&&(this.servers=s.servers),s.components&&(this.components=s.components),s.security&&(this.security=s.security),s.tags&&(this.tags=s.tags),s.externalDocs&&(this.externalDocs=s.externalDocs);}addData(s){s.forEach(r=>{let{components:e,paths:a,...n}=r;j(this,{components:e??{},paths:a??{}}),Object.entries(n).forEach(([o,c])=>{this[o]=c;});});}},ye=f;var y=(t,s)=>w({},t,s,(r,e)=>e===null?r:void 0),x=t=>Object.keys(t).map(s=>t[s]).every(s=>typeof s=="object"&&Object.keys(s).every(r=>!(r in s))),g=(t,s)=>s.some(r=>t.name===r.name),E=t=>{switch(t.tag){case"openapi":return "v3";case"asyncapi":return "v4";case"swagger":return "v2";default:return "v2"}};var B=(t,s,r)=>{if(r==="x-webhooks"&&(t[r]=s[r]),r.startsWith("x-"))return;if(["components","consumes","produces","paths","schemas","securityDefinitions","responses","parameters","definitions","channels"].includes(r))Object.keys(s[r]).forEach(a=>{t[r][a]=y(t[r][a],s[r][a]);});else if(r==="tags"){let{tags:a}=s;Array.isArray(a)?a.forEach(n=>{g(n,t.tags)||t.tags.push(n);}):g(a,t.tags)||t.tags.push(a);}else if(r==="security"){let{security:a}=s;t.security=a;}else r.startsWith("/")&&(t.paths[r]=y(t.paths[r],s[r]));},T=B;var J={v2:["paths","definitions","responses","parameters","securityDefinitions"],v3:["paths","definitions","responses","parameters","securityDefinitions","components"],v4:["components","channels"]},H=(t,s)=>t.map(r=>{if((r.tag==="openapi"||r.tag==="swagger"||r.tag==="asyncapi")&&r.description!==""){let e=I.parseDocument(r.description);if(e.errors.length>0){e.errors.map(c=>{let m=c;return m.annotation=r.description,m});let o="Error parsing YAML in @openapi spec:";throw o+=s?e.errors.map(c=>`${c.toString()}
+Imbedded within:
+\`\`\`
+  ${c.annotation?.replace(/\n/gu,`
+  `)}
+\`\`\``).join(`
+`):e.errors.map(c=>c.toString()).join(`
+`),new Error(o)}let a=e.toJSON(),n={tags:[]};return J[E(r)].forEach(o=>{n[o]=n[o]||{};}),Object.keys(a).forEach(o=>{T(n,a,o);}),n}return {}}),U=(t,s)=>parse(t,{spacing:"preserve"}).map(e=>{let a=e.tags.length+1,n=w({},...H(e.tags,s),d);["definitions","responses","parameters","securityDefinitions","components","tags"].forEach(c=>{n[c]!==void 0&&x(n[c])&&delete n[c];});let o=JSON.parse(JSON.stringify(n));return {loc:a,spec:o}}),$e=U;var G=async t=>{await V.validate(t);},Le=G;
+
+export { ee as a, b, pe as c, ye as d, $e as e, Le as f };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=chunk-5I4AUUK5.mjs.map

package/dist/chunk-5I4AUUK5.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jsdoc/comments-to-open-api.ts","../src/util/customizer.ts","../src/util/yaml-loc.ts","../src/parse-file.ts","../src/util/object-merge.ts","../src/spec-builder.ts","../src/swagger-jsdoc/comments-to-open-api.ts","../src/swagger-jsdoc/utils.ts","../src/swagger-jsdoc/organize-swagger-object.ts","../src/validate.ts"],"names":["parseComments","mergeWith","customizer","objectValue","sourceValue","customizer_default","fixSecurityObject","thing","primitiveTypes","formatMap","parseDescription","tag","rawType","isArray","parsedType","isPrimitive","isFormat","defaultValue","rootType","schema","description","tagsToObjects","tags","verbose","parsedResponse","nameAndDescription","contentType","example","status","header","link","security","scopeItem","scope","commentsToOpenApi","fileContents","openAPIRegex","comment","loc","result","method","path","pathsObject","spec","comments_to_open_api_default","yamlLoc","string","line","yaml_loc_default","readFileSync","yaml","ALLOWED_KEYS","ParseError","parseFile","file","fileContent","extension","invalidKeys","key","error","parse_file_default","objectMerge","a","b","subKey","object_merge_default","SpecBuilder","baseDefinition","parsedFile","components","paths","rest","value","spec_builder_default","mergeDeep","first","second","hasEmptyProperty","object","keyObject","isTagPresentInTags","targetTag","getSwaggerVersionFromSpec","organizeSwaggerObject","swaggerObject","annotation","property","definition","organize_swagger_object_default","specificationTemplate","specs","parsed","newError","errorString","parsedDocument","specification","SwaggerParser","validate","validate_default"],"mappings":"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","sourcesContent":["import type { Spec } from \"comment-parser\";\nimport { parse as parseComments } from \"comment-parser\";\n// eslint-disable-next-line no-restricted-imports\nimport mergeWith from \"lodash.mergewith\";\n\nimport type { OpenApiObject, PathsObject } from \"../exported\";\nimport customizer from \"../util/customizer\";\n\n// The security object has a bizare setup...\nconst fixSecurityObject = (thing: any) => {\n    if (thing.security) {\n        // eslint-disable-next-line no-param-reassign\n        thing.security = Object.keys(thing.security).map((s) => {\n            return {\n                [s]: thing.security[s],\n            };\n        });\n    }\n};\n\nconst primitiveTypes = new Set([\"integer\", \"number\", \"string\", \"boolean\", \"object\", \"array\"]);\n\nconst formatMap: Record<string, string> = {\n    binary: \"string\",\n    byte: \"string\",\n    date: \"string\",\n    \"date-time\": \"string\",\n    double: \"number\",\n    float: \"number\",\n    int32: \"integer\",\n    int64: \"integer\",\n    password: \"string\",\n};\n\nconst parseDescription = (tag: Spec): { description: string | undefined; name: string; rawType: string; required: boolean; schema: object | undefined } => {\n    const rawType = tag.type;\n    const isArray = rawType.endsWith(\"[]\");\n    // eslint-disable-next-line regexp/strict\n    const parsedType = rawType.replace(/\\[]$/, \"\");\n\n    const isPrimitive = primitiveTypes.has(parsedType);\n    const isFormat = Object.keys(formatMap).includes(parsedType);\n\n    let defaultValue;\n\n    if (tag.default) {\n        switch (parsedType) {\n            case \"integer\":\n            case \"int32\":\n            case \"int64\": {\n                defaultValue = Number.parseInt(tag.default, 10);\n                break;\n            }\n            case \"number\":\n            case \"double\":\n            case \"float\": {\n                defaultValue = Number.parseFloat(tag.default);\n                break;\n            }\n            default: {\n                defaultValue = tag.default;\n                break;\n            }\n        }\n    }\n\n    let rootType;\n\n    if (isPrimitive) {\n        rootType = { default: defaultValue, type: parsedType };\n    } else if (isFormat) {\n        rootType = {\n            default: defaultValue,\n            format: parsedType,\n            type: formatMap[parsedType],\n        };\n    } else {\n        rootType = { $ref: `#/components/schemas/${parsedType}` };\n    }\n\n    let schema: object | undefined = isArray\n        ? {\n              items: {\n                  ...rootType,\n              },\n              type: \"array\",\n          }\n        : {\n              ...rootType,\n          };\n\n    if (parsedType === \"\") {\n        schema = undefined;\n    }\n\n    // remove the optional dash from the description.\n    let description: string | undefined = tag.description.trim().replace(/^- /u, \"\");\n\n    if (description === \"\") {\n        description = undefined;\n    }\n\n    return {\n        description,\n        name: tag.name,\n        rawType,\n        required: !tag.optional,\n        schema,\n    };\n};\n\n// @ts-expect-error\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst tagsToObjects = (tags: Spec[], verbose?: boolean) =>\n    tags.map((tag) => {\n        const parsedResponse = parseDescription(tag);\n\n        // Some ops only have a `description`, merge `name` and `description`\n        // for these.\n        let nameAndDescription = \"\";\n\n        if (parsedResponse.name) {\n            nameAndDescription += parsedResponse.name;\n        }\n\n        if (parsedResponse.description) {\n            nameAndDescription += ` ${parsedResponse.description.trim()}`;\n        }\n\n        switch (tag.tag) {\n            case \"operationId\":\n            case \"summary\":\n            case \"description\": {\n                return { [tag.tag]: nameAndDescription };\n            }\n\n            case \"deprecated\": {\n                return { deprecated: true };\n            }\n\n            case \"externalDocs\": {\n                return {\n                    externalDocs: {\n                        description: parsedResponse.description,\n                        url: parsedResponse.name,\n                    },\n                };\n            }\n\n            case \"server\": {\n                return {\n                    servers: [\n                        {\n                            description: parsedResponse.description,\n                            url: parsedResponse.name,\n                        },\n                    ],\n                };\n            }\n\n            case \"tag\": {\n                return { tags: [nameAndDescription] };\n            }\n\n            case \"cookieParam\":\n            case \"headerParam\":\n            case \"queryParam\":\n            case \"pathParam\": {\n                return {\n                    parameters: [\n                        {\n                            description: parsedResponse.description,\n                            in: tag.tag.replace(/Param$/u, \"\"),\n                            name: parsedResponse.name,\n                            required: parsedResponse.required,\n                            schema: parsedResponse.schema,\n                        },\n                    ],\n                };\n            }\n\n            case \"bodyContent\": {\n                return {\n                    requestBody: {\n                        content: {\n                            [parsedResponse.name.replace(\"*\\\\/*\", \"*/*\")]: {\n                                schema: parsedResponse.schema,\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"bodyExample\": {\n                const [contentType, example] = parsedResponse.name.split(\".\");\n\n                return {\n                    requestBody: {\n                        content: {\n                            [contentType as string]: {\n                                examples: {\n                                    [example as string]: {\n                                        $ref: `#/components/examples/${parsedResponse.rawType}`,\n                                    },\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"bodyDescription\": {\n                return { requestBody: { description: nameAndDescription } };\n            }\n\n            case \"bodyRequired\": {\n                return { requestBody: { required: true } };\n            }\n\n            case \"response\": {\n                return {\n                    responses: {\n                        [parsedResponse.name]: {\n                            description: parsedResponse.description,\n                        },\n                    },\n                };\n            }\n\n            case \"callback\": {\n                return {\n                    callbacks: {\n                        [parsedResponse.name]: {\n                            $ref: `#/components/callbacks/${parsedResponse.rawType}`,\n                        },\n                    },\n                };\n            }\n\n            case \"responseContent\": {\n                const [status, contentType] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            content: {\n                                [contentType as string]: {\n                                    schema: parsedResponse.schema,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseHeaderComponent\": {\n                const [status, header] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            headers: {\n                                [header as string]: {\n                                    $ref: `#/components/headers/${parsedResponse.rawType}`,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseHeader\": {\n                const [status, header] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            headers: {\n                                [header as string]: {\n                                    description: parsedResponse.description,\n                                    schema: parsedResponse.schema,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseExample\": {\n                const [status, contentType, example] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            content: {\n                                [contentType as string]: {\n                                    examples: {\n                                        [example as string]: {\n                                            $ref: `#/components/examples/${parsedResponse.rawType}`,\n                                        },\n                                    },\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseLink\": {\n                const [status, link] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            links: {\n                                [link as string]: {\n                                    $ref: `#/components/links/${parsedResponse.rawType}`,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"bodyComponent\": {\n                return {\n                    requestBody: {\n                        $ref: `#/components/requestBodies/${parsedResponse.rawType}`,\n                    },\n                };\n            }\n\n            case \"responseComponent\": {\n                return {\n                    responses: {\n                        [parsedResponse.name]: {\n                            $ref: `#/components/responses/${parsedResponse.rawType}`,\n                        },\n                    },\n                };\n            }\n\n            case \"paramComponent\": {\n                return {\n                    parameters: [{ $ref: `#/components/parameters/${parsedResponse.rawType}` }],\n                };\n            }\n\n            case \"security\": {\n                const [security, scopeItem] = parsedResponse.name.split(\".\");\n\n                let scope: string[] = [];\n\n                if (scopeItem) {\n                    scope = [scopeItem];\n                }\n\n                return {\n                    security: { [security as string]: scope },\n                };\n            }\n\n            default: {\n                return {};\n            }\n        }\n    });\n\nconst commentsToOpenApi = (fileContents: string, verbose?: boolean): { loc: number; spec: OpenApiObject }[] => {\n    // eslint-disable-next-line regexp/no-unused-capturing-group\n    const openAPIRegex = /^(GET|PUT|POST|DELETE|OPTIONS|HEAD|PATCH|TRACE) \\/.*$/;\n\n    const jsDocumentComments = parseComments(fileContents, { spacing: \"preserve\" });\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return jsDocumentComments\n        .filter((comment) => openAPIRegex.test(comment.description.trim()))\n        .map((comment) => {\n            // Line count, number of tags + 1 for description.\n            // - Don't count line-breaking due to long descriptions\n            // - Don't count empty lines\n            const loc = comment.tags.length + 1;\n\n            const result = mergeWith({}, ...tagsToObjects(comment.tags, verbose), customizer);\n\n            fixSecurityObject(result);\n\n            const [method, path]: string[] = comment.description.split(\" \");\n\n            const pathsObject: PathsObject = {\n                [(path as string).trim()]: {\n                    [(method as string).toLowerCase().trim()]: {\n                        ...result,\n                    },\n                },\n            };\n\n            // Purge all undefined objects/arrays.\n            const spec = JSON.parse(JSON.stringify({ paths: pathsObject }));\n\n            return {\n                loc,\n                spec,\n            };\n        });\n};\n\nexport default commentsToOpenApi;\n","const customizer = (objectValue: unknown, sourceValue: unknown[]): unknown[] | undefined => {\n    if (Array.isArray(objectValue)) {\n        return [...objectValue, ...sourceValue] as unknown[];\n    }\n\n    return undefined;\n};\n\nexport default customizer;\n","const yamlLoc = (string: string): number => {\n    // Break string into lines.\n    const split = string.split(/\\r\\n|\\r|\\n/u);\n\n    const filtered = split.filter((line) => {\n        // Remove comments.\n        // eslint-disable-next-line security/detect-unsafe-regex,regexp/no-unused-capturing-group\n        if (/^\\s*(#\\s*(?:\\S.*)?)?$/u.test(line)) {\n            return false;\n        }\n        // Remove empty lines.\n        return line.trim().length > 0;\n    });\n\n    return filtered.length;\n};\n\nexport default yamlLoc;\n","import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport yaml from \"yaml\";\n\nimport type { OpenApiObject } from \"./exported\";\nimport yamlLoc from \"./util/yaml-loc\";\n\nconst ALLOWED_KEYS = new Set([\"openapi\", \"info\", \"servers\", \"security\", \"tags\", \"externalDocs\", \"components\", \"paths\"]);\n\nclass ParseError extends Error {\n    public filePath?: string;\n}\n\nconst parseFile = (\n    file: string,\n    commentsToOpenApi: (fileContent: string, verbose?: boolean) => { loc: number; spec: OpenApiObject }[],\n    verbose?: boolean,\n): { loc: number; spec: OpenApiObject }[] => {\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    const fileContent = readFileSync(file, { encoding: \"utf8\" });\n    const extension = path.extname(file);\n\n    if (extension === \".yaml\" || extension === \".yml\") {\n        const spec = yaml.parse(fileContent);\n        const invalidKeys = Object.keys(spec).filter((key) => !ALLOWED_KEYS.has(key));\n\n        if (invalidKeys.length > 0) {\n            const error = new ParseError(`Unexpected keys: ${invalidKeys.join(\", \")}`);\n\n            error.filePath = file;\n\n            throw error;\n        }\n\n        if (Object.keys(spec).some((key) => ALLOWED_KEYS.has(key))) {\n            const loc = yamlLoc(fileContent);\n\n            return [{ loc, spec }];\n        }\n\n        return [];\n    }\n\n    try {\n        return commentsToOpenApi(fileContent, verbose);\n    } catch (error: any) {\n        error.filePath = file;\n\n        throw error;\n    }\n};\n\nexport default parseFile;\n","const objectMerge = <T>(a: T, b: T): void => {\n    Object.keys(b as object).forEach((key) => {\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        if (a[key as keyof typeof b] === undefined) {\n            // eslint-disable-next-line no-param-reassign\n            a[key as keyof typeof b] = {\n                ...b[key as keyof typeof b],\n            };\n        } else {\n            Object.keys(b[key as keyof typeof b] as object).forEach((subKey) => {\n                // eslint-disable-next-line no-param-reassign\n                (a[key as keyof typeof b] as Record<string, object>)[subKey] = {\n                    ...(a[key as keyof typeof b] as Record<string, object>)[subKey],\n                    ...(b[key as keyof typeof b] as Record<string, object>)[subKey],\n                };\n            });\n        }\n    });\n};\n\nexport default objectMerge;\n","import type {\n    BaseDefinition,\n    ComponentsObject,\n    ExternalDocumentationObject,\n    InfoObject,\n    OpenApiObject,\n    PathsObject,\n    SecurityRequirementObject,\n    ServerObject,\n    TagObject,\n} from \"./exported\";\nimport objectMerge from \"./util/object-merge\";\n\nclass SpecBuilder implements OpenApiObject {\n    public components?: ComponentsObject;\n\n    public externalDocs?: ExternalDocumentationObject;\n\n    public info: InfoObject;\n\n    public openapi: string;\n\n    public paths: PathsObject;\n\n    public security?: SecurityRequirementObject[];\n\n    public servers?: ServerObject[];\n\n    public tags?: TagObject[];\n\n    public constructor(baseDefinition: BaseDefinition) {\n        this.openapi = baseDefinition.openapi;\n        this.info = baseDefinition.info;\n        this.paths = baseDefinition.paths ?? {};\n\n        if (baseDefinition.servers) {\n            this.servers = baseDefinition.servers;\n        }\n        if (baseDefinition.components) {\n            this.components = baseDefinition.components;\n        }\n\n        if (baseDefinition.security) {\n            this.security = baseDefinition.security;\n        }\n\n        if (baseDefinition.tags) {\n            this.tags = baseDefinition.tags;\n        }\n\n        if (baseDefinition.externalDocs) {\n            this.externalDocs = baseDefinition.externalDocs;\n        }\n    }\n\n    public addData(parsedFile: OpenApiObject[]): void {\n        parsedFile.forEach((file) => {\n            const { components, paths, ...rest } = file;\n\n            // only merge paths and components\n            objectMerge(this, {\n                components: components ?? {},\n                paths: paths ?? {},\n            } as OpenApiObject);\n\n            // overwrite everything else:\n            Object.entries(rest).forEach(([key, value]) => {\n                // @ts-expect-error\n                this[key as keyof OpenApiObject] = value;\n            });\n        });\n    }\n}\n\nexport default SpecBuilder;\n","import type { Spec } from \"comment-parser\";\nimport { parse as parseComments } from \"comment-parser\";\n// eslint-disable-next-line no-restricted-imports\nimport mergeWith from \"lodash.mergewith\";\nimport type { YAMLError } from \"yaml\";\nimport yaml from \"yaml\";\n\nimport type { OpenApiObject } from \"../exported\";\nimport customizer from \"../util/customizer\";\nimport organizeSwaggerObject from \"./organize-swagger-object\";\nimport { getSwaggerVersionFromSpec, hasEmptyProperty } from \"./utils\";\n\nconst specificationTemplate = {\n    v2: [\"paths\", \"definitions\", \"responses\", \"parameters\", \"securityDefinitions\"],\n    v3: [\"paths\", \"definitions\", \"responses\", \"parameters\", \"securityDefinitions\", \"components\"],\n    v4: [\"components\", \"channels\"],\n};\n\n// eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\ntype ExtendedYAMLError = YAMLError & { annotation?: string };\n\nconst tagsToObjects = (specs: Spec[], verbose?: boolean) =>\n    specs.map((spec: Spec) => {\n        if ((spec.tag === \"openapi\" || spec.tag === \"swagger\" || spec.tag === \"asyncapi\") && spec.description !== \"\") {\n            const parsed = yaml.parseDocument(spec.description);\n\n            if (parsed.errors.length > 0) {\n                parsed.errors.map<ExtendedYAMLError>((error) => {\n                    const newError: ExtendedYAMLError = error;\n\n                    newError.annotation = spec.description;\n\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                    return newError as ExtendedYAMLError;\n                });\n\n                let errorString = \"Error parsing YAML in @openapi spec:\";\n\n                errorString += verbose\n                    ? (parsed.errors as ExtendedYAMLError[])\n\n                          .map((error) => `${error.toString()}\\nImbedded within:\\n\\`\\`\\`\\n  ${error.annotation?.replace(/\\n/gu, \"\\n  \")}\\n\\`\\`\\``)\n                          .join(\"\\n\")\n                    : // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                      parsed.errors.map((error) => error.toString()).join(\"\\n\");\n\n                throw new Error(errorString);\n            }\n\n            const parsedDocument = parsed.toJSON();\n            const specification: Record<string, any> = {\n                tags: [],\n            };\n\n            specificationTemplate[getSwaggerVersionFromSpec(spec)].forEach((property) => {\n                specification[property] = specification[property] || {};\n            });\n\n            Object.keys(parsedDocument).forEach((property) => {\n                organizeSwaggerObject(specification, parsedDocument, property);\n            });\n\n            return specification;\n        }\n\n        return {};\n    });\n\nconst commentsToOpenApi = (fileContents: string, verbose?: boolean): { loc: number; spec: OpenApiObject }[] => {\n    const jsDocumentComments = parseComments(fileContents, { spacing: \"preserve\" });\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return jsDocumentComments.map((comment) => {\n        // Line count, number of tags + 1 for description.\n        // - Don't count line-breaking due to long descriptions\n        // - Don't count empty lines\n        const loc = comment.tags.length + 1;\n        const result = mergeWith({}, ...tagsToObjects(comment.tags, verbose), customizer);\n\n        [\"definitions\", \"responses\", \"parameters\", \"securityDefinitions\", \"components\", \"tags\"].forEach((property) => {\n            if (result[property] !== undefined && hasEmptyProperty(result[property])) {\n                // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n                delete result[property];\n            }\n        });\n\n        // Purge all undefined objects/arrays.\n        const spec = JSON.parse(JSON.stringify(result));\n\n        return {\n            loc,\n            spec,\n        };\n    });\n};\n\nexport default commentsToOpenApi;\n","import type { Spec } from \"comment-parser\";\n// eslint-disable-next-line no-restricted-imports\nimport mergeWith from \"lodash.mergewith\";\n\n/**\n * A recursive deep-merge that ignores null values when merging.\n * This returns the merged object and does not mutate.\n * @param {object} first the first object to get merged\n * @param {object} second the second object to get merged\n */\n// eslint-disable-next-line @typescript-eslint/no-unsafe-return\nexport const mergeDeep = (first?: object, second?: object): object => mergeWith({}, first, second, (a, b) => (b === null ? a : undefined));\n\n/**\n * Checks if there is any properties of the input object which are an empty object\n * @param {object} object - the object to check\n * @returns boolean\n */\nexport const hasEmptyProperty = (object: Record<string, any>): boolean =>\n    Object.keys(object)\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        .map((key) => object[key])\n        .every((keyObject) => typeof keyObject === \"object\" && Object.keys(keyObject).every((key) => !(key in keyObject)));\n\n/**\n * @param {object} tag\n * @param {array} tags\n * @returns boolean\n */\nexport const isTagPresentInTags = (tag: Spec, tags: Spec[]): boolean => tags.some((targetTag) => tag.name === targetTag.name);\n\nexport const getSwaggerVersionFromSpec = (tag: Spec): \"v2\" | \"v3\" | \"v4\" => {\n    switch (tag.tag) {\n        case \"openapi\": {\n            return \"v3\";\n        }\n        case \"asyncapi\": {\n            return \"v4\";\n        }\n        case \"swagger\": {\n            return \"v2\";\n        }\n        default: {\n            return \"v2\";\n        }\n    }\n};\n","import { isTagPresentInTags, mergeDeep } from \"./utils\";\n\n/**\n * @param {object} swaggerObject\n * @param {object} annotation\n * @param {string} property\n */\n\nconst organizeSwaggerObject = (swaggerObject: Record<string, any>, annotation: Record<string, any>, property: string): void => {\n    // Root property on purpose.\n    // eslint-disable-next-line no-secrets/no-secrets\n    // @see https://github.com/OAI/OpenAPI-Specification/blob/master/proposals/002_Webhooks.md#proposed-solution\n    if (property === \"x-webhooks\") {\n        // eslint-disable-next-line no-param-reassign\n        swaggerObject[property] = annotation[property];\n    }\n\n    // Other extensions can be in varying places depending on different vendors and opinions.\n    // The following return makes it so that they are not put in `paths` in the last case.\n    // New specific extensions will need to be handled on case-by-case if to be included in `paths`.\n    if (property.startsWith(\"x-\")) {\n        return;\n    }\n\n    const commonProperties = [\n        \"components\",\n        \"consumes\",\n        \"produces\",\n        \"paths\",\n        \"schemas\",\n        \"securityDefinitions\",\n        \"responses\",\n        \"parameters\",\n        \"definitions\",\n        \"channels\",\n    ];\n\n    if (commonProperties.includes(property)) {\n        Object.keys(annotation[property]).forEach((definition) => {\n            // eslint-disable-next-line no-param-reassign\n            swaggerObject[property][definition] = mergeDeep(swaggerObject[property][definition], annotation[property][definition]);\n        });\n    } else if (property === \"tags\") {\n        const { tags } = annotation;\n\n        if (Array.isArray(tags)) {\n            tags.forEach((tag) => {\n                if (!isTagPresentInTags(tag, swaggerObject[\"tags\"])) {\n                    swaggerObject[\"tags\"].push(tag);\n                }\n            });\n        } else if (!isTagPresentInTags(tags, swaggerObject[\"tags\"])) {\n            swaggerObject[\"tags\"].push(tags);\n        }\n    } else if (property === \"security\") {\n        const { security } = annotation;\n\n        // eslint-disable-next-line no-param-reassign\n        swaggerObject[\"security\"] = security;\n    } else if (property.startsWith(\"/\")) {\n        // Paths which are not defined as \"paths\" property, starting with a slash \"/\"\n        // eslint-disable-next-line no-param-reassign\n        swaggerObject[\"paths\"][property] = mergeDeep(swaggerObject[\"paths\"][property], annotation[property]);\n    }\n};\n\nexport default organizeSwaggerObject;\n","import SwaggerParser from \"@apidevtools/swagger-parser\";\n// eslint-disable-next-line import/no-named-as-default\nimport type OpenAPI from \"openapi-types\";\n\nconst validate = async (spec: Record<string, unknown>): Promise<void> => {\n    await SwaggerParser.validate(spec as OpenAPI.OpenAPI.Document);\n};\n\nexport default validate;\n"]}

package/dist/chunk-JTAGLC6A.mjs

@@ -0,0 +1,50 @@
+import { d, c, a, e, f } from './chunk-5I4AUUK5.mjs';
+import { lstatSync, mkdirSync, writeFileSync, existsSync, realpathSync } from 'fs';
+import { normalize, dirname } from 'path';
+import { pathToFileURL } from 'url';
+import { collect } from '@visulima/readdir';
+import { MultiBar, Presets } from 'cli-progress';
+import V from 'read-pkg-up';
+
+var $=async(r,l,e$1)=>{let o={exclude:[],swaggerDefinition:{}};try{let s=await import(pathToFileURL(normalize(e$1.config??r)).href);s?.default&&(s=s.default),o=s;}catch{throw new Error(`No config file found, on: ${e$1.config??".openapirc.js"}
+`)}let n=new MultiBar({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},Presets.shades_grey),t=new d(o.swaggerDefinition);for await(let s of l){lstatSync(s).isDirectory();let a$1=await collect(s,{extensions:o.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:o.followSymlinks??!1,match:o.include,minimatchOptions:{match:{debug:e$1.verbose,matchBase:!0},skip:{debug:e$1.verbose,matchBase:!0}},skip:[...o.exclude,"node_modules/**"]});(e$1.verbose??e$1.veryVerbose)&&console.log(`
+Found ${a$1.length} files in ${s}`),e$1.veryVerbose&&console.log(a$1);let y=n.create(a$1.length,0);a$1.forEach(c$1=>{e$1.verbose&&console.log(`Parsing file ${c$1}`),y.increment(1,{filename:s});let w=c(c$1,a,e$1.verbose);t.addData(w.map(m=>m.spec));let j=c(c$1,e,e$1.verbose);t.addData(j.map(m=>m.spec));});}e$1.verbose&&console.log("Validating swagger spec"),e$1.veryVerbose&&console.log(JSON.stringify(t,null,2)),await f(JSON.parse(JSON.stringify(t)));let i=e$1.output??"swagger.json";n.stop(),e$1.verbose&&console.log(`Written swagger spec to "${i}" file`),mkdirSync(dirname(i),{recursive:!0}),writeFileSync(i,JSON.stringify(t,null,2)),console.log(`
+Swagger specification is ready, check the "${i}" file.`);},q=$;var A=(r,l=process.cwd())=>{if(existsSync(r))throw new Error("Config file already exists");let e=V.sync({cwd:realpathSync(l)}),o="module.exports =";if(e){let{packageJson:n,path:t}=e;console.info(`Found package.json at "${t}"`),n.type==="module"&&(console.info("Found package.json with type: module, using ES6 as export for the config file"),o="export default");}else console.info("No package.json found");writeFileSync(r,`${o} {
+  exclude: [
+    'coverage/**',
+    '.github/**',
+    'packages/*/test{,s}/**',
+    '**/*.d.ts',
+    'test{,s}/**',
+    'test{,-*}.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',
+    '**/*{.,-}test.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',
+    '**/__tests__/**',
+    '**/{ava,babel,nyc}.config.{js,cjs,mjs}',
+    '**/jest.config.{js,cjs,mjs,ts}',
+    '**/{karma,rollup,webpack}.config.js',
+    '**/.{eslint,mocha}rc.{js,cjs}',
+    '**/.{travis,yarnrc}.yml',
+    '**/{docker-compose,docker}.yml',
+    '**/.yamllint.{yaml,yml}',
+    '**/node_modules/**',
+    '**/pnpm-lock.yaml',
+    '**/pnpm-workspace.yaml',
+    '**/{package,package-lock}.json',
+    '**/yarn.lock',
+    '**/package.json5',
+    '**/.next/**',
+  ],
+  followSymlinks: false,
+  swaggerDefinition: {
+    openapi: '3.0.0',
+    info: {
+      title: 'API',
+      version: '1.0.0',
+    },
+  },
+};
+`),console.log(`Created "${r}"`);},X=A;
+
+export { q as a, X as b };
+//# sourceMappingURL=out.js.map
+//# sourceMappingURL=chunk-JTAGLC6A.mjs.map

package/dist/chunk-JTAGLC6A.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/command/generate-command.ts","../src/cli/command/init-command.ts"],"names":["lstatSync","mkdirSync","writeFileSync","dirname","normalize","pathToFileURL","collect","MultiBar","Presets","generateCommand","configName","paths","options","openapiConfig","config","multibar","spec","spec_builder_default","dir","files","bar","file","parsedJsDocumentFile","parse_file_default","comments_to_open_api_default","item","parsedSwaggerJsDocumentFile","validate_default","output","generate_command_default","existsSync","realpathSync","readPkgUp","initCommand","packageJsonPath","foundPackageJson","exportTemplate","package_","packagePath","init_command_default"],"mappings":"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","sourcesContent":["import { lstatSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, normalize } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nimport type { Options } from \"@visulima/readdir\";\nimport { collect } from \"@visulima/readdir\";\n// eslint-disable-next-line import/no-extraneous-dependencies\nimport { MultiBar, Presets } from \"cli-progress\";\n\nimport type { BaseDefinition } from \"../../exported\";\nimport jsDocumentCommentsToOpenApi from \"../../jsdoc/comments-to-open-api\";\nimport parseFile from \"../../parse-file\";\nimport SpecBuilder from \"../../spec-builder\";\nimport swaggerJsDocumentCommentsToOpenApi from \"../../swagger-jsdoc/comments-to-open-api\";\nimport validate from \"../../validate\";\n\nconst generateCommand = async (\n    configName: string,\n    paths: string[],\n    options: {\n        config?: string;\n        output?: string;\n        verbose?: boolean;\n        veryVerbose?: boolean;\n    },\n    // eslint-disable-next-line sonarjs/cognitive-complexity\n): Promise<void> => {\n    let openapiConfig: {\n        exclude: string[];\n        extensions?: string[];\n        followSymlinks?: boolean;\n        include?: ReadonlyArray<string> | string;\n        swaggerDefinition: BaseDefinition;\n    } = {\n        exclude: [],\n        swaggerDefinition: {} as BaseDefinition,\n    };\n\n    try {\n        let config = await import(pathToFileURL(normalize(options.config ?? configName)).href);\n\n        if (config?.default) {\n            config = config.default;\n        }\n\n        openapiConfig = config;\n    } catch {\n        throw new Error(`No config file found, on: ${options.config ?? \".openapirc.js\"}\\n`);\n    }\n\n    const multibar = new MultiBar(\n        {\n            clearOnComplete: false,\n            format: \"{value}/{total} | {bar} | {filename}\",\n            hideCursor: true,\n        },\n        Presets.shades_grey,\n    );\n    const spec = new SpecBuilder(openapiConfig.swaggerDefinition);\n\n    // eslint-disable-next-line no-restricted-syntax,unicorn/prevent-abbreviations,no-loops/no-loops\n    for await (const dir of paths) {\n        // Check if the path is a directory\n        // eslint-disable-next-line security/detect-non-literal-fs-filename\n        lstatSync(dir).isDirectory();\n\n        const files = await collect(dir, {\n            extensions: openapiConfig.extensions ?? [\".js\", \".cjs\", \".mjs\", \".ts\", \".tsx\", \".jsx\", \".yaml\", \".yml\"],\n            followSymlinks: openapiConfig.followSymlinks ?? false,\n            match: openapiConfig.include,\n            minimatchOptions: {\n                match: {\n                    debug: options.verbose,\n                    matchBase: true,\n                },\n                skip: {\n                    debug: options.verbose,\n                    matchBase: true,\n                },\n            },\n            skip: [...openapiConfig.exclude, \"node_modules/**\"],\n        } as Options);\n\n        if (options.verbose ?? options.veryVerbose) {\n            // eslint-disable-next-line no-console\n            console.log(`\\nFound ${files.length} files in ${dir}`);\n        }\n\n        if (options.veryVerbose) {\n            // eslint-disable-next-line no-console\n            console.log(files);\n        }\n\n        const bar = multibar.create(files.length, 0);\n\n        files.forEach((file) => {\n            if (options.verbose) {\n                // eslint-disable-next-line no-console\n                console.log(`Parsing file ${file}`);\n            }\n\n            bar.increment(1, { filename: dir });\n\n            const parsedJsDocumentFile = parseFile(file, jsDocumentCommentsToOpenApi, options.verbose);\n\n            spec.addData(parsedJsDocumentFile.map((item) => item.spec));\n\n            const parsedSwaggerJsDocumentFile = parseFile(file, swaggerJsDocumentCommentsToOpenApi, options.verbose);\n\n            spec.addData(parsedSwaggerJsDocumentFile.map((item) => item.spec));\n        });\n    }\n\n    if (options.verbose) {\n        // eslint-disable-next-line no-console\n        console.log(\"Validating swagger spec\");\n    }\n\n    if (options.veryVerbose) {\n        // eslint-disable-next-line no-console\n        console.log(JSON.stringify(spec, null, 2));\n    }\n\n    await validate(JSON.parse(JSON.stringify(spec)) as Record<string, unknown>);\n\n    const output = options.output ?? \"swagger.json\";\n\n    multibar.stop();\n\n    if (options.verbose) {\n        // eslint-disable-next-line no-console\n        console.log(`Written swagger spec to \"${output}\" file`);\n    }\n\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    mkdirSync(dirname(output), { recursive: true });\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    writeFileSync(output, JSON.stringify(spec, null, 2));\n\n    // eslint-disable-next-line no-console\n    console.log(`\\nSwagger specification is ready, check the \"${output}\" file.`);\n};\n\nexport default generateCommand;\n","import { existsSync, realpathSync, writeFileSync } from \"node:fs\";\n\nimport readPkgUp from \"read-pkg-up\";\n\nconst initCommand = (configName: string, packageJsonPath = process.cwd()): void => {\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    if (existsSync(configName)) {\n        throw new Error(\"Config file already exists\");\n    }\n\n    const foundPackageJson = readPkgUp.sync({\n        // eslint-disable-next-line security/detect-non-literal-fs-filename\n        cwd: realpathSync(packageJsonPath),\n    });\n\n    let exportTemplate = \"module.exports =\";\n\n    if (foundPackageJson) {\n        // eslint-disable-next-line @typescript-eslint/naming-convention\n        const { packageJson: package_, path: packagePath } = foundPackageJson;\n\n        // eslint-disable-next-line no-console\n        console.info(`Found package.json at \"${packagePath}\"`);\n\n        // eslint-disable-next-line @typescript-eslint/dot-notation\n        if (package_[\"type\"] === \"module\") {\n            // eslint-disable-next-line no-console\n            console.info(\"Found package.json with type: module, using ES6 as export for the config file\");\n\n            exportTemplate = \"export default\";\n        }\n    } else {\n        // eslint-disable-next-line no-console\n        console.info(\"No package.json found\");\n    }\n\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    writeFileSync(\n        configName,\n        `${exportTemplate} {\n  exclude: [\n    'coverage/**',\n    '.github/**',\n    'packages/*/test{,s}/**',\n    '**/*.d.ts',\n    'test{,s}/**',\n    'test{,-*}.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',\n    '**/*{.,-}test.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',\n    '**/__tests__/**',\n    '**/{ava,babel,nyc}.config.{js,cjs,mjs}',\n    '**/jest.config.{js,cjs,mjs,ts}',\n    '**/{karma,rollup,webpack}.config.js',\n    '**/.{eslint,mocha}rc.{js,cjs}',\n    '**/.{travis,yarnrc}.yml',\n    '**/{docker-compose,docker}.yml',\n    '**/.yamllint.{yaml,yml}',\n    '**/node_modules/**',\n    '**/pnpm-lock.yaml',\n    '**/pnpm-workspace.yaml',\n    '**/{package,package-lock}.json',\n    '**/yarn.lock',\n    '**/package.json5',\n    '**/.next/**',\n  ],\n  followSymlinks: false,\n  swaggerDefinition: {\n    openapi: '3.0.0',\n    info: {\n      title: 'API',\n      version: '1.0.0',\n    },\n  },\n};\n`,\n    );\n\n    // eslint-disable-next-line no-console\n    console.log(`Created \"${configName}\"`);\n};\n\nexport default initCommand;\n"]}

package/dist/{chunk-QPIZ6QWT.js → chunk-LJFBEOEV.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkT6JDVCNR_js = require('./chunk-T6JDVCNR.js');
+var chunkRZ5CXKJD_js = require('./chunk-RZ5CXKJD.js');
 var fs = require('fs');
 var path = require('path');
 var url = require('url');
@@ -12,10 +12,10 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var P__default = /*#__PURE__*/_interopDefault(P);
 
-var $=async(n,l,e)=>{let o={exclude:[],swaggerDefinition:{}};try{let s=await import(url.pathToFileURL(path.normalize(e.config??n)).href);s?.default&&(s=s.default),o=s;}catch{throw new Error(`No config file found, on: ${e.config??".openapirc.js"}
-`)}let r=new cliProgress.MultiBar({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},cliProgress.Presets.shades_grey),t=new chunkT6JDVCNR_js.d(o.swaggerDefinition);for await(let s of l){fs.lstatSync(s).isDirectory();let i=await readdir.collect(s,{extensions:o.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:o.followSymlinks??!1,match:o.include,minimatchOptions:{match:{debug:e.verbose,matchBase:!0},skip:{debug:e.verbose,matchBase:!0}},skip:[...o.exclude,"node_modules/**"]});(e.verbose??e.veryVerbose)&&console.log(`
-Found ${i.length} files in ${s}`),e.veryVerbose&&console.log(i);let y=r.create(i.length,0);i.forEach(c=>{e.verbose&&console.log(`Parsing file ${c}`),y.increment(1,{filename:s});let w=chunkT6JDVCNR_js.c(c,chunkT6JDVCNR_js.a,e.verbose);t.addData(w.map(m=>m.spec));let j=chunkT6JDVCNR_js.c(c,chunkT6JDVCNR_js.e,e.verbose);t.addData(j.map(m=>m.spec));});}e.verbose&&console.log("Validating swagger spec"),e.veryVerbose&&console.log(JSON.stringify(t,null,2)),await chunkT6JDVCNR_js.f(JSON.parse(JSON.stringify(t)));let a=e.output??"swagger.json";r.stop(),e.verbose&&console.log(`Written swagger spec to "${a}" file`),fs.mkdirSync(path.dirname(a),{recursive:!0}),fs.writeFileSync(a,JSON.stringify(t,null,2)),console.log(`
-Swagger specification is ready, check the "${a}" file.`);},W=$;var V=(n,l=process.cwd())=>{if(fs.existsSync(n))throw new Error("Config file already exists");let e=P__default.default.sync({cwd:fs.realpathSync(l)}),o="module.exports =";if(e){let{packageJson:r,path:t}=e;console.info(`Found package.json at "${t}"`),r.type==="module"&&(console.info("Found package.json with type: module, using ES6 as export for the config file"),o="export default");}else console.info("No package.json found");fs.writeFileSync(n,`${o} {
+var J=async(r,l,e)=>{let o={exclude:[],swaggerDefinition:{}};try{let s=await import(url.pathToFileURL(path.normalize(e.config??r)).href);s?.default&&(s=s.default),o=s;}catch{throw new Error(`No config file found, on: ${e.config??".openapirc.js"}
+`)}let n=new cliProgress.MultiBar({clearOnComplete:!1,format:"{value}/{total} | {bar} | {filename}",hideCursor:!0},cliProgress.Presets.shades_grey),t=new chunkRZ5CXKJD_js.d(o.swaggerDefinition);for await(let s of l){fs.lstatSync(s).isDirectory();let a=await readdir.collect(s,{extensions:o.extensions??[".js",".cjs",".mjs",".ts",".tsx",".jsx",".yaml",".yml"],followSymlinks:o.followSymlinks??!1,match:o.include,minimatchOptions:{match:{debug:e.verbose,matchBase:!0},skip:{debug:e.verbose,matchBase:!0}},skip:[...o.exclude,"node_modules/**"]});(e.verbose??e.veryVerbose)&&console.log(`
+Found ${a.length} files in ${s}`),e.veryVerbose&&console.log(a);let y=n.create(a.length,0);a.forEach(c=>{e.verbose&&console.log(`Parsing file ${c}`),y.increment(1,{filename:s});let w=chunkRZ5CXKJD_js.c(c,chunkRZ5CXKJD_js.a,e.verbose);t.addData(w.map(m=>m.spec));let j=chunkRZ5CXKJD_js.c(c,chunkRZ5CXKJD_js.e,e.verbose);t.addData(j.map(m=>m.spec));});}e.verbose&&console.log("Validating swagger spec"),e.veryVerbose&&console.log(JSON.stringify(t,null,2)),await chunkRZ5CXKJD_js.f(JSON.parse(JSON.stringify(t)));let i=e.output??"swagger.json";n.stop(),e.verbose&&console.log(`Written swagger spec to "${i}" file`),fs.mkdirSync(path.dirname(i),{recursive:!0}),fs.writeFileSync(i,JSON.stringify(t,null,2)),console.log(`
+Swagger specification is ready, check the "${i}" file.`);},W=J;var V=(r,l=process.cwd())=>{if(fs.existsSync(r))throw new Error("Config file already exists");let e=P__default.default.sync({cwd:fs.realpathSync(l)}),o="module.exports =";if(e){let{packageJson:n,path:t}=e;console.info(`Found package.json at "${t}"`),n.type==="module"&&(console.info("Found package.json with type: module, using ES6 as export for the config file"),o="export default");}else console.info("No package.json found");fs.writeFileSync(r,`${o} {
   exclude: [
     'coverage/**',
     '.github/**',
@@ -49,9 +49,9 @@ Swagger specification is ready, check the "${a}" file.`);},W=$;var V=(n,l=proces
     },
   },
 };
-`),console.log(`Created "${n}"`);},Q=V;
+`),console.log(`Created "${r}"`);},Q=V;
 
 exports.a = W;
 exports.b = Q;
 //# sourceMappingURL=out.js.map
-//# sourceMappingURL=chunk-QPIZ6QWT.js.map
+//# sourceMappingURL=chunk-LJFBEOEV.js.map

package/dist/chunk-LJFBEOEV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/command/generate-command.ts","../src/cli/command/init-command.ts"],"names":["lstatSync","mkdirSync","writeFileSync","dirname","normalize","pathToFileURL","collect","MultiBar","Presets","generateCommand","configName","paths","options","openapiConfig","config","multibar","spec","spec_builder_default","dir","files","bar","file","parsedJsDocumentFile","parse_file_default","comments_to_open_api_default","item","parsedSwaggerJsDocumentFile","validate_default","output","generate_command_default","existsSync","realpathSync","readPkgUp","initCommand","packageJsonPath","foundPackageJson","exportTemplate","package_","packagePath","init_command_default"],"mappings":"oEAAA,OAAS,aAAAA,EAAW,aAAAC,EAAW,iBAAAC,MAAqB,KACpD,OAAS,WAAAC,EAAS,aAAAC,MAAiB,OACnC,OAAS,iBAAAC,MAAqB,MAG9B,OAAS,WAAAC,MAAe,oBAExB,OAAS,YAAAC,EAAU,WAAAC,MAAe,eASlC,IAAMC,EAAkB,MACpBC,EACAC,EACAC,IAOgB,CAChB,IAAIC,EAMA,CACA,QAAS,CAAC,EACV,kBAAmB,CAAC,CACxB,EAEA,GAAI,CACA,IAAIC,EAAS,MAAM,OAAOT,EAAcD,EAAUQ,EAAQ,QAAUF,CAAU,CAAC,EAAE,MAE7EI,GAAQ,UACRA,EAASA,EAAO,SAGpBD,EAAgBC,CACpB,MAAQ,CACJ,MAAM,IAAI,MAAM,6BAA6BF,EAAQ,QAAU,eAAe;AAAA,CAAI,CACtF,CAEA,IAAMG,EAAW,IAAIR,EACjB,CACI,gBAAiB,GACjB,OAAQ,uCACR,WAAY,EAChB,EACAC,EAAQ,WACZ,EACMQ,EAAO,IAAIC,EAAYJ,EAAc,iBAAiB,EAG5D,cAAiBK,KAAOP,EAAO,CAG3BX,EAAUkB,CAAG,EAAE,YAAY,EAE3B,IAAMC,EAAQ,MAAMb,EAAQY,EAAK,CAC7B,WAAYL,EAAc,YAAc,CAAC,MAAO,OAAQ,OAAQ,MAAO,OAAQ,OAAQ,QAAS,MAAM,EACtG,eAAgBA,EAAc,gBAAkB,GAChD,MAAOA,EAAc,QACrB,iBAAkB,CACd,MAAO,CACH,MAAOD,EAAQ,QACf,UAAW,EACf,EACA,KAAM,CACF,MAAOA,EAAQ,QACf,UAAW,EACf,CACJ,EACA,KAAM,CAAC,GAAGC,EAAc,QAAS,iBAAiB,CACtD,CAAY,GAERD,EAAQ,SAAWA,EAAQ,cAE3B,QAAQ,IAAI;AAAA,QAAWO,EAAM,MAAM,aAAaD,CAAG,EAAE,EAGrDN,EAAQ,aAER,QAAQ,IAAIO,CAAK,EAGrB,IAAMC,EAAML,EAAS,OAAOI,EAAM,OAAQ,CAAC,EAE3CA,EAAM,QAASE,GAAS,CAChBT,EAAQ,SAER,QAAQ,IAAI,gBAAgBS,CAAI,EAAE,EAGtCD,EAAI,UAAU,EAAG,CAAE,SAAUF,CAAI,CAAC,EAElC,IAAMI,EAAuBC,EAAUF,EAAMG,EAA6BZ,EAAQ,OAAO,EAEzFI,EAAK,QAAQM,EAAqB,IAAKG,GAASA,EAAK,IAAI,CAAC,EAE1D,IAAMC,EAA8BH,EAAUF,EAAMG,EAAoCZ,EAAQ,OAAO,EAEvGI,EAAK,QAAQU,EAA4B,IAAKD,GAASA,EAAK,IAAI,CAAC,CACrE,CAAC,CACL,CAEIb,EAAQ,SAER,QAAQ,IAAI,yBAAyB,EAGrCA,EAAQ,aAER,QAAQ,IAAI,KAAK,UAAUI,EAAM,KAAM,CAAC,CAAC,EAG7C,MAAMW,EAAS,KAAK,MAAM,KAAK,UAAUX,CAAI,CAAC,CAA4B,EAE1E,IAAMY,EAAShB,EAAQ,QAAU,eAEjCG,EAAS,KAAK,EAEVH,EAAQ,SAER,QAAQ,IAAI,4BAA4BgB,CAAM,QAAQ,EAI1D3B,EAAUE,EAAQyB,CAAM,EAAG,CAAE,UAAW,EAAK,CAAC,EAE9C1B,EAAc0B,EAAQ,KAAK,UAAUZ,EAAM,KAAM,CAAC,CAAC,EAGnD,QAAQ,IAAI;AAAA,6CAAgDY,CAAM,SAAS,CAC/E,EAEOC,EAAQpB,EC/If,OAAS,cAAAqB,EAAY,gBAAAC,EAAc,iBAAA7B,MAAqB,KAExD,OAAO8B,MAAe,cAEtB,IAAMC,EAAc,CAACvB,EAAoBwB,EAAkB,QAAQ,IAAI,IAAY,CAE/E,GAAIJ,EAAWpB,CAAU,EACrB,MAAM,IAAI,MAAM,4BAA4B,EAGhD,IAAMyB,EAAmBH,EAAU,KAAK,CAEpC,IAAKD,EAAaG,CAAe,CACrC,CAAC,EAEGE,EAAiB,mBAErB,GAAID,EAAkB,CAElB,GAAM,CAAE,YAAaE,EAAU,KAAMC,CAAY,EAAIH,EAGrD,QAAQ,KAAK,0BAA0BG,CAAW,GAAG,EAGjDD,EAAS,OAAY,WAErB,QAAQ,KAAK,+EAA+E,EAE5FD,EAAiB,iBAEzB,MAEI,QAAQ,KAAK,uBAAuB,EAIxClC,EACIQ,EACA,GAAG0B,CAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAmCrB,EAGA,QAAQ,IAAI,YAAY1B,CAAU,GAAG,CACzC,EAEO6B,EAAQN","sourcesContent":["import { lstatSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { dirname, normalize } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\nimport type { Options } from \"@visulima/readdir\";\nimport { collect } from \"@visulima/readdir\";\n// eslint-disable-next-line import/no-extraneous-dependencies\nimport { MultiBar, Presets } from \"cli-progress\";\n\nimport type { BaseDefinition } from \"../../exported\";\nimport jsDocumentCommentsToOpenApi from \"../../jsdoc/comments-to-open-api\";\nimport parseFile from \"../../parse-file\";\nimport SpecBuilder from \"../../spec-builder\";\nimport swaggerJsDocumentCommentsToOpenApi from \"../../swagger-jsdoc/comments-to-open-api\";\nimport validate from \"../../validate\";\n\nconst generateCommand = async (\n    configName: string,\n    paths: string[],\n    options: {\n        config?: string;\n        output?: string;\n        verbose?: boolean;\n        veryVerbose?: boolean;\n    },\n    // eslint-disable-next-line sonarjs/cognitive-complexity\n): Promise<void> => {\n    let openapiConfig: {\n        exclude: string[];\n        extensions?: string[];\n        followSymlinks?: boolean;\n        include?: ReadonlyArray<string> | string;\n        swaggerDefinition: BaseDefinition;\n    } = {\n        exclude: [],\n        swaggerDefinition: {} as BaseDefinition,\n    };\n\n    try {\n        let config = await import(pathToFileURL(normalize(options.config ?? configName)).href);\n\n        if (config?.default) {\n            config = config.default;\n        }\n\n        openapiConfig = config;\n    } catch {\n        throw new Error(`No config file found, on: ${options.config ?? \".openapirc.js\"}\\n`);\n    }\n\n    const multibar = new MultiBar(\n        {\n            clearOnComplete: false,\n            format: \"{value}/{total} | {bar} | {filename}\",\n            hideCursor: true,\n        },\n        Presets.shades_grey,\n    );\n    const spec = new SpecBuilder(openapiConfig.swaggerDefinition);\n\n    // eslint-disable-next-line no-restricted-syntax,unicorn/prevent-abbreviations,no-loops/no-loops\n    for await (const dir of paths) {\n        // Check if the path is a directory\n        // eslint-disable-next-line security/detect-non-literal-fs-filename\n        lstatSync(dir).isDirectory();\n\n        const files = await collect(dir, {\n            extensions: openapiConfig.extensions ?? [\".js\", \".cjs\", \".mjs\", \".ts\", \".tsx\", \".jsx\", \".yaml\", \".yml\"],\n            followSymlinks: openapiConfig.followSymlinks ?? false,\n            match: openapiConfig.include,\n            minimatchOptions: {\n                match: {\n                    debug: options.verbose,\n                    matchBase: true,\n                },\n                skip: {\n                    debug: options.verbose,\n                    matchBase: true,\n                },\n            },\n            skip: [...openapiConfig.exclude, \"node_modules/**\"],\n        } as Options);\n\n        if (options.verbose ?? options.veryVerbose) {\n            // eslint-disable-next-line no-console\n            console.log(`\\nFound ${files.length} files in ${dir}`);\n        }\n\n        if (options.veryVerbose) {\n            // eslint-disable-next-line no-console\n            console.log(files);\n        }\n\n        const bar = multibar.create(files.length, 0);\n\n        files.forEach((file) => {\n            if (options.verbose) {\n                // eslint-disable-next-line no-console\n                console.log(`Parsing file ${file}`);\n            }\n\n            bar.increment(1, { filename: dir });\n\n            const parsedJsDocumentFile = parseFile(file, jsDocumentCommentsToOpenApi, options.verbose);\n\n            spec.addData(parsedJsDocumentFile.map((item) => item.spec));\n\n            const parsedSwaggerJsDocumentFile = parseFile(file, swaggerJsDocumentCommentsToOpenApi, options.verbose);\n\n            spec.addData(parsedSwaggerJsDocumentFile.map((item) => item.spec));\n        });\n    }\n\n    if (options.verbose) {\n        // eslint-disable-next-line no-console\n        console.log(\"Validating swagger spec\");\n    }\n\n    if (options.veryVerbose) {\n        // eslint-disable-next-line no-console\n        console.log(JSON.stringify(spec, null, 2));\n    }\n\n    await validate(JSON.parse(JSON.stringify(spec)) as Record<string, unknown>);\n\n    const output = options.output ?? \"swagger.json\";\n\n    multibar.stop();\n\n    if (options.verbose) {\n        // eslint-disable-next-line no-console\n        console.log(`Written swagger spec to \"${output}\" file`);\n    }\n\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    mkdirSync(dirname(output), { recursive: true });\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    writeFileSync(output, JSON.stringify(spec, null, 2));\n\n    // eslint-disable-next-line no-console\n    console.log(`\\nSwagger specification is ready, check the \"${output}\" file.`);\n};\n\nexport default generateCommand;\n","import { existsSync, realpathSync, writeFileSync } from \"node:fs\";\n\nimport readPkgUp from \"read-pkg-up\";\n\nconst initCommand = (configName: string, packageJsonPath = process.cwd()): void => {\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    if (existsSync(configName)) {\n        throw new Error(\"Config file already exists\");\n    }\n\n    const foundPackageJson = readPkgUp.sync({\n        // eslint-disable-next-line security/detect-non-literal-fs-filename\n        cwd: realpathSync(packageJsonPath),\n    });\n\n    let exportTemplate = \"module.exports =\";\n\n    if (foundPackageJson) {\n        // eslint-disable-next-line @typescript-eslint/naming-convention\n        const { packageJson: package_, path: packagePath } = foundPackageJson;\n\n        // eslint-disable-next-line no-console\n        console.info(`Found package.json at \"${packagePath}\"`);\n\n        // eslint-disable-next-line @typescript-eslint/dot-notation\n        if (package_[\"type\"] === \"module\") {\n            // eslint-disable-next-line no-console\n            console.info(\"Found package.json with type: module, using ES6 as export for the config file\");\n\n            exportTemplate = \"export default\";\n        }\n    } else {\n        // eslint-disable-next-line no-console\n        console.info(\"No package.json found\");\n    }\n\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    writeFileSync(\n        configName,\n        `${exportTemplate} {\n  exclude: [\n    'coverage/**',\n    '.github/**',\n    'packages/*/test{,s}/**',\n    '**/*.d.ts',\n    'test{,s}/**',\n    'test{,-*}.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',\n    '**/*{.,-}test.{js,cjs,mjs,ts,tsx,jsx,yaml,yml}',\n    '**/__tests__/**',\n    '**/{ava,babel,nyc}.config.{js,cjs,mjs}',\n    '**/jest.config.{js,cjs,mjs,ts}',\n    '**/{karma,rollup,webpack}.config.js',\n    '**/.{eslint,mocha}rc.{js,cjs}',\n    '**/.{travis,yarnrc}.yml',\n    '**/{docker-compose,docker}.yml',\n    '**/.yamllint.{yaml,yml}',\n    '**/node_modules/**',\n    '**/pnpm-lock.yaml',\n    '**/pnpm-workspace.yaml',\n    '**/{package,package-lock}.json',\n    '**/yarn.lock',\n    '**/package.json5',\n    '**/.next/**',\n  ],\n  followSymlinks: false,\n  swaggerDefinition: {\n    openapi: '3.0.0',\n    info: {\n      title: 'API',\n      version: '1.0.0',\n    },\n  },\n};\n`,\n    );\n\n    // eslint-disable-next-line no-console\n    console.log(`Created \"${configName}\"`);\n};\n\nexport default initCommand;\n"]}

package/dist/{chunk-T6JDVCNR.js → chunk-RZ5CXKJD.js}

@@ -3,31 +3,31 @@
 var commentParser = require('comment-parser');
 var v = require('lodash.mergewith');
 var fs = require('fs');
-var R = require('path');
-var L = require('yaml');
+var L = require('path');
+var R = require('yaml');
 var U = require('@apidevtools/swagger-parser');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var v__default = /*#__PURE__*/_interopDefault(v);
-var R__default = /*#__PURE__*/_interopDefault(R);
 var L__default = /*#__PURE__*/_interopDefault(L);
+var R__default = /*#__PURE__*/_interopDefault(R);
 var U__default = /*#__PURE__*/_interopDefault(U);
 
-var S=(t,s)=>{if(Array.isArray(t))return [...t,...s]},u=S;var w=t=>{t.security&&(t.security=Object.keys(t.security).map(s=>({[s]:t.security[s]})));},k=new Set(["integer","number","string","boolean","object","array"]),g={binary:"string",byte:"string",date:"string","date-time":"string",double:"number",float:"number",int32:"integer",int64:"integer",password:"string"},P=t=>{let s=t.type,r=s.endsWith("[]"),e=s.replace(/\[]$/,""),a=k.has(e),n=Object.keys(g).includes(e),o;if(t.default)switch(e){case"integer":case"int32":case"int64":{o=Number.parseInt(t.default,10);break}case"number":case"double":case"float":{o=Number.parseFloat(t.default);break}default:{o=t.default;break}}let i;a?i={default:o,type:e}:n?i={default:o,format:e,type:g[e]}:i={$ref:`#/components/schemas/${e}`};let p=r?{items:{...i},type:"array"}:{...i};e===""&&(p=void 0);let m=t.description.trim().replace(/^- /u,"");return m===""&&(m=void 0),{description:m,name:t.name,rawType:s,required:!t.optional,schema:p}},$=(t,s)=>t.map(r=>{let e=P(r),a="";switch(e.name&&(a+=e.name),e.description&&(a+=` ${e.description.trim()}`),r.tag){case"operationId":case"summary":case"description":return {[r.tag]:a};case"deprecated":return {deprecated:!0};case"externalDocs":return {externalDocs:{description:e.description,url:e.name}};case"server":return {servers:[{description:e.description,url:e.name}]};case"tag":return {tags:[a]};case"cookieParam":case"headerParam":case"queryParam":case"pathParam":return {parameters:[{description:e.description,in:r.tag.replace(/Param$/u,""),name:e.name,required:e.required,schema:e.schema}]};case"bodyContent":return {requestBody:{content:{[e.name.replace("*\\/*","*/*")]:{schema:e.schema}}}};case"bodyExample":{let[n,o]=e.name.split(".");return {requestBody:{content:{[n]:{examples:{[o]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}case"bodyDescription":return {requestBody:{description:a}};case"bodyRequired":return {requestBody:{required:!0}};case"response":return {responses:{[e.name]:{description:e.description}}};case"callback":return {callbacks:{[e.name]:{$ref:`#/components/callbacks/${e.rawType}`}}};case"responseContent":{let[n,o]=e.name.split(".");return {responses:{[n]:{content:{[o]:{schema:e.schema}}}}}}case"responseHeaderComponent":{let[n,o]=e.name.split(".");return {responses:{[n]:{headers:{[o]:{$ref:`#/components/headers/${e.rawType}`}}}}}}case"responseHeader":{let[n,o]=e.name.split(".");return {responses:{[n]:{headers:{[o]:{description:e.description,schema:e.schema}}}}}}case"responseExample":{let[n,o,i]=e.name.split(".");return {responses:{[n]:{content:{[o]:{examples:{[i]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}}case"responseLink":{let[n,o]=e.name.split(".");return {responses:{[n]:{links:{[o]:{$ref:`#/components/links/${e.rawType}`}}}}}}case"bodyComponent":return {requestBody:{$ref:`#/components/requestBodies/${e.rawType}`}};case"responseComponent":return {responses:{[e.name]:{$ref:`#/components/responses/${e.rawType}`}}};case"paramComponent":return {parameters:[{$ref:`#/components/parameters/${e.rawType}`}]};case"security":{let[n,o]=e.name.split("."),i=[];return o&&(i=[o]),{security:{[n]:i}}}default:return {}}}),D=(t,s)=>{let r=/^(GET|PUT|POST|DELETE|OPTIONS|HEAD|PATCH|TRACE) \/.*$/;return commentParser.parse(t,{spacing:"preserve"}).filter(a=>r.test(a.description.trim())).map(a=>{let n=a.tags.length+1,o=v__default.default({},...$(a.tags),u);w(o);let[i,p]=a.description.split(" "),m={[p.trim()]:{[i.toLowerCase().trim()]:{...o}}},E=JSON.parse(JSON.stringify({paths:m}));return {loc:n,spec:E}})},Z=D;var C=t=>t.split(/\r\n|\r|\n/u).filter(e=>/^\s*(#\s*(?:\S.*)?)?$/u.test(e)?!1:e.trim().length>0).length,b=C;var h=new Set(["openapi","info","servers","security","tags","externalDocs","components","paths"]),d=class extends Error{},I=(t,s,r)=>{let e=fs.readFileSync(t,{encoding:"utf8"}),a=R__default.default.extname(t);if(a===".yaml"||a===".yml"){let n=L__default.default.parse(e),o=Object.keys(n).filter(i=>!h.has(i));if(o.length>0){let i=new d(`Unexpected keys: ${o.join(", ")}`);throw i.filePath=t,i}return Object.keys(n).some(i=>h.has(i))?[{loc:b(e),spec:n}]:[]}try{return s(e,r)}catch(n){throw n.filePath=t,n}},ce=I;var M=(t,s)=>{Object.keys(s).forEach(r=>{t[r]===void 0?t[r]={...s[r]}:Object.keys(s[r]).forEach(e=>{t[r][e]={...t[r][e],...s[r][e]};});});},O=M;var l=class{constructor(s){this.openapi=s.openapi,this.info=s.info,this.servers=s.servers,this.paths=s.paths??{},this.components=s.components,this.security=s.security,this.tags=s.tags,this.externalDocs=s.externalDocs;}addData(s){s.forEach(r=>{let{components:e,paths:a,...n}=r;O(this,{components:e??{},paths:a??{}}),Object.entries(n).forEach(([o,i])=>{this[o]=i;});});}},fe=l;var f=(t,s)=>v__default.default({},t,s,(r,e)=>e===null?r:void 0),j=t=>Object.keys(t).map(s=>t[s]).every(s=>typeof s=="object"&&Object.keys(s).every(r=>!(r in s))),y=(t,s)=>s.some(r=>t.name===r.name),x=t=>{switch(t.tag){case"openapi":return "v3";case"asyncapi":return "v4";case"swagger":return "v2";default:return "v2"}};var Y=(t,s,r)=>{if(r==="x-webhooks"&&(t[r]=s[r]),r.startsWith("x-"))return;if(["components","consumes","produces","paths","schemas","securityDefinitions","responses","parameters","definitions","channels"].includes(r))Object.keys(s[r]).forEach(a=>{t[r][a]=f(t[r][a],s[r][a]);});else if(r==="tags"){let{tags:a}=s;Array.isArray(a)?a.forEach(n=>{y(n,t.tags)||t.tags.push(n);}):y(a,t.tags)||t.tags.push(a);}else if(r==="security"){let{security:a}=s;t.security=a;}else r.startsWith("/")&&(t.paths[r]=f(t.paths[r],s[r]));},T=Y;var z={v2:["paths","definitions","responses","parameters","securityDefinitions"],v3:["paths","definitions","responses","parameters","securityDefinitions","components"],v4:["components","channels"]},J=(t,s)=>t.map(r=>{if((r.tag==="openapi"||r.tag==="swagger"||r.tag==="asyncapi")&&r.description!==""){let e=L__default.default.parseDocument(r.description);if(e.errors.length>0){e.errors.map(i=>{let p=i;return p.annotation=r.description,p});let o="Error parsing YAML in @openapi spec:";throw o+=s?e.errors.map(i=>`${i.toString()}
+var A=(t,s)=>{if(Array.isArray(t))return [...t,...s]},u=A;var w=t=>{t.security&&(t.security=Object.keys(t.security).map(s=>({[s]:t.security[s]})));},k=new Set(["integer","number","string","boolean","object","array"]),g={binary:"string",byte:"string",date:"string","date-time":"string",double:"number",float:"number",int32:"integer",int64:"integer",password:"string"},P=t=>{let s=t.type,r=s.endsWith("[]"),e=s.replace(/\[]$/,""),a=k.has(e),n=Object.keys(g).includes(e),o;if(t.default)switch(e){case"integer":case"int32":case"int64":{o=Number.parseInt(t.default,10);break}case"number":case"double":case"float":{o=Number.parseFloat(t.default);break}default:{o=t.default;break}}let c;a?c={default:o,type:e}:n?c={default:o,format:e,type:g[e]}:c={$ref:`#/components/schemas/${e}`};let p=r?{items:{...c},type:"array"}:{...c};e===""&&(p=void 0);let m=t.description.trim().replace(/^- /u,"");return m===""&&(m=void 0),{description:m,name:t.name,rawType:s,required:!t.optional,schema:p}},$=(t,s)=>t.map(r=>{let e=P(r),a="";switch(e.name&&(a+=e.name),e.description&&(a+=` ${e.description.trim()}`),r.tag){case"operationId":case"summary":case"description":return {[r.tag]:a};case"deprecated":return {deprecated:!0};case"externalDocs":return {externalDocs:{description:e.description,url:e.name}};case"server":return {servers:[{description:e.description,url:e.name}]};case"tag":return {tags:[a]};case"cookieParam":case"headerParam":case"queryParam":case"pathParam":return {parameters:[{description:e.description,in:r.tag.replace(/Param$/u,""),name:e.name,required:e.required,schema:e.schema}]};case"bodyContent":return {requestBody:{content:{[e.name.replace("*\\/*","*/*")]:{schema:e.schema}}}};case"bodyExample":{let[n,o]=e.name.split(".");return {requestBody:{content:{[n]:{examples:{[o]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}case"bodyDescription":return {requestBody:{description:a}};case"bodyRequired":return {requestBody:{required:!0}};case"response":return {responses:{[e.name]:{description:e.description}}};case"callback":return {callbacks:{[e.name]:{$ref:`#/components/callbacks/${e.rawType}`}}};case"responseContent":{let[n,o]=e.name.split(".");return {responses:{[n]:{content:{[o]:{schema:e.schema}}}}}}case"responseHeaderComponent":{let[n,o]=e.name.split(".");return {responses:{[n]:{headers:{[o]:{$ref:`#/components/headers/${e.rawType}`}}}}}}case"responseHeader":{let[n,o]=e.name.split(".");return {responses:{[n]:{headers:{[o]:{description:e.description,schema:e.schema}}}}}}case"responseExample":{let[n,o,c]=e.name.split(".");return {responses:{[n]:{content:{[o]:{examples:{[c]:{$ref:`#/components/examples/${e.rawType}`}}}}}}}}case"responseLink":{let[n,o]=e.name.split(".");return {responses:{[n]:{links:{[o]:{$ref:`#/components/links/${e.rawType}`}}}}}}case"bodyComponent":return {requestBody:{$ref:`#/components/requestBodies/${e.rawType}`}};case"responseComponent":return {responses:{[e.name]:{$ref:`#/components/responses/${e.rawType}`}}};case"paramComponent":return {parameters:[{$ref:`#/components/parameters/${e.rawType}`}]};case"security":{let[n,o]=e.name.split("."),c=[];return o&&(c=[o]),{security:{[n]:c}}}default:return {}}}),C=(t,s)=>{let r=/^(GET|PUT|POST|DELETE|OPTIONS|HEAD|PATCH|TRACE) \/.*$/;return commentParser.parse(t,{spacing:"preserve"}).filter(a=>r.test(a.description.trim())).map(a=>{let n=a.tags.length+1,o=v__default.default({},...$(a.tags),u);w(o);let[c,p]=a.description.split(" "),m={[p.trim()]:{[c.toLowerCase().trim()]:{...o}}},T=JSON.parse(JSON.stringify({paths:m}));return {loc:n,spec:T}})},Z=C;var D=t=>t.split(/\r\n|\r|\n/u).filter(e=>/^\s*(#\s*(?:\S.*)?)?$/u.test(e)?!1:e.trim().length>0).length,h=D;var b=new Set(["openapi","info","servers","security","tags","externalDocs","components","paths"]),d=class extends Error{filePath},I=(t,s,r)=>{let e=fs.readFileSync(t,{encoding:"utf8"}),a=L__default.default.extname(t);if(a===".yaml"||a===".yml"){let n=R__default.default.parse(e),o=Object.keys(n).filter(c=>!b.has(c));if(o.length>0){let c=new d(`Unexpected keys: ${o.join(", ")}`);throw c.filePath=t,c}return Object.keys(n).some(c=>b.has(c))?[{loc:h(e),spec:n}]:[]}try{return s(e,r)}catch(n){throw n.filePath=t,n}},ie=I;var M=(t,s)=>{Object.keys(s).forEach(r=>{t[r]===void 0?t[r]={...s[r]}:Object.keys(s[r]).forEach(e=>{t[r][e]={...t[r][e],...s[r][e]};});});},O=M;var l=class{components;externalDocs;info;openapi;paths;security;servers;tags;constructor(s){this.openapi=s.openapi,this.info=s.info,this.paths=s.paths??{},s.servers&&(this.servers=s.servers),s.components&&(this.components=s.components),s.security&&(this.security=s.security),s.tags&&(this.tags=s.tags),s.externalDocs&&(this.externalDocs=s.externalDocs);}addData(s){s.forEach(r=>{let{components:e,paths:a,...n}=r;O(this,{components:e??{},paths:a??{}}),Object.entries(n).forEach(([o,c])=>{this[o]=c;});});}},fe=l;var f=(t,s)=>v__default.default({},t,s,(r,e)=>e===null?r:void 0),j=t=>Object.keys(t).map(s=>t[s]).every(s=>typeof s=="object"&&Object.keys(s).every(r=>!(r in s))),y=(t,s)=>s.some(r=>t.name===r.name),x=t=>{switch(t.tag){case"openapi":return "v3";case"asyncapi":return "v4";case"swagger":return "v2";default:return "v2"}};var N=(t,s,r)=>{if(r==="x-webhooks"&&(t[r]=s[r]),r.startsWith("x-"))return;if(["components","consumes","produces","paths","schemas","securityDefinitions","responses","parameters","definitions","channels"].includes(r))Object.keys(s[r]).forEach(a=>{t[r][a]=f(t[r][a],s[r][a]);});else if(r==="tags"){let{tags:a}=s;Array.isArray(a)?a.forEach(n=>{y(n,t.tags)||t.tags.push(n);}):y(a,t.tags)||t.tags.push(a);}else if(r==="security"){let{security:a}=s;t.security=a;}else r.startsWith("/")&&(t.paths[r]=f(t.paths[r],s[r]));},E=N;var z={v2:["paths","definitions","responses","parameters","securityDefinitions"],v3:["paths","definitions","responses","parameters","securityDefinitions","components"],v4:["components","channels"]},J=(t,s)=>t.map(r=>{if((r.tag==="openapi"||r.tag==="swagger"||r.tag==="asyncapi")&&r.description!==""){let e=R__default.default.parseDocument(r.description);if(e.errors.length>0){e.errors.map(c=>{let p=c;return p.annotation=r.description,p});let o="Error parsing YAML in @openapi spec:";throw o+=s?e.errors.map(c=>`${c.toString()}
 Imbedded within:
 \`\`\`
-  ${i.annotation?.replace(/\n/gu,`
+  ${c.annotation?.replace(/\n/gu,`
   `)}
 \`\`\``).join(`
-`):e.errors.map(i=>i.toString()).join(`
-`),new Error(o)}let a=e.toJSON(),n={tags:[]};return z[x(r)].forEach(o=>{n[o]=n[o]||{};}),Object.keys(a).forEach(o=>{T(n,a,o);}),n}return {}}),H=(t,s)=>commentParser.parse(t,{spacing:"preserve"}).map(e=>{let a=e.tags.length+1,n=v__default.default({},...J(e.tags,s),u);["definitions","responses","parameters","securityDefinitions","components","tags"].forEach(i=>{n[i]!==void 0&&j(n[i])&&delete n[i];});let o=JSON.parse(JSON.stringify(n));return {loc:a,spec:o}}),Pe=H;var V=async t=>{await U__default.default.validate(t);},qe=V;
+`):e.errors.map(c=>c.toString()).join(`
+`),new Error(o)}let a=e.toJSON(),n={tags:[]};return z[x(r)].forEach(o=>{n[o]=n[o]||{};}),Object.keys(a).forEach(o=>{E(n,a,o);}),n}return {}}),H=(t,s)=>commentParser.parse(t,{spacing:"preserve"}).map(e=>{let a=e.tags.length+1,n=v__default.default({},...J(e.tags,s),u);["definitions","responses","parameters","securityDefinitions","components","tags"].forEach(c=>{n[c]!==void 0&&j(n[c])&&delete n[c];});let o=JSON.parse(JSON.stringify(n));return {loc:a,spec:o}}),Pe=H;var V=async t=>{await U__default.default.validate(t);},qe=V;
 
 exports.a = Z;
-exports.b = b;
-exports.c = ce;
+exports.b = h;
+exports.c = ie;
 exports.d = fe;
 exports.e = Pe;
 exports.f = qe;
 //# sourceMappingURL=out.js.map
-//# sourceMappingURL=chunk-T6JDVCNR.js.map
+//# sourceMappingURL=chunk-RZ5CXKJD.js.map

package/dist/chunk-RZ5CXKJD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/jsdoc/comments-to-open-api.ts","../src/util/customizer.ts","../src/util/yaml-loc.ts","../src/parse-file.ts","../src/util/object-merge.ts","../src/spec-builder.ts","../src/swagger-jsdoc/comments-to-open-api.ts","../src/swagger-jsdoc/utils.ts","../src/swagger-jsdoc/organize-swagger-object.ts","../src/validate.ts"],"names":["parseComments","mergeWith","customizer","objectValue","sourceValue","customizer_default","fixSecurityObject","thing","primitiveTypes","formatMap","parseDescription","tag","rawType","isArray","parsedType","isPrimitive","isFormat","defaultValue","rootType","schema","description","tagsToObjects","tags","verbose","parsedResponse","nameAndDescription","contentType","example","status","header","link","security","scopeItem","scope","commentsToOpenApi","fileContents","openAPIRegex","comment","loc","result","method","path","pathsObject","spec","comments_to_open_api_default","yamlLoc","string","line","yaml_loc_default","readFileSync","yaml","ALLOWED_KEYS","ParseError","parseFile","file","fileContent","extension","invalidKeys","key","error","parse_file_default","objectMerge","a","b","subKey","object_merge_default","SpecBuilder","baseDefinition","parsedFile","components","paths","rest","value","spec_builder_default","mergeDeep","first","second","hasEmptyProperty","object","keyObject","isTagPresentInTags","targetTag","getSwaggerVersionFromSpec","organizeSwaggerObject","swaggerObject","annotation","property","definition","organize_swagger_object_default","specificationTemplate","specs","parsed","newError","errorString","parsedDocument","specification","SwaggerParser","validate","validate_default"],"mappings":"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","sourcesContent":["import type { Spec } from \"comment-parser\";\nimport { parse as parseComments } from \"comment-parser\";\n// eslint-disable-next-line no-restricted-imports\nimport mergeWith from \"lodash.mergewith\";\n\nimport type { OpenApiObject, PathsObject } from \"../exported\";\nimport customizer from \"../util/customizer\";\n\n// The security object has a bizare setup...\nconst fixSecurityObject = (thing: any) => {\n    if (thing.security) {\n        // eslint-disable-next-line no-param-reassign\n        thing.security = Object.keys(thing.security).map((s) => {\n            return {\n                [s]: thing.security[s],\n            };\n        });\n    }\n};\n\nconst primitiveTypes = new Set([\"integer\", \"number\", \"string\", \"boolean\", \"object\", \"array\"]);\n\nconst formatMap: Record<string, string> = {\n    binary: \"string\",\n    byte: \"string\",\n    date: \"string\",\n    \"date-time\": \"string\",\n    double: \"number\",\n    float: \"number\",\n    int32: \"integer\",\n    int64: \"integer\",\n    password: \"string\",\n};\n\nconst parseDescription = (tag: Spec): { description: string | undefined; name: string; rawType: string; required: boolean; schema: object | undefined } => {\n    const rawType = tag.type;\n    const isArray = rawType.endsWith(\"[]\");\n    // eslint-disable-next-line regexp/strict\n    const parsedType = rawType.replace(/\\[]$/, \"\");\n\n    const isPrimitive = primitiveTypes.has(parsedType);\n    const isFormat = Object.keys(formatMap).includes(parsedType);\n\n    let defaultValue;\n\n    if (tag.default) {\n        switch (parsedType) {\n            case \"integer\":\n            case \"int32\":\n            case \"int64\": {\n                defaultValue = Number.parseInt(tag.default, 10);\n                break;\n            }\n            case \"number\":\n            case \"double\":\n            case \"float\": {\n                defaultValue = Number.parseFloat(tag.default);\n                break;\n            }\n            default: {\n                defaultValue = tag.default;\n                break;\n            }\n        }\n    }\n\n    let rootType;\n\n    if (isPrimitive) {\n        rootType = { default: defaultValue, type: parsedType };\n    } else if (isFormat) {\n        rootType = {\n            default: defaultValue,\n            format: parsedType,\n            type: formatMap[parsedType],\n        };\n    } else {\n        rootType = { $ref: `#/components/schemas/${parsedType}` };\n    }\n\n    let schema: object | undefined = isArray\n        ? {\n              items: {\n                  ...rootType,\n              },\n              type: \"array\",\n          }\n        : {\n              ...rootType,\n          };\n\n    if (parsedType === \"\") {\n        schema = undefined;\n    }\n\n    // remove the optional dash from the description.\n    let description: string | undefined = tag.description.trim().replace(/^- /u, \"\");\n\n    if (description === \"\") {\n        description = undefined;\n    }\n\n    return {\n        description,\n        name: tag.name,\n        rawType,\n        required: !tag.optional,\n        schema,\n    };\n};\n\n// @ts-expect-error\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst tagsToObjects = (tags: Spec[], verbose?: boolean) =>\n    tags.map((tag) => {\n        const parsedResponse = parseDescription(tag);\n\n        // Some ops only have a `description`, merge `name` and `description`\n        // for these.\n        let nameAndDescription = \"\";\n\n        if (parsedResponse.name) {\n            nameAndDescription += parsedResponse.name;\n        }\n\n        if (parsedResponse.description) {\n            nameAndDescription += ` ${parsedResponse.description.trim()}`;\n        }\n\n        switch (tag.tag) {\n            case \"operationId\":\n            case \"summary\":\n            case \"description\": {\n                return { [tag.tag]: nameAndDescription };\n            }\n\n            case \"deprecated\": {\n                return { deprecated: true };\n            }\n\n            case \"externalDocs\": {\n                return {\n                    externalDocs: {\n                        description: parsedResponse.description,\n                        url: parsedResponse.name,\n                    },\n                };\n            }\n\n            case \"server\": {\n                return {\n                    servers: [\n                        {\n                            description: parsedResponse.description,\n                            url: parsedResponse.name,\n                        },\n                    ],\n                };\n            }\n\n            case \"tag\": {\n                return { tags: [nameAndDescription] };\n            }\n\n            case \"cookieParam\":\n            case \"headerParam\":\n            case \"queryParam\":\n            case \"pathParam\": {\n                return {\n                    parameters: [\n                        {\n                            description: parsedResponse.description,\n                            in: tag.tag.replace(/Param$/u, \"\"),\n                            name: parsedResponse.name,\n                            required: parsedResponse.required,\n                            schema: parsedResponse.schema,\n                        },\n                    ],\n                };\n            }\n\n            case \"bodyContent\": {\n                return {\n                    requestBody: {\n                        content: {\n                            [parsedResponse.name.replace(\"*\\\\/*\", \"*/*\")]: {\n                                schema: parsedResponse.schema,\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"bodyExample\": {\n                const [contentType, example] = parsedResponse.name.split(\".\");\n\n                return {\n                    requestBody: {\n                        content: {\n                            [contentType as string]: {\n                                examples: {\n                                    [example as string]: {\n                                        $ref: `#/components/examples/${parsedResponse.rawType}`,\n                                    },\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"bodyDescription\": {\n                return { requestBody: { description: nameAndDescription } };\n            }\n\n            case \"bodyRequired\": {\n                return { requestBody: { required: true } };\n            }\n\n            case \"response\": {\n                return {\n                    responses: {\n                        [parsedResponse.name]: {\n                            description: parsedResponse.description,\n                        },\n                    },\n                };\n            }\n\n            case \"callback\": {\n                return {\n                    callbacks: {\n                        [parsedResponse.name]: {\n                            $ref: `#/components/callbacks/${parsedResponse.rawType}`,\n                        },\n                    },\n                };\n            }\n\n            case \"responseContent\": {\n                const [status, contentType] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            content: {\n                                [contentType as string]: {\n                                    schema: parsedResponse.schema,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseHeaderComponent\": {\n                const [status, header] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            headers: {\n                                [header as string]: {\n                                    $ref: `#/components/headers/${parsedResponse.rawType}`,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseHeader\": {\n                const [status, header] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            headers: {\n                                [header as string]: {\n                                    description: parsedResponse.description,\n                                    schema: parsedResponse.schema,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseExample\": {\n                const [status, contentType, example] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            content: {\n                                [contentType as string]: {\n                                    examples: {\n                                        [example as string]: {\n                                            $ref: `#/components/examples/${parsedResponse.rawType}`,\n                                        },\n                                    },\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"responseLink\": {\n                const [status, link] = parsedResponse.name.split(\".\");\n\n                return {\n                    responses: {\n                        [status as string]: {\n                            links: {\n                                [link as string]: {\n                                    $ref: `#/components/links/${parsedResponse.rawType}`,\n                                },\n                            },\n                        },\n                    },\n                };\n            }\n\n            case \"bodyComponent\": {\n                return {\n                    requestBody: {\n                        $ref: `#/components/requestBodies/${parsedResponse.rawType}`,\n                    },\n                };\n            }\n\n            case \"responseComponent\": {\n                return {\n                    responses: {\n                        [parsedResponse.name]: {\n                            $ref: `#/components/responses/${parsedResponse.rawType}`,\n                        },\n                    },\n                };\n            }\n\n            case \"paramComponent\": {\n                return {\n                    parameters: [{ $ref: `#/components/parameters/${parsedResponse.rawType}` }],\n                };\n            }\n\n            case \"security\": {\n                const [security, scopeItem] = parsedResponse.name.split(\".\");\n\n                let scope: string[] = [];\n\n                if (scopeItem) {\n                    scope = [scopeItem];\n                }\n\n                return {\n                    security: { [security as string]: scope },\n                };\n            }\n\n            default: {\n                return {};\n            }\n        }\n    });\n\nconst commentsToOpenApi = (fileContents: string, verbose?: boolean): { loc: number; spec: OpenApiObject }[] => {\n    // eslint-disable-next-line regexp/no-unused-capturing-group\n    const openAPIRegex = /^(GET|PUT|POST|DELETE|OPTIONS|HEAD|PATCH|TRACE) \\/.*$/;\n\n    const jsDocumentComments = parseComments(fileContents, { spacing: \"preserve\" });\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return jsDocumentComments\n        .filter((comment) => openAPIRegex.test(comment.description.trim()))\n        .map((comment) => {\n            // Line count, number of tags + 1 for description.\n            // - Don't count line-breaking due to long descriptions\n            // - Don't count empty lines\n            const loc = comment.tags.length + 1;\n\n            const result = mergeWith({}, ...tagsToObjects(comment.tags, verbose), customizer);\n\n            fixSecurityObject(result);\n\n            const [method, path]: string[] = comment.description.split(\" \");\n\n            const pathsObject: PathsObject = {\n                [(path as string).trim()]: {\n                    [(method as string).toLowerCase().trim()]: {\n                        ...result,\n                    },\n                },\n            };\n\n            // Purge all undefined objects/arrays.\n            const spec = JSON.parse(JSON.stringify({ paths: pathsObject }));\n\n            return {\n                loc,\n                spec,\n            };\n        });\n};\n\nexport default commentsToOpenApi;\n","const customizer = (objectValue: unknown, sourceValue: unknown[]): unknown[] | undefined => {\n    if (Array.isArray(objectValue)) {\n        return [...objectValue, ...sourceValue] as unknown[];\n    }\n\n    return undefined;\n};\n\nexport default customizer;\n","const yamlLoc = (string: string): number => {\n    // Break string into lines.\n    const split = string.split(/\\r\\n|\\r|\\n/u);\n\n    const filtered = split.filter((line) => {\n        // Remove comments.\n        // eslint-disable-next-line security/detect-unsafe-regex,regexp/no-unused-capturing-group\n        if (/^\\s*(#\\s*(?:\\S.*)?)?$/u.test(line)) {\n            return false;\n        }\n        // Remove empty lines.\n        return line.trim().length > 0;\n    });\n\n    return filtered.length;\n};\n\nexport default yamlLoc;\n","import { readFileSync } from \"node:fs\";\nimport path from \"node:path\";\n\nimport yaml from \"yaml\";\n\nimport type { OpenApiObject } from \"./exported\";\nimport yamlLoc from \"./util/yaml-loc\";\n\nconst ALLOWED_KEYS = new Set([\"openapi\", \"info\", \"servers\", \"security\", \"tags\", \"externalDocs\", \"components\", \"paths\"]);\n\nclass ParseError extends Error {\n    public filePath?: string;\n}\n\nconst parseFile = (\n    file: string,\n    commentsToOpenApi: (fileContent: string, verbose?: boolean) => { loc: number; spec: OpenApiObject }[],\n    verbose?: boolean,\n): { loc: number; spec: OpenApiObject }[] => {\n    // eslint-disable-next-line security/detect-non-literal-fs-filename\n    const fileContent = readFileSync(file, { encoding: \"utf8\" });\n    const extension = path.extname(file);\n\n    if (extension === \".yaml\" || extension === \".yml\") {\n        const spec = yaml.parse(fileContent);\n        const invalidKeys = Object.keys(spec).filter((key) => !ALLOWED_KEYS.has(key));\n\n        if (invalidKeys.length > 0) {\n            const error = new ParseError(`Unexpected keys: ${invalidKeys.join(\", \")}`);\n\n            error.filePath = file;\n\n            throw error;\n        }\n\n        if (Object.keys(spec).some((key) => ALLOWED_KEYS.has(key))) {\n            const loc = yamlLoc(fileContent);\n\n            return [{ loc, spec }];\n        }\n\n        return [];\n    }\n\n    try {\n        return commentsToOpenApi(fileContent, verbose);\n    } catch (error: any) {\n        error.filePath = file;\n\n        throw error;\n    }\n};\n\nexport default parseFile;\n","const objectMerge = <T>(a: T, b: T): void => {\n    Object.keys(b as object).forEach((key) => {\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        if (a[key as keyof typeof b] === undefined) {\n            // eslint-disable-next-line no-param-reassign\n            a[key as keyof typeof b] = {\n                ...b[key as keyof typeof b],\n            };\n        } else {\n            Object.keys(b[key as keyof typeof b] as object).forEach((subKey) => {\n                // eslint-disable-next-line no-param-reassign\n                (a[key as keyof typeof b] as Record<string, object>)[subKey] = {\n                    ...(a[key as keyof typeof b] as Record<string, object>)[subKey],\n                    ...(b[key as keyof typeof b] as Record<string, object>)[subKey],\n                };\n            });\n        }\n    });\n};\n\nexport default objectMerge;\n","import type {\n    BaseDefinition,\n    ComponentsObject,\n    ExternalDocumentationObject,\n    InfoObject,\n    OpenApiObject,\n    PathsObject,\n    SecurityRequirementObject,\n    ServerObject,\n    TagObject,\n} from \"./exported\";\nimport objectMerge from \"./util/object-merge\";\n\nclass SpecBuilder implements OpenApiObject {\n    public components?: ComponentsObject;\n\n    public externalDocs?: ExternalDocumentationObject;\n\n    public info: InfoObject;\n\n    public openapi: string;\n\n    public paths: PathsObject;\n\n    public security?: SecurityRequirementObject[];\n\n    public servers?: ServerObject[];\n\n    public tags?: TagObject[];\n\n    public constructor(baseDefinition: BaseDefinition) {\n        this.openapi = baseDefinition.openapi;\n        this.info = baseDefinition.info;\n        this.paths = baseDefinition.paths ?? {};\n\n        if (baseDefinition.servers) {\n            this.servers = baseDefinition.servers;\n        }\n        if (baseDefinition.components) {\n            this.components = baseDefinition.components;\n        }\n\n        if (baseDefinition.security) {\n            this.security = baseDefinition.security;\n        }\n\n        if (baseDefinition.tags) {\n            this.tags = baseDefinition.tags;\n        }\n\n        if (baseDefinition.externalDocs) {\n            this.externalDocs = baseDefinition.externalDocs;\n        }\n    }\n\n    public addData(parsedFile: OpenApiObject[]): void {\n        parsedFile.forEach((file) => {\n            const { components, paths, ...rest } = file;\n\n            // only merge paths and components\n            objectMerge(this, {\n                components: components ?? {},\n                paths: paths ?? {},\n            } as OpenApiObject);\n\n            // overwrite everything else:\n            Object.entries(rest).forEach(([key, value]) => {\n                // @ts-expect-error\n                this[key as keyof OpenApiObject] = value;\n            });\n        });\n    }\n}\n\nexport default SpecBuilder;\n","import type { Spec } from \"comment-parser\";\nimport { parse as parseComments } from \"comment-parser\";\n// eslint-disable-next-line no-restricted-imports\nimport mergeWith from \"lodash.mergewith\";\nimport type { YAMLError } from \"yaml\";\nimport yaml from \"yaml\";\n\nimport type { OpenApiObject } from \"../exported\";\nimport customizer from \"../util/customizer\";\nimport organizeSwaggerObject from \"./organize-swagger-object\";\nimport { getSwaggerVersionFromSpec, hasEmptyProperty } from \"./utils\";\n\nconst specificationTemplate = {\n    v2: [\"paths\", \"definitions\", \"responses\", \"parameters\", \"securityDefinitions\"],\n    v3: [\"paths\", \"definitions\", \"responses\", \"parameters\", \"securityDefinitions\", \"components\"],\n    v4: [\"components\", \"channels\"],\n};\n\n// eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents\ntype ExtendedYAMLError = YAMLError & { annotation?: string };\n\nconst tagsToObjects = (specs: Spec[], verbose?: boolean) =>\n    specs.map((spec: Spec) => {\n        if ((spec.tag === \"openapi\" || spec.tag === \"swagger\" || spec.tag === \"asyncapi\") && spec.description !== \"\") {\n            const parsed = yaml.parseDocument(spec.description);\n\n            if (parsed.errors.length > 0) {\n                parsed.errors.map<ExtendedYAMLError>((error) => {\n                    const newError: ExtendedYAMLError = error;\n\n                    newError.annotation = spec.description;\n\n                    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                    return newError as ExtendedYAMLError;\n                });\n\n                let errorString = \"Error parsing YAML in @openapi spec:\";\n\n                errorString += verbose\n                    ? (parsed.errors as ExtendedYAMLError[])\n\n                          .map((error) => `${error.toString()}\\nImbedded within:\\n\\`\\`\\`\\n  ${error.annotation?.replace(/\\n/gu, \"\\n  \")}\\n\\`\\`\\``)\n                          .join(\"\\n\")\n                    : // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n                      parsed.errors.map((error) => error.toString()).join(\"\\n\");\n\n                throw new Error(errorString);\n            }\n\n            const parsedDocument = parsed.toJSON();\n            const specification: Record<string, any> = {\n                tags: [],\n            };\n\n            specificationTemplate[getSwaggerVersionFromSpec(spec)].forEach((property) => {\n                specification[property] = specification[property] || {};\n            });\n\n            Object.keys(parsedDocument).forEach((property) => {\n                organizeSwaggerObject(specification, parsedDocument, property);\n            });\n\n            return specification;\n        }\n\n        return {};\n    });\n\nconst commentsToOpenApi = (fileContents: string, verbose?: boolean): { loc: number; spec: OpenApiObject }[] => {\n    const jsDocumentComments = parseComments(fileContents, { spacing: \"preserve\" });\n\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n    return jsDocumentComments.map((comment) => {\n        // Line count, number of tags + 1 for description.\n        // - Don't count line-breaking due to long descriptions\n        // - Don't count empty lines\n        const loc = comment.tags.length + 1;\n        const result = mergeWith({}, ...tagsToObjects(comment.tags, verbose), customizer);\n\n        [\"definitions\", \"responses\", \"parameters\", \"securityDefinitions\", \"components\", \"tags\"].forEach((property) => {\n            if (result[property] !== undefined && hasEmptyProperty(result[property])) {\n                // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n                delete result[property];\n            }\n        });\n\n        // Purge all undefined objects/arrays.\n        const spec = JSON.parse(JSON.stringify(result));\n\n        return {\n            loc,\n            spec,\n        };\n    });\n};\n\nexport default commentsToOpenApi;\n","import type { Spec } from \"comment-parser\";\n// eslint-disable-next-line no-restricted-imports\nimport mergeWith from \"lodash.mergewith\";\n\n/**\n * A recursive deep-merge that ignores null values when merging.\n * This returns the merged object and does not mutate.\n * @param {object} first the first object to get merged\n * @param {object} second the second object to get merged\n */\n// eslint-disable-next-line @typescript-eslint/no-unsafe-return\nexport const mergeDeep = (first?: object, second?: object): object => mergeWith({}, first, second, (a, b) => (b === null ? a : undefined));\n\n/**\n * Checks if there is any properties of the input object which are an empty object\n * @param {object} object - the object to check\n * @returns boolean\n */\nexport const hasEmptyProperty = (object: Record<string, any>): boolean =>\n    Object.keys(object)\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-return\n        .map((key) => object[key])\n        .every((keyObject) => typeof keyObject === \"object\" && Object.keys(keyObject).every((key) => !(key in keyObject)));\n\n/**\n * @param {object} tag\n * @param {array} tags\n * @returns boolean\n */\nexport const isTagPresentInTags = (tag: Spec, tags: Spec[]): boolean => tags.some((targetTag) => tag.name === targetTag.name);\n\nexport const getSwaggerVersionFromSpec = (tag: Spec): \"v2\" | \"v3\" | \"v4\" => {\n    switch (tag.tag) {\n        case \"openapi\": {\n            return \"v3\";\n        }\n        case \"asyncapi\": {\n            return \"v4\";\n        }\n        case \"swagger\": {\n            return \"v2\";\n        }\n        default: {\n            return \"v2\";\n        }\n    }\n};\n","import { isTagPresentInTags, mergeDeep } from \"./utils\";\n\n/**\n * @param {object} swaggerObject\n * @param {object} annotation\n * @param {string} property\n */\n\nconst organizeSwaggerObject = (swaggerObject: Record<string, any>, annotation: Record<string, any>, property: string): void => {\n    // Root property on purpose.\n    // eslint-disable-next-line no-secrets/no-secrets\n    // @see https://github.com/OAI/OpenAPI-Specification/blob/master/proposals/002_Webhooks.md#proposed-solution\n    if (property === \"x-webhooks\") {\n        // eslint-disable-next-line no-param-reassign\n        swaggerObject[property] = annotation[property];\n    }\n\n    // Other extensions can be in varying places depending on different vendors and opinions.\n    // The following return makes it so that they are not put in `paths` in the last case.\n    // New specific extensions will need to be handled on case-by-case if to be included in `paths`.\n    if (property.startsWith(\"x-\")) {\n        return;\n    }\n\n    const commonProperties = [\n        \"components\",\n        \"consumes\",\n        \"produces\",\n        \"paths\",\n        \"schemas\",\n        \"securityDefinitions\",\n        \"responses\",\n        \"parameters\",\n        \"definitions\",\n        \"channels\",\n    ];\n\n    if (commonProperties.includes(property)) {\n        Object.keys(annotation[property]).forEach((definition) => {\n            // eslint-disable-next-line no-param-reassign\n            swaggerObject[property][definition] = mergeDeep(swaggerObject[property][definition], annotation[property][definition]);\n        });\n    } else if (property === \"tags\") {\n        const { tags } = annotation;\n\n        if (Array.isArray(tags)) {\n            tags.forEach((tag) => {\n                if (!isTagPresentInTags(tag, swaggerObject[\"tags\"])) {\n                    swaggerObject[\"tags\"].push(tag);\n                }\n            });\n        } else if (!isTagPresentInTags(tags, swaggerObject[\"tags\"])) {\n            swaggerObject[\"tags\"].push(tags);\n        }\n    } else if (property === \"security\") {\n        const { security } = annotation;\n\n        // eslint-disable-next-line no-param-reassign\n        swaggerObject[\"security\"] = security;\n    } else if (property.startsWith(\"/\")) {\n        // Paths which are not defined as \"paths\" property, starting with a slash \"/\"\n        // eslint-disable-next-line no-param-reassign\n        swaggerObject[\"paths\"][property] = mergeDeep(swaggerObject[\"paths\"][property], annotation[property]);\n    }\n};\n\nexport default organizeSwaggerObject;\n","import SwaggerParser from \"@apidevtools/swagger-parser\";\n// eslint-disable-next-line import/no-named-as-default\nimport type OpenAPI from \"openapi-types\";\n\nconst validate = async (spec: Record<string, unknown>): Promise<void> => {\n    await SwaggerParser.validate(spec as OpenAPI.OpenAPI.Document);\n};\n\nexport default validate;\n"]}

package/dist/cli/commander/index.js

@@ -1,10 +1,10 @@
 'use strict';
 
-var chunkQPIZ6QWT_js = require('../../chunk-QPIZ6QWT.js');
-require('../../chunk-T6JDVCNR.js');
+var chunkLJFBEOEV_js = require('../../chunk-LJFBEOEV.js');
+require('../../chunk-RZ5CXKJD.js');
 var process = require('process');
 
-var c=(o,e="generate",t=".openapirc.js")=>{o.command(e).description("Generates OpenAPI (Swagger) documentation from JSDoc's").usage("[options] <path ...>").argument("[path ...]","Paths to files or directories to parse").option("-c, --config [.openapirc.js]","@visulima/jsdoc-open-api config file path.").option("-o, --output [swaggerSpec.json]","Output swagger specification.").option("-v, --verbose","Verbose output.").option("-vv, --very-verbose","Very verbose output.").action(async(r,a)=>{try{await chunkQPIZ6QWT_js.a(t,r,a);}catch(p){console.error(p),process.exit(1);}});},d=c;var u=(o,e="init",t="Inits a pre-configured @visulima/jsdoc-open-api config file.",r=".openapirc.js")=>{o.command(e).description(t).action(()=>{try{chunkQPIZ6QWT_js.b(r);}catch(a){console.error(a),process.exit(1);}});},g=u;
+var c=(o,e="generate",t=".openapirc.js")=>{o.command(e).description("Generates OpenAPI (Swagger) documentation from JSDoc's").usage("[options] <path ...>").argument("[path ...]","Paths to files or directories to parse").option("-c, --config [.openapirc.js]","@visulima/jsdoc-open-api config file path.").option("-o, --output [swaggerSpec.json]","Output swagger specification.").option("-v, --verbose","Verbose output.").option("-vv, --very-verbose","Very verbose output.").action(async(r,a)=>{try{await chunkLJFBEOEV_js.a(t,r,a);}catch(p){console.error(p),process.exit(1);}});},d=c;var u=(o,e="init",t="Inits a pre-configured @visulima/jsdoc-open-api config file.",r=".openapirc.js")=>{o.command(e).description(t).action(()=>{try{chunkLJFBEOEV_js.b(r);}catch(a){console.error(a),process.exit(1);}});},g=u;
 
 exports.generateCommand = d;
 exports.initCommand = g;

package/dist/cli/commander/index.mjs

@@ -1,5 +1,5 @@
-import { a, b } from '../../chunk-LBK736U7.mjs';
-import '../../chunk-RMC27EXI.mjs';
+import { a, b } from '../../chunk-JTAGLC6A.mjs';
+import '../../chunk-5I4AUUK5.mjs';
 import { exit } from 'process';
 
 var d=(o,e="generate",t=".openapirc.js")=>{o.command(e).description("Generates OpenAPI (Swagger) documentation from JSDoc's").usage("[options] <path ...>").argument("[path ...]","Paths to files or directories to parse").option("-c, --config [.openapirc.js]","@visulima/jsdoc-open-api config file path.").option("-o, --output [swaggerSpec.json]","Output swagger specification.").option("-v, --verbose","Verbose output.").option("-vv, --very-verbose","Very verbose output.").action(async(r,a$1)=>{try{await a(t,r,a$1);}catch(s){console.error(s),exit(1);}});},f=d;var g=(o,e="init",t="Inits a pre-configured @visulima/jsdoc-open-api config file.",r=".openapirc.js")=>{o.command(e).description(t).action(()=>{try{b(r);}catch(a){console.error(a),exit(1);}});},l=g;

package/dist/cli/index.js

@@ -1,17 +1,17 @@
 'use strict';
 
-var chunkQPIZ6QWT_js = require('../chunk-QPIZ6QWT.js');
-require('../chunk-T6JDVCNR.js');
+var chunkLJFBEOEV_js = require('../chunk-LJFBEOEV.js');
+require('../chunk-RZ5CXKJD.js');
 
 
 
 Object.defineProperty(exports, 'generateCommand', {
 	enumerable: true,
-	get: function () { return chunkQPIZ6QWT_js.a; }
+	get: function () { return chunkLJFBEOEV_js.a; }
 });
 Object.defineProperty(exports, 'initCommand', {
 	enumerable: true,
-	get: function () { return chunkQPIZ6QWT_js.b; }
+	get: function () { return chunkLJFBEOEV_js.b; }
 });
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map

package/dist/cli/index.mjs

@@ -1,4 +1,4 @@
-export { a as generateCommand, b as initCommand } from '../chunk-LBK736U7.mjs';
-import '../chunk-RMC27EXI.mjs';
+export { a as generateCommand, b as initCommand } from '../chunk-JTAGLC6A.mjs';
+import '../chunk-5I4AUUK5.mjs';
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.mjs.map