@ismael1361/router 1.2.91 → 2.0.0

package/dist/2.0/renderChainDocs.esm.js

@@ -0,0 +1,118 @@
+import { __rest } from '../node_modules/tslib/tslib.es6.esm.js';
+import { joinObject, joinPaths } from './utils.esm.js';
+
+const isOAS3Definition = (obj) => {
+    return obj && typeof obj === "object" && ("openapi" in obj || "swagger" in obj);
+};
+const isTreeDoc = (obj) => {
+    return obj && typeof obj === "object" && "parent" in obj && "children" in obj;
+};
+const isChildrenDoc = (obj) => {
+    return obj && typeof obj === "object" && "operation" in obj && "components" in obj;
+};
+/**
+ * Normaliza os children de um ITreeDoc, que podem ser:
+ * - Um array (vindo de um router)
+ * - Um ITreeDoc único com parent=null (vindo de um handler)
+ *
+ * Desempacota automaticamente wrappers de handler (ITreeDoc com parent=null).
+ */
+const flattenChildren = (children) => {
+    const items = Array.isArray(children) ? children : isTreeDoc(children) ? [children] : [];
+    const result = [];
+    for (const item of items) {
+        if (isTreeDoc(item) && item.parent === null) {
+            result.push(...flattenChildren(item.children));
+        }
+        else {
+            result.push(item);
+        }
+    }
+    return result;
+};
+const renderChainDocs = (docs) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+    let doc = {
+        paths: {},
+        components: {},
+    };
+    for (const d of docs) {
+        if (!isTreeDoc(d))
+            continue;
+        // Parent é SwaggerOptions → mescla configuração global
+        if (isOAS3Definition(d.parent)) {
+            doc = joinObject({}, d.parent, doc);
+            continue;
+        }
+        if (d.path === undefined)
+            continue;
+        const parentDoc = isChildrenDoc(d.parent) ? d.parent : null;
+        const children = flattenChildren(d.children);
+        // Coleta operations, components e stackFrames do parent + todos IChildrenDoc filhos
+        let mergedOperation = parentDoc ? Object.assign({}, parentDoc.operation) : {};
+        let mergedComponents = parentDoc ? Object.assign({}, parentDoc.components) : {};
+        const stackFrames = parentDoc ? [parentDoc.stackFrame] : [];
+        const componentStackFrames = parentDoc && Object.keys((_a = parentDoc.components) !== null && _a !== void 0 ? _a : {}).length > 0 ? [parentDoc.stackFrame] : [];
+        for (const c of children) {
+            if (!isTreeDoc(c) && isChildrenDoc(c)) {
+                mergedOperation = joinObject(mergedOperation, c.operation);
+                mergedComponents = joinObject(mergedComponents, c.components);
+                stackFrames.unshift(c.stackFrame);
+                if (Object.keys((_b = c.components) !== null && _b !== void 0 ? _b : {}).length > 0) {
+                    componentStackFrames.unshift(c.stackFrame);
+                }
+            }
+        }
+        // Mescla components coletados no doc global
+        if (Object.keys(mergedComponents).length > 0) {
+            const existingCompFrames = (_d = (_c = doc.components) === null || _c === void 0 ? void 0 : _c.stackFrames) !== null && _d !== void 0 ? _d : [];
+            doc.components = Object.assign(Object.assign({}, joinObject((_e = doc.components) !== null && _e !== void 0 ? _e : {}, mergedComponents)), { stackFrames: [...componentStackFrames, ...existingCompFrames] });
+        }
+        // Se o nó tem method, é um endpoint → cria entrada em paths
+        if (d.method) {
+            const fullPath = joinPaths(d.path);
+            const existing = (_h = (_g = (_f = doc.paths) === null || _f === void 0 ? void 0 : _f[fullPath]) === null || _g === void 0 ? void 0 : _g[d.method]) !== null && _h !== void 0 ? _h : {};
+            const existingFrames = (_j = existing.stackFrames) !== null && _j !== void 0 ? _j : [];
+            doc.paths = Object.assign(Object.assign({}, doc.paths), { [fullPath]: Object.assign(Object.assign({}, (_k = doc.paths) === null || _k === void 0 ? void 0 : _k[fullPath]), { [d.method]: Object.assign(Object.assign({}, joinObject(existing, mergedOperation)), { stackFrames: [...stackFrames, ...existingFrames] }) }) });
+        }
+        // Processa ITreeDoc filhos (sub-rotas aninhadas)
+        for (const c of children) {
+            if (!isTreeDoc(c))
+                continue;
+            if (isOAS3Definition(c.parent)) {
+                doc = joinObject({}, c.parent, doc);
+                continue;
+            }
+            const childDoc = renderChainDocs([c]);
+            // Mescla propriedades que não são paths (components, tags, etc.)
+            const { paths: childPaths, path: _ } = childDoc, childRest = __rest(childDoc, ["paths", "path"]);
+            doc = joinObject({}, childRest, doc);
+            // Mescla paths com prefixo correto
+            for (const p in childPaths) {
+                const fullPath = joinPaths(d.path || "", p);
+                for (const m in childPaths[p]) {
+                    const childEntry = childPaths[p][m];
+                    const childStackFrames = (_l = childEntry.stackFrames) !== null && _l !== void 0 ? _l : [];
+                    const existing = (_p = (_o = (_m = doc.paths) === null || _m === void 0 ? void 0 : _m[fullPath]) === null || _o === void 0 ? void 0 : _o[m]) !== null && _p !== void 0 ? _p : {};
+                    const existingFrames = (_q = existing.stackFrames) !== null && _q !== void 0 ? _q : [];
+                    doc.paths = Object.assign(Object.assign({}, doc.paths), { [fullPath]: Object.assign(Object.assign({}, (_r = doc.paths) === null || _r === void 0 ? void 0 : _r[fullPath]), { [m]: Object.assign(Object.assign({}, joinObject(existing, mergedOperation, childEntry)), { stackFrames: [...childStackFrames, ...stackFrames, ...existingFrames] }) }) });
+                }
+            }
+        }
+    }
+    // Aplica defaultResponses em cada operação que não definiu responses
+    if (doc.defaultResponses && doc.paths) {
+        for (const path in doc.paths) {
+            for (const method in doc.paths[path]) {
+                const operation = doc.paths[path][method];
+                if (typeof operation === "object" && operation !== null) {
+                    doc.paths[path][method] = Object.assign(Object.assign({}, operation), { responses: joinObject(doc.defaultResponses, (_s = operation.responses) !== null && _s !== void 0 ? _s : {}) });
+                }
+            }
+        }
+    }
+    return doc;
+};
+
+export { renderChainDocs };
+//# sourceMappingURL=renderChainDocs.esm.js.map

package/dist/2.0/renderChainDocs.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderChainDocs.esm.js","sources":["../../src/2.0/renderChainDocs.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/2.0/renderChainDocs.js

@@ -0,0 +1,120 @@
+'use strict';
+
+var tslib_es6 = require('../node_modules/tslib/tslib.es6.js');
+var utils = require('./utils.js');
+
+const isOAS3Definition = (obj) => {
+    return obj && typeof obj === "object" && ("openapi" in obj || "swagger" in obj);
+};
+const isTreeDoc = (obj) => {
+    return obj && typeof obj === "object" && "parent" in obj && "children" in obj;
+};
+const isChildrenDoc = (obj) => {
+    return obj && typeof obj === "object" && "operation" in obj && "components" in obj;
+};
+/**
+ * Normaliza os children de um ITreeDoc, que podem ser:
+ * - Um array (vindo de um router)
+ * - Um ITreeDoc único com parent=null (vindo de um handler)
+ *
+ * Desempacota automaticamente wrappers de handler (ITreeDoc com parent=null).
+ */
+const flattenChildren = (children) => {
+    const items = Array.isArray(children) ? children : isTreeDoc(children) ? [children] : [];
+    const result = [];
+    for (const item of items) {
+        if (isTreeDoc(item) && item.parent === null) {
+            result.push(...flattenChildren(item.children));
+        }
+        else {
+            result.push(item);
+        }
+    }
+    return result;
+};
+const renderChainDocs = (docs) => {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+    let doc = {
+        paths: {},
+        components: {},
+    };
+    for (const d of docs) {
+        if (!isTreeDoc(d))
+            continue;
+        // Parent é SwaggerOptions → mescla configuração global
+        if (isOAS3Definition(d.parent)) {
+            doc = utils.joinObject({}, d.parent, doc);
+            continue;
+        }
+        if (d.path === undefined)
+            continue;
+        const parentDoc = isChildrenDoc(d.parent) ? d.parent : null;
+        const children = flattenChildren(d.children);
+        // Coleta operations, components e stackFrames do parent + todos IChildrenDoc filhos
+        let mergedOperation = parentDoc ? Object.assign({}, parentDoc.operation) : {};
+        let mergedComponents = parentDoc ? Object.assign({}, parentDoc.components) : {};
+        const stackFrames = parentDoc ? [parentDoc.stackFrame] : [];
+        const componentStackFrames = parentDoc && Object.keys((_a = parentDoc.components) !== null && _a !== void 0 ? _a : {}).length > 0 ? [parentDoc.stackFrame] : [];
+        for (const c of children) {
+            if (!isTreeDoc(c) && isChildrenDoc(c)) {
+                mergedOperation = utils.joinObject(mergedOperation, c.operation);
+                mergedComponents = utils.joinObject(mergedComponents, c.components);
+                stackFrames.unshift(c.stackFrame);
+                if (Object.keys((_b = c.components) !== null && _b !== void 0 ? _b : {}).length > 0) {
+                    componentStackFrames.unshift(c.stackFrame);
+                }
+            }
+        }
+        // Mescla components coletados no doc global
+        if (Object.keys(mergedComponents).length > 0) {
+            const existingCompFrames = (_d = (_c = doc.components) === null || _c === void 0 ? void 0 : _c.stackFrames) !== null && _d !== void 0 ? _d : [];
+            doc.components = Object.assign(Object.assign({}, utils.joinObject((_e = doc.components) !== null && _e !== void 0 ? _e : {}, mergedComponents)), { stackFrames: [...componentStackFrames, ...existingCompFrames] });
+        }
+        // Se o nó tem method, é um endpoint → cria entrada em paths
+        if (d.method) {
+            const fullPath = utils.joinPaths(d.path);
+            const existing = (_h = (_g = (_f = doc.paths) === null || _f === void 0 ? void 0 : _f[fullPath]) === null || _g === void 0 ? void 0 : _g[d.method]) !== null && _h !== void 0 ? _h : {};
+            const existingFrames = (_j = existing.stackFrames) !== null && _j !== void 0 ? _j : [];
+            doc.paths = Object.assign(Object.assign({}, doc.paths), { [fullPath]: Object.assign(Object.assign({}, (_k = doc.paths) === null || _k === void 0 ? void 0 : _k[fullPath]), { [d.method]: Object.assign(Object.assign({}, utils.joinObject(existing, mergedOperation)), { stackFrames: [...stackFrames, ...existingFrames] }) }) });
+        }
+        // Processa ITreeDoc filhos (sub-rotas aninhadas)
+        for (const c of children) {
+            if (!isTreeDoc(c))
+                continue;
+            if (isOAS3Definition(c.parent)) {
+                doc = utils.joinObject({}, c.parent, doc);
+                continue;
+            }
+            const childDoc = renderChainDocs([c]);
+            // Mescla propriedades que não são paths (components, tags, etc.)
+            const { paths: childPaths, path: _ } = childDoc, childRest = tslib_es6.__rest(childDoc, ["paths", "path"]);
+            doc = utils.joinObject({}, childRest, doc);
+            // Mescla paths com prefixo correto
+            for (const p in childPaths) {
+                const fullPath = utils.joinPaths(d.path || "", p);
+                for (const m in childPaths[p]) {
+                    const childEntry = childPaths[p][m];
+                    const childStackFrames = (_l = childEntry.stackFrames) !== null && _l !== void 0 ? _l : [];
+                    const existing = (_p = (_o = (_m = doc.paths) === null || _m === void 0 ? void 0 : _m[fullPath]) === null || _o === void 0 ? void 0 : _o[m]) !== null && _p !== void 0 ? _p : {};
+                    const existingFrames = (_q = existing.stackFrames) !== null && _q !== void 0 ? _q : [];
+                    doc.paths = Object.assign(Object.assign({}, doc.paths), { [fullPath]: Object.assign(Object.assign({}, (_r = doc.paths) === null || _r === void 0 ? void 0 : _r[fullPath]), { [m]: Object.assign(Object.assign({}, utils.joinObject(existing, mergedOperation, childEntry)), { stackFrames: [...childStackFrames, ...stackFrames, ...existingFrames] }) }) });
+                }
+            }
+        }
+    }
+    // Aplica defaultResponses em cada operação que não definiu responses
+    if (doc.defaultResponses && doc.paths) {
+        for (const path in doc.paths) {
+            for (const method in doc.paths[path]) {
+                const operation = doc.paths[path][method];
+                if (typeof operation === "object" && operation !== null) {
+                    doc.paths[path][method] = Object.assign(Object.assign({}, operation), { responses: utils.joinObject(doc.defaultResponses, (_s = operation.responses) !== null && _s !== void 0 ? _s : {}) });
+                }
+            }
+        }
+    }
+    return doc;
+};
+
+exports.renderChainDocs = renderChainDocs;
+//# sourceMappingURL=renderChainDocs.js.map

package/dist/2.0/renderChainDocs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderChainDocs.js","sources":["../../src/2.0/renderChainDocs.ts"],"sourcesContent":[null],"names":["joinObject","joinPaths","__rest"],"mappings":";;;;;AAGA,MAAM,gBAAgB,GAAG,CAAC,GAAQ,KAA2B;AAC5D,IAAA,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,KAAK,SAAS,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,CAAC,GAAQ,KAAqB;AAC/C,IAAA,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,IAAI,UAAU,IAAI,GAAG,CAAC;AAC/E,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,GAAQ,KAAyB;AACvD,IAAA,OAAO,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,WAAW,IAAI,GAAG,IAAI,YAAY,IAAI,GAAG,CAAC;AACpF,CAAC,CAAC;AAEF;;;;;;AAMG;AACH,MAAM,eAAe,GAAG,CAAC,QAAa,KAAiC;AACtE,IAAA,MAAM,KAAK,GAAU,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;IAChG,MAAM,MAAM,GAAgC,EAAE,CAAC;AAE/C,IAAA,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE;QACzB,IAAI,SAAS,CAAC,IAAI,CAAC,IAAK,IAAiB,CAAC,MAAM,KAAK,IAAI,EAAE;YAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAE,IAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC;SAC7D;aAAM;AACN,YAAA,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SAClB;KACD;AAED,IAAA,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEW,MAAA,eAAe,GAAG,CAAC,IAAgB,KAA6B;;AAC5E,IAAA,IAAI,GAAG,GAA4B;AAClC,QAAA,KAAK,EAAE,EAAE;AACT,QAAA,UAAU,EAAE,EAAE;KACd,CAAC;AAEF,IAAA,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE;AACrB,QAAA,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;YAAE,SAAS;;AAG5B,QAAA,IAAI,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE;YAC/B,GAAG,GAAGA,gBAAU,CAA0B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAC7D,SAAS;SACT;AAED,QAAA,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,SAAS;AAEnC,QAAA,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,GAAI,CAAC,CAAC,MAAqB,GAAG,IAAI,CAAC;QAC5E,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;;AAG7C,QAAA,IAAI,eAAe,GAAwB,SAAS,GAAE,MAAA,CAAA,MAAA,CAAA,EAAA,EAAM,SAAS,CAAC,SAAS,CAAA,GAAK,EAAE,CAAC;AACvF,QAAA,IAAI,gBAAgB,GAAwB,SAAS,GAAE,MAAA,CAAA,MAAA,CAAA,EAAA,EAAM,SAAS,CAAC,UAAU,CAAA,GAAK,EAAE,CAAC;AACzF,QAAA,MAAM,WAAW,GAAkB,SAAS,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;AAC3E,QAAA,MAAM,oBAAoB,GAAkB,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,CAAA,EAAA,GAAA,SAAS,CAAC,UAAU,mCAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;AAE1I,QAAA,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE;YACzB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,EAAE;gBACtC,eAAe,GAAGA,gBAAU,CAAC,eAAe,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;gBAC3D,gBAAgB,GAAGA,gBAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC;AAC9D,gBAAA,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAClC,gBAAA,IAAI,MAAM,CAAC,IAAI,CAAC,CAAA,EAAA,GAAA,CAAC,CAAC,UAAU,MAAI,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAA,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;AAC/C,oBAAA,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;iBAC3C;aACD;SACD;;QAGD,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE;YAC7C,MAAM,kBAAkB,GAAkB,CAAA,EAAA,GAAA,CAAC,EAAA,GAAA,GAAG,CAAC,UAAkB,MAAE,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,WAAW,MAAI,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAA,EAAE,CAAC;YACrF,GAAG,CAAC,UAAU,GAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EACVA,gBAAU,CAAC,MAAA,GAAG,CAAC,UAAU,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAI,EAAE,EAAE,gBAAgB,CAAC,CAAA,EAAA,EACrD,WAAW,EAAE,CAAC,GAAG,oBAAoB,EAAE,GAAG,kBAAkB,CAAC,EAAA,CAC7D,CAAC;SACF;;AAGD,QAAA,IAAI,CAAC,CAAC,MAAM,EAAE;YACb,MAAM,QAAQ,GAAGC,eAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,YAAA,MAAM,QAAQ,GAAG,CAAA,EAAA,GAAA,MAAA,CAAA,EAAA,GAAA,GAAG,CAAC,KAAK,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAG,QAAQ,CAAC,0CAAG,CAAC,CAAC,MAAM,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAI,EAAE,CAAC;YACzD,MAAM,cAAc,GAAkB,CAAA,EAAA,GAAA,QAAQ,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAI,EAAE,CAAC;AACjE,YAAA,GAAG,CAAC,KAAK,GAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EACL,GAAG,CAAC,KAAK,KACZ,CAAC,QAAQ,GACL,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,CAAA,EAAA,GAAA,GAAG,CAAC,KAAK,0CAAG,QAAQ,CAAC,KACxB,CAAC,CAAC,CAAC,MAAM,GACL,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAAD,gBAAU,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAA,EAAA,EACxC,WAAW,EAAE,CAAC,GAAG,WAAW,EAAE,GAAG,cAAc,CAAC,SAGlD,CAAC;SACF;;AAGD,QAAA,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE;AACzB,YAAA,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;gBAAE,SAAS;AAE5B,YAAA,IAAI,gBAAgB,CAAE,CAAc,CAAC,MAAM,CAAC,EAAE;gBAC7C,GAAG,GAAGA,gBAAU,CAA0B,EAAE,EAAG,CAAc,CAAC,MAAwB,EAAE,GAAG,CAAC,CAAC;gBAC7F,SAAS;aACT;YAED,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAa,CAAC,CAAC,CAAC;;AAGlD,YAAA,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,EAAmB,GAAA,QAAQ,EAAtB,SAAS,GAAAE,gBAAA,CAAK,QAAQ,EAAvD,CAAA,OAAA,EAAA,MAAA,CAA4C,CAAW,CAAC;YAC9D,GAAG,GAAGF,gBAAU,CAA0B,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;;AAG9D,YAAA,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE;AAC3B,gBAAA,MAAM,QAAQ,GAAGC,eAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;gBAE5C,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE;oBAC9B,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACpC,MAAM,gBAAgB,GAAkB,CAAA,EAAA,GAAA,UAAU,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAI,EAAE,CAAC;AACrE,oBAAA,MAAM,QAAQ,GAAG,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,GAAG,CAAC,KAAK,MAAG,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,QAAQ,CAAC,MAAG,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAA,CAAC,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAI,EAAE,CAAC;oBAClD,MAAM,cAAc,GAAkB,CAAA,EAAA,GAAA,QAAQ,CAAC,WAAW,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAI,EAAE,CAAC;oBACjE,GAAG,CAAC,KAAK,GACL,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EAAA,GAAG,CAAC,KAAK,CAAA,EAAA,EACZ,CAAC,QAAQ,mCACL,CAAA,EAAA,GAAA,GAAG,CAAC,KAAK,MAAA,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAA,EAAA,CAAG,QAAQ,CAAC,CAAA,EAAA,EACxB,CAAC,CAAC,mCACED,gBAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,CAAC,KACpD,WAAW,EAAE,CAAC,GAAG,gBAAgB,EAAE,GAAG,WAAW,EAAE,GAAG,cAAc,CAAC,EAAA,CAAA,EAAA,CAAA,EAAA,CAGvE,CAAC;iBACF;aACD;SACD;KACD;;IAGD,IAAI,GAAG,CAAC,gBAAgB,IAAI,GAAG,CAAC,KAAK,EAAE;AACtC,QAAA,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE;YAC7B,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;gBACrC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;gBAC1C,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI,EAAE;oBACxD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,MAAA,CAAA,EAAA,EACnB,SAAS,CAAA,EAAA,EACZ,SAAS,EAAEA,gBAAU,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA,EAAA,GAAA,SAAS,CAAC,SAAS,MAAI,IAAA,IAAA,EAAA,KAAA,KAAA,CAAA,GAAA,EAAA,GAAA,EAAE,CAAC,EAAA,CACtE,CAAC;iBACF;aACD;SACD;KACD;AAED,IAAA,OAAO,GAAG,CAAC;AACZ;;;;"}

package/dist/2.0/router.d.ts

@@ -0,0 +1,73 @@
+import type { IRouter } from "./type";
+/**
+ * Cria uma instância de {@link IRouter} com suporte a métodos HTTP tipados,
+ * sub-rotas aninhadas e geração automática de documentação OpenAPI/Swagger.
+ *
+ * O router pode ser usado de forma independente e depois montado em uma aplicação
+ * ou em outro router via `.route()` ou `.use()`, permitindo modularizar a API.
+ *
+ * @returns Instância de {@link IRouter} com todos os métodos HTTP e configuração Swagger.
+ *
+ * @example
+ * // Router básico com rotas
+ * import { router } from '@ismael1361/router';
+ *
+ * const api = router();
+ *
+ * api.get("/items")
+ *   .handler((req, res) => {
+ *     res.json([{ id: 1, name: "Item A" }]);
+ *   })
+ *   .doc({ tags: ["Items"], summary: "Listar itens" });
+ *
+ * api.post("/items")
+ *   .handler((req, res) => {
+ *     res.status(201).json({ id: 2, name: "Novo item" });
+ *   })
+ *   .doc({ tags: ["Items"], summary: "Criar item" });
+ *
+ * @example
+ * // Montar router em uma aplicação com prefixo
+ * import { create, router } from '@ismael1361/router';
+ *
+ * const app = create();
+ * const v1 = router();
+ *
+ * v1.get("/test/route")
+ *   .handler((req, res) => {
+ *     res.send("Hello from v1!");
+ *   })
+ *   .doc({ tags: ["V1"], summary: "Rota de teste v1" });
+ *
+ * app.route("/v1", v1, {
+ *   security: [{ bearerAuth: [] }],
+ *   responses: {
+ *     "400": { description: "Dados inválidos" },
+ *     "404": { description: "Não encontrado" },
+ *   },
+ * });
+ *
+ * @example
+ * // Router com Swagger habilitado
+ * const api = router();
+ *
+ * api.get("/users/:id")
+ *   .handler((req, res) => {
+ *     res.json({ id: req.params.id, name: "Alice" });
+ *   })
+ *   .doc({
+ *     tags: ["Users"],
+ *     summary: "Buscar usuário por ID",
+ *     parameters: [
+ *       { name: "id", in: "path", required: true, schema: { type: "string" } },
+ *     ],
+ *   });
+ *
+ * api.defineSwagger({
+ *   openapi: "3.0.0",
+ *   info: { title: "Users API", version: "1.0.0" },
+ *   path: "/doc",
+ * });
+ */
+export declare const router: () => IRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/2.0/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/2.0/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA0B,OAAO,EAAkH,MAAM,QAAQ,CAAC;AAa9K;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,eAAO,MAAM,MAAM,QAAO,OA4RzB,CAAC"}

package/dist/2.0/router.esm.js

@@ -0,0 +1,302 @@
+import { __rest } from '../node_modules/tslib/tslib.es6.esm.js';
+import express from 'express';
+import { METHODS } from 'http';
+import { handler } from './handler.esm.js';
+import { joinPaths, isRouter, parseStack, rootStack, joinObject, omit, targetLabels } from './utils.esm.js';
+import path from 'path';
+import { renderChainDocs } from './renderChainDocs.esm.js';
+import swaggerJSDoc from 'swagger-jsdoc';
+import OpenAPISnippet from 'openapi-snippet';
+import { analyzeSwaggerJSONDoc, OpenAPIError } from './analyzeSwagger.esm.js';
+import swaggerUi from 'swagger-ui-express';
+import swaggerMarkdown from './swagger-markdown/index.esm.js';
+import { setup } from './redocUi/index.esm.js';
+import { uuidv4 } from '@ismael1361/utils';
+
+/**
+ * Cria uma instância de {@link IRouter} com suporte a métodos HTTP tipados,
+ * sub-rotas aninhadas e geração automática de documentação OpenAPI/Swagger.
+ *
+ * O router pode ser usado de forma independente e depois montado em uma aplicação
+ * ou em outro router via `.route()` ou `.use()`, permitindo modularizar a API.
+ *
+ * @returns Instância de {@link IRouter} com todos os métodos HTTP e configuração Swagger.
+ *
+ * @example
+ * // Router básico com rotas
+ * import { router } from '@ismael1361/router';
+ *
+ * const api = router();
+ *
+ * api.get("/items")
+ *   .handler((req, res) => {
+ *     res.json([{ id: 1, name: "Item A" }]);
+ *   })
+ *   .doc({ tags: ["Items"], summary: "Listar itens" });
+ *
+ * api.post("/items")
+ *   .handler((req, res) => {
+ *     res.status(201).json({ id: 2, name: "Novo item" });
+ *   })
+ *   .doc({ tags: ["Items"], summary: "Criar item" });
+ *
+ * @example
+ * // Montar router em uma aplicação com prefixo
+ * import { create, router } from '@ismael1361/router';
+ *
+ * const app = create();
+ * const v1 = router();
+ *
+ * v1.get("/test/route")
+ *   .handler((req, res) => {
+ *     res.send("Hello from v1!");
+ *   })
+ *   .doc({ tags: ["V1"], summary: "Rota de teste v1" });
+ *
+ * app.route("/v1", v1, {
+ *   security: [{ bearerAuth: [] }],
+ *   responses: {
+ *     "400": { description: "Dados inválidos" },
+ *     "404": { description: "Não encontrado" },
+ *   },
+ * });
+ *
+ * @example
+ * // Router com Swagger habilitado
+ * const api = router();
+ *
+ * api.get("/users/:id")
+ *   .handler((req, res) => {
+ *     res.json({ id: req.params.id, name: "Alice" });
+ *   })
+ *   .doc({
+ *     tags: ["Users"],
+ *     summary: "Buscar usuário por ID",
+ *     parameters: [
+ *       { name: "id", in: "path", required: true, schema: { type: "string" } },
+ *     ],
+ *   });
+ *
+ * api.defineSwagger({
+ *   openapi: "3.0.0",
+ *   info: { title: "Users API", version: "1.0.0" },
+ *   path: "/doc",
+ * });
+ */
+const router = () => {
+    const innerRouter = express.Router();
+    innerRouter.get("/.well-known/appspecific/com.chrome.devtools.json", (req, res) => {
+        const workspaceUuid = uuidv4("-"); // Gera um UUID v4
+        res.json({
+            workspace: {
+                root: "",
+                uuid: workspaceUuid,
+            },
+        });
+    });
+    let innerSwaggerOptions = null;
+    const routesDocs = [
+        () => {
+            return innerSwaggerOptions
+                ? {
+                    parent: innerSwaggerOptions,
+                    children: [],
+                }
+                : null;
+        },
+    ];
+    const defineRouteDoc = (method, path$1, doc, children) => {
+        const stack = parseStack().filter(({ dir }) => !path.resolve(dir).startsWith(path.resolve(rootStack[0].dir)))[0];
+        routesDocs.push(() => {
+            const _a = doc || {}, { components = {} } = _a, operation = __rest(_a, ["components"]);
+            return {
+                method,
+                path: path$1,
+                parent: {
+                    stackFrame: stack,
+                    operation,
+                    components,
+                },
+                children: (children ? children.__chain_docs__ : []) || [],
+            };
+        });
+    };
+    // Criamos o objeto com os seus métodos customizados
+    const customMethods = {
+        __router_path__: "/",
+        get path() {
+            var _a;
+            return joinPaths(((_a = this.parent) === null || _a === void 0 ? void 0 : _a.path) || "/", this.__router_path__);
+        },
+        param(name, handler) {
+            innerRouter.param(name, handler);
+            return this;
+        },
+        get __chain_docs__() {
+            return routesDocs.map((getDoc) => getDoc()).filter((doc) => doc !== null && doc !== undefined);
+        },
+        route() {
+            const args = Array.from(arguments);
+            const path = typeof args[0] === "string" ? args[0] : "/";
+            const route = typeof args[0] === "string" ? (typeof args[1] === "function" ? args[1] : router()) : typeof args[0] === "function" ? args[0] : router();
+            if (!isRouter(route)) {
+                throw new Error("Invalid router instance");
+            }
+            route.__router_path__ = path;
+            route.parent = this;
+            const doc = typeof args[args.length - 1] === "object" && typeof args[args.length - 1] !== "function" ? args[args.length - 1] : undefined;
+            innerRouter.use(path, route);
+            defineRouteDoc(undefined, path, doc, route);
+            return route;
+        },
+        use() {
+            const args = Array.from(arguments);
+            const path = typeof args[0] === "string" || args[0] instanceof RegExp || Array.isArray(args[0]) ? args[0] : undefined;
+            const handler = path ? (typeof args[1] === "function" ? args[1] : undefined) : typeof args[0] === "function" ? args[0] : undefined;
+            const doc = typeof args[args.length - 1] === "object" && typeof args[args.length - 1] !== "function" ? args[args.length - 1] : undefined;
+            const route = router();
+            route.__router_path__ = path || "/";
+            route.parent = this;
+            if (handler && isRouter(handler)) {
+                route.__router_path__ = path || "/";
+                handler.parent = this;
+            }
+            if (path) {
+                if (handler) {
+                    innerRouter.use(path, handler);
+                }
+                else {
+                    innerRouter.use(path, route);
+                }
+            }
+            else if (handler) {
+                innerRouter.use(handler);
+            }
+            defineRouteDoc(undefined, "/", doc);
+            return handler ? undefined : route;
+        },
+        defineSwagger(options) {
+            innerSwaggerOptions = options;
+            innerSwaggerOptions.stackFrames = [parseStack().filter(({ dir }) => !path.resolve(dir).startsWith(path.resolve(rootStack[0].dir)))[0]];
+            const getSwaggerMarkdown = () => {
+                return swaggerMarkdown.convert(this.getSwagger());
+            };
+            const getSwaggerOptions = () => {
+                const { options } = this.getSwagger();
+                return options;
+            };
+            const getSwaggerDefinition = () => {
+                return swaggerJSDoc(this.getSwagger());
+            };
+            innerRouter.use("/doc/.md", (res, req) => {
+                req.setHeader("Content-Type", "text/markdown");
+                req.send(getSwaggerMarkdown());
+            });
+            innerRouter.use("/doc/markdown", (...args) => {
+                swaggerMarkdown.setup(getSwaggerOptions()).apply(this.app, args);
+            });
+            innerRouter.get("/doc/swagger/definition.json", (req, res) => {
+                res.json(getSwaggerDefinition());
+            });
+            innerRouter.use("/doc/swagger", swaggerUi.serve, (...args) => {
+                swaggerUi.setup(getSwaggerDefinition()).apply(this.app, args);
+            });
+            innerRouter.use("/doc/redoc", (...args) => {
+                setup(getSwaggerOptions()).apply(this.app, args);
+            });
+            return {
+                markdownPath: joinPaths(this.path, "/doc/.md"),
+                definitionPath: joinPaths(this.path, "/doc/swagger/definition.json"),
+                swaggerUiPath: joinPaths(this.path, "/doc/swagger"),
+                redocUiPath: joinPaths(this.path, "/doc/redoc"),
+            };
+        },
+        getSwagger() {
+            var _a;
+            if (!innerSwaggerOptions) {
+                throw new Error("Swagger options not defined. Please set the swagger options using the defineSwagger method.");
+            }
+            const swaggerOptions = Object.assign(Object.assign({}, innerSwaggerOptions), { path: innerSwaggerOptions.path || "/doc", defaultResponses: innerSwaggerOptions.defaultResponses || {} });
+            let doc = { paths: (swaggerOptions === null || swaggerOptions === void 0 ? void 0 : swaggerOptions.paths) || {}, components: (swaggerOptions === null || swaggerOptions === void 0 ? void 0 : swaggerOptions.components) || {} };
+            doc = joinObject(doc, renderChainDocs(this.__chain_docs__));
+            const definition = Object.assign(Object.assign({}, omit(swaggerOptions, "path", "defaultResponses")), omit(doc, "path", "defaultResponses"));
+            // Valida o documento OAS antes de gerar os snippets
+            const analysisErrors = analyzeSwaggerJSONDoc(definition);
+            if (analysisErrors.length > 0) {
+                throw analysisErrors[0];
+            }
+            const targets = innerSwaggerOptions.targets || [
+                "c_libcurl",
+                "csharp_restsharp",
+                "go_native",
+                "java_unirest",
+                "javascript_xhr",
+                "node_native",
+                "objc_nsurlsession",
+                "ocaml_cohttp",
+                "php_curl",
+                "python_python3",
+                "ruby_native",
+                "shell_curl",
+                "swift_nsurlsession",
+            ];
+            for (const path in definition.paths) {
+                for (const method in definition.paths[path]) {
+                    try {
+                        const generatedCode = OpenAPISnippet.getEndpointSnippets(Object.assign({ servers: [
+                                {
+                                    url: "http://[hostname]",
+                                },
+                            ] }, definition), path, method, targets);
+                        definition.paths[path][method]["x-codeSamples"] = [];
+                        for (const snippetIdx in generatedCode.snippets) {
+                            const snippet = generatedCode.snippets[snippetIdx];
+                            definition.paths[path][method]["x-codeSamples"][snippetIdx] = { lang: targetLabels[snippet.id], label: snippet.title, source: snippet.content };
+                        }
+                        if ("stackFrames" in definition.paths[path][method]) {
+                            delete definition.paths[path][method].stackFrames;
+                        }
+                    }
+                    catch (e) {
+                        throw new OpenAPIError(`Sintax error in the OpenAPI definition for ${method.toUpperCase()} ${path}: ${e.message}`, (_a = definition.paths[path][method]) === null || _a === void 0 ? void 0 : _a.stackFrames);
+                    }
+                }
+            }
+            if (definition.components && "stackFrames" in definition.components) {
+                delete definition.components.stackFrames;
+            }
+            if ("defaultResponses" in definition) {
+                delete definition.defaultResponses;
+            }
+            if ("stackFrames" in definition) {
+                delete definition.stackFrames;
+            }
+            return {
+                definition,
+                apis: [],
+            };
+        },
+    };
+    METHODS.concat("all")
+        .map((m) => m.toLowerCase())
+        .forEach((method) => {
+        customMethods[method] = function (path, doc) {
+            const rootHandler = handler((req, res, next) => {
+                next();
+            });
+            innerRouter[method].apply(innerRouter, [path, rootHandler]);
+            defineRouteDoc(method, path, doc, rootHandler);
+            const props = {};
+            return Object.assign(rootHandler, props);
+        };
+    });
+    const routerHandler = function (req, res, next) {
+        return innerRouter(req, res, next);
+    };
+    // Mesclamos o innerRouter (que já é uma função) com os métodos
+    // Usamos o 'as any' seguido do 'as CustomRouter' para convencer o TS
+    return Object.setPrototypeOf(routerHandler, customMethods);
+};
+
+export { router };
+//# sourceMappingURL=router.esm.js.map