zudoku 0.0.0-eff6f9b → 0.0.0-f06d326

package/dist/lib/plugins/openapi/post-processors/removeExtensions.test.js

@@ -0,0 +1,174 @@
+import { describe, expect, it } from "vitest";
+import { removeExtensions } from "./removeExtensions.js";
+const baseDoc = {
+    openapi: "3.1.0",
+    "x-root-ext": "remove me",
+    "x-zuplo-ext": "remove me too",
+    info: {
+        title: "Test API",
+        version: "1.0.0",
+        "x-info-ext": "remove me",
+        "x-zuplo-info": "remove me too",
+    },
+    paths: {
+        "/test": {
+            "x-path-ext": "remove me",
+            "x-zuplo-path": "remove me too",
+            parameters: [
+                {
+                    name: "param1",
+                    in: "query",
+                    schema: { type: "string" },
+                    "x-param-ext": "remove me",
+                    "x-zuplo-param": "remove me too",
+                },
+            ],
+            get: {
+                "x-operation-ext": "remove me",
+                "x-zuplo-route": "remove me too",
+                responses: {
+                    "200": {
+                        description: "OK",
+                        "x-response-ext": "remove me",
+                        "x-zuplo-response": "remove me too",
+                    },
+                },
+                parameters: [
+                    {
+                        name: "opParam1",
+                        in: "header",
+                        schema: { type: "string" },
+                        "x-op-param-ext": "remove me",
+                        "x-zuplo-param": "remove me too",
+                    },
+                ],
+            },
+        },
+    },
+    tags: [
+        {
+            name: "example",
+            "x-tag-ext": "remove me",
+            "x-zuplo-tag": "remove me too",
+        },
+    ],
+    components: {
+        securitySchemes: {
+            ApiKeyAuth: {
+                type: "apiKey",
+                name: "api_key",
+                in: "header",
+                "x-security-ext": "remove me",
+                "x-zuplo-security": "remove me too",
+            },
+        },
+    },
+};
+describe("removeExtensions", () => {
+    it("removes all x- extensions by default", () => {
+        const processed = removeExtensions()(baseDoc);
+        const removedExtensions = [
+            "x-root-ext",
+            "info.x-info-ext",
+            "paths./test.x-path-ext",
+            "paths./test.parameters[0].x-param-ext",
+            "paths./test.get.x-operation-ext",
+            "paths./test.get.responses.200.x-response-ext",
+            "paths./test.get.parameters[0].x-op-param-ext",
+            "tags[0].x-tag-ext",
+            "components.securitySchemes.ApiKeyAuth.x-security-ext",
+        ];
+        removedExtensions.forEach((ext) => {
+            expect(processed).not.toHaveProperty(ext.split("."));
+        });
+        // Assert that non-x- fields remain unchanged
+        expect(processed.openapi).toBe("3.1.0");
+        expect(processed.info.title).toBe("Test API");
+        expect(processed).toHaveProperty(["paths", "/test", "get", "responses", "200", "description"], "OK");
+        expect(processed.tags[0].name).toBe("example");
+    });
+    it("removes only specified x- extensions when names are provided", () => {
+        const docWithExtraExtensions = {
+            ...baseDoc,
+            info: { ...baseDoc.info, "x-other-ext": "keep me" },
+        };
+        const processed = removeExtensions({
+            keys: ["x-path-ext", "x-param-ext"],
+        })(docWithExtraExtensions);
+        // Assert specified extensions are removed
+        expect(processed.paths["/test"]["x-path-ext"]).toBeUndefined();
+        expect(processed.paths["/test"].parameters[0]["x-param-ext"]).toBeUndefined();
+        // Assert other x- fields remain
+        expect(processed["x-root-ext"]).toBe("remove me");
+        expect(processed.info["x-info-ext"]).toBe("remove me");
+        expect(processed.info["x-other-ext"]).toBe("keep me");
+    });
+    it("handles deeply nested extensions", () => {
+        const deeplyNested = {
+            a: {
+                b: {
+                    c: {
+                        "x-deep-ext": "remove me",
+                        d: {
+                            e: "value",
+                            "x-another-ext": "remove me",
+                        },
+                    },
+                },
+            },
+        };
+        const processed = removeExtensions()(deeplyNested);
+        expect(processed.a.b.c["x-deep-ext"]).toBeUndefined();
+        expect(processed.a.b.c.d["x-another-ext"]).toBeUndefined();
+        expect(processed.a.b.c.d.e).toBe("value");
+    });
+    it("does nothing if no x- extensions are present", () => {
+        const docWithoutExtensions = {
+            openapi: "3.1.0",
+            info: { title: "API without extensions" },
+        };
+        const processed = removeExtensions()(docWithoutExtensions);
+        expect(processed).toEqual(docWithoutExtensions);
+    });
+    it("removes extensions based on shouldRemove callback", () => {
+        const processed = removeExtensions({
+            shouldRemove: (key) => key.startsWith("x-zuplo"),
+        })(baseDoc);
+        // Should remove x-zuplo extensions
+        const removedExtensions = [
+            "x-zuplo-ext",
+            "info.x-zuplo-info",
+            "paths./test.x-zuplo-path",
+            "paths./test.parameters.0.x-zuplo-param",
+            "paths./test.get.x-zuplo-route",
+            "paths./test.get.responses.200.x-zuplo-response",
+            "paths./test.get.parameters.0.x-zuplo-param",
+            "tags.0.x-zuplo-tag",
+            "components.securitySchemes.ApiKeyAuth.x-zuplo-security",
+        ];
+        // Should keep other x- extensions
+        const keptExtensions = [
+            "x-root-ext",
+            "info.x-info-ext",
+            "paths./test.x-path-ext",
+            "paths./test.parameters.0.x-param-ext",
+            "paths./test.get.x-operation-ext",
+            "paths./test.get.responses.200.x-response-ext",
+            "paths./test.get.parameters.0.x-op-param-ext",
+            "tags.0.x-tag-ext",
+            "components.securitySchemes.ApiKeyAuth.x-security-ext",
+        ];
+        removedExtensions.forEach((ext) => {
+            expect(processed).not.toHaveProperty(ext.split("."));
+        });
+        keptExtensions.forEach((ext) => {
+            expect(processed).toHaveProperty(ext.split("."));
+        });
+        // Assert that non-x- fields remain unchanged
+        expect(processed).toHaveProperty("openapi", "3.1.0");
+        expect(processed).toHaveProperty("info.title", "Test API");
+        expect(processed).toHaveProperty("paths./test.get.responses.200.description", "OK");
+        expect(processed).toHaveProperty("tags.0.name", "example");
+    });
+});
+//# sourceMappingURL=removeExtensions.test.js.map

package/dist/lib/plugins/openapi/post-processors/removeExtensions.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeExtensions.test.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/post-processors/removeExtensions.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/plugins/openapi/post-processors/removeParameters.d.ts

@@ -0,0 +1,10 @@
+import { type RecordAny } from "./traverse.js";
+interface RemoveParametersOptions {
+    names?: string[];
+    in?: string[];
+    shouldRemove?: ({ parameter }: {
+        parameter: RecordAny;
+    }) => boolean;
+}
+export declare const removeParameters: ({ names, in: locations, shouldRemove }?: RemoveParametersOptions) => (doc: RecordAny) => RecordAny;
+export {};

package/dist/lib/plugins/openapi/post-processors/removeParameters.js

@@ -0,0 +1,66 @@
+import { traverse } from "./traverse.js";
+export const removeParameters = ({ names, in: locations, shouldRemove } = {}) => (doc) => traverse(doc, (spec) => {
+    // Helper function to filter parameters
+    const filterParameters = (parameters) => parameters.filter((p) => {
+        if (names?.includes(p.name))
+            return false;
+        if (locations?.includes(p.in))
+            return false;
+        if (shouldRemove?.({ parameter: p }))
+            return false;
+        return true;
+    });
+    // Handle components.parameters
+    if (spec.components?.parameters) {
+        spec = {
+            ...spec,
+            components: {
+                ...spec.components,
+                parameters: Object.fromEntries(Object.entries(spec.components.parameters).filter(([_, param]) => {
+                    const p = param;
+                    if (p.$ref)
+                        return true; // Skip references
+                    return (!names?.includes(p.name) &&
+                        !locations?.includes(p.in) &&
+                        !shouldRemove?.({ parameter: p }));
+                })),
+            },
+        };
+    }
+    // Handle paths
+    if (spec.paths) {
+        const updatedPaths = {};
+        for (const [path, pathItem] of Object.entries(spec.paths)) {
+            if (typeof pathItem !== "object" || pathItem === null) {
+                updatedPaths[path] = pathItem;
+                continue;
+            }
+            let updatedPathItem = { ...pathItem };
+            // Handle path-level parameters
+            if ("parameters" in updatedPathItem &&
+                Array.isArray(updatedPathItem.parameters)) {
+                updatedPathItem.parameters = filterParameters(updatedPathItem.parameters);
+            }
+            // Handle operation-level parameters
+            for (const method of Object.keys(updatedPathItem)) {
+                const pathItemWithMethods = updatedPathItem;
+                if (method === "parameters" ||
+                    typeof pathItemWithMethods[method] !== "object") {
+                    continue;
+                }
+                const operation = pathItemWithMethods[method];
+                if (Array.isArray(operation.parameters)) {
+                    pathItemWithMethods[method] = {
+                        ...operation,
+                        parameters: filterParameters(operation.parameters),
+                    };
+                    updatedPathItem = pathItemWithMethods;
+                }
+            }
+            updatedPaths[path] = updatedPathItem;
+        }
+        spec = { ...spec, paths: updatedPaths };
+    }
+    return spec;
+});
+//# sourceMappingURL=removeParameters.js.map

package/dist/lib/plugins/openapi/post-processors/removeParameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeParameters.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/post-processors/removeParameters.ts"],"names":[],"mappings":"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"}

package/dist/lib/plugins/openapi/post-processors/removeParameters.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/plugins/openapi/post-processors/removeParameters.test.js

@@ -0,0 +1,131 @@
+import { describe, expect, it } from "vitest";
+import { removeParameters } from "./removeParameters.js";
+const baseDoc = {
+    openapi: "3.1.0",
+    info: {
+        title: "Test API",
+        version: "1.0.0",
+    },
+    components: {
+        parameters: {
+            commonParam: {
+                name: "commonParam",
+                in: "query",
+                schema: { type: "string" },
+            },
+            headerParam: {
+                name: "headerParam",
+                in: "header",
+                schema: { type: "string" },
+            },
+        },
+    },
+    paths: {
+        "/test": {
+            parameters: [
+                {
+                    name: "pathParam",
+                    in: "path",
+                    schema: { type: "string" },
+                    required: true,
+                },
+                {
+                    name: "pathHeader",
+                    in: "header",
+                    schema: { type: "string" },
+                    required: true,
+                },
+            ],
+            get: {
+                parameters: [
+                    {
+                        name: "opParam",
+                        in: "query",
+                        schema: { type: "string" },
+                        required: true,
+                    },
+                    {
+                        name: "opHeader",
+                        in: "header",
+                        schema: { type: "string" },
+                        required: true,
+                    },
+                ],
+                responses: {
+                    "200": {
+                        description: "OK",
+                    },
+                },
+            },
+        },
+    },
+};
+describe("removeParameters", () => {
+    it("removes parameters by name", () => {
+        const processed = removeParameters({
+            names: ["pathParam", "opParam"],
+        })(baseDoc);
+        expect(processed.paths["/test"].parameters).toHaveLength(1);
+        expect(processed.paths["/test"].parameters[0].name).toBe("pathHeader");
+        expect(processed.paths["/test"].get.parameters).toHaveLength(1);
+        expect(processed.paths["/test"].get.parameters[0].name).toBe("opHeader");
+    });
+    it("removes parameters by location", () => {
+        const processed = removeParameters({
+            in: ["header"],
+        })(baseDoc);
+        expect(processed.paths["/test"].parameters).toHaveLength(1);
+        expect(processed.paths["/test"].parameters[0].in).toBe("path");
+        expect(processed.paths["/test"].get.parameters).toHaveLength(1);
+        expect(processed.paths["/test"].get.parameters[0].in).toBe("query");
+    });
+    it("removes parameters using shouldRemove callback", () => {
+        const processed = removeParameters({
+            shouldRemove: ({ parameter }) => parameter.in === "header" && parameter.name.includes("op"),
+        })(baseDoc);
+        expect(processed.paths["/test"].parameters).toHaveLength(2);
+        expect(processed.paths["/test"].get.parameters).toHaveLength(1);
+        expect(processed.paths["/test"].get.parameters[0].name).toBe("opParam");
+    });
+    it("combines multiple removal criteria", () => {
+        const processed = removeParameters({
+            in: ["query", "header"],
+            shouldRemove: ({ parameter }) => parameter.name === "pathHeader",
+        })(baseDoc);
+        expect(processed.paths["/test"].parameters).toHaveLength(1);
+        expect(processed.paths["/test"].parameters[0].name).toBe("pathParam");
+        expect(processed.paths["/test"].get.parameters).toHaveLength(0);
+    });
+    it("handles missing parameters arrays", () => {
+        const docWithoutParams = {
+            openapi: "3.1.0",
+            paths: {
+                "/test": {
+                    get: {
+                        summary: "Test endpoint",
+                    },
+                },
+            },
+        };
+        const processed = removeParameters({
+            names: ["someParam"],
+        })(docWithoutParams);
+        expect(processed).toEqual(docWithoutParams);
+    });
+    it("preserves non-parameter properties", () => {
+        const processed = removeParameters({
+            names: ["globalParam"],
+        })(baseDoc);
+        expect(processed.openapi).toBe("3.1.0");
+        expect(processed.paths["/test"].get).toBeDefined();
+    });
+    it("removes parameters from components", () => {
+        const processed = removeParameters({
+            in: ["header"],
+        })(baseDoc);
+        expect(Object.keys(processed.components.parameters)).toHaveLength(1);
+        expect(processed.components.parameters.commonParam).toBeDefined();
+        expect(processed.components.parameters.headerParam).toBeUndefined();
+    });
+});
+//# sourceMappingURL=removeParameters.test.js.map

package/dist/lib/plugins/openapi/post-processors/removeParameters.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeParameters.test.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/post-processors/removeParameters.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/plugins/openapi/post-processors/removePaths.d.ts

@@ -0,0 +1,11 @@
+import { type RecordAny } from "./traverse.js";
+interface RemovePathsOptions {
+    paths?: Record<string, true | string[]>;
+    shouldRemove?: (options: {
+        path: string;
+        method: true | string;
+        operation: RecordAny;
+    }) => boolean;
+}
+export declare const removePaths: ({ paths, shouldRemove }: RemovePathsOptions) => (doc: RecordAny) => RecordAny;
+export {};

package/dist/lib/plugins/openapi/post-processors/removePaths.js

@@ -0,0 +1,33 @@
+import { traverse } from "./traverse.js";
+export const removePaths = ({ paths = {}, shouldRemove }) => (doc) => traverse(doc, (spec) => {
+    if (!spec.paths)
+        return spec;
+    const updatedPaths = {};
+    for (const [path, methods] of Object.entries(spec.paths)) {
+        const operations = spec.paths[path];
+        // If the path is explicitly marked for removal in `paths`
+        if (paths[path] === true)
+            continue;
+        // If the path should be removed via `shouldRemove`
+        if (shouldRemove?.({ path, method: true, operation: operations }))
+            continue;
+        if (typeof methods === "object" && methods !== null) {
+            const filteredPath = Object.fromEntries(Object.entries(methods).filter(([method]) => {
+                const operations = spec.paths[path][method];
+                const isMethodToRemove = Array.isArray(paths[path]) && paths[path].includes(method);
+                const isMethodFiltered = shouldRemove?.({
+                    path,
+                    method,
+                    operation: operations,
+                });
+                return !isMethodToRemove && !isMethodFiltered;
+            }));
+            updatedPaths[path] = filteredPath;
+        }
+        else {
+            updatedPaths[path] = methods;
+        }
+    }
+    return { ...spec, paths: updatedPaths };
+});
+//# sourceMappingURL=removePaths.js.map

package/dist/lib/plugins/openapi/post-processors/removePaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removePaths.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/post-processors/removePaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,QAAQ,EAAE,MAAM,eAAe,CAAC;AAYzD,MAAM,CAAC,MAAM,WAAW,GACtB,CAAC,EAAE,KAAK,GAAG,EAAE,EAAE,YAAY,EAAsB,EAAE,EAAE,CACrD,CAAC,GAAc,EAAa,EAAE,CAC5B,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE;IACrB,IAAI,CAAC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,YAAY,GAAc,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEpC,0DAA0D;QAC1D,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI;YAAE,SAAS;QAEnC,mDAAmD;QACnD,IAAI,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;YAC/D,SAAS;QAEX,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACpD,MAAM,YAAY,GAAG,MAAM,CAAC,WAAW,CACrC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE;gBAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;gBAC5C,MAAM,gBAAgB,GACpB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAE7D,MAAM,gBAAgB,GAAG,YAAY,EAAE,CAAC;oBACtC,IAAI;oBACJ,MAAM;oBACN,SAAS,EAAE,UAAU;iBACtB,CAAC,CAAC;gBAEH,OAAO,CAAC,gBAAgB,IAAI,CAAC,gBAAgB,CAAC;YAChD,CAAC,CAAC,CACH,CAAC;YAEF,YAAY,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;QAC/B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/lib/plugins/openapi/post-processors/removePaths.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/plugins/openapi/post-processors/removePaths.test.js

@@ -0,0 +1,104 @@
+import { describe, expect, it } from "vitest";
+import { removePaths } from "./removePaths.js";
+const baseDoc = {
+    openapi: "3.0.3",
+    paths: {
+        "/example": {
+            get: { summary: "Get example" },
+            post: { summary: "Post example" },
+        },
+        "/remove-me": {
+            delete: { summary: "Delete example" },
+        },
+        "/another": {
+            get: { summary: "Another example" },
+        },
+    },
+};
+describe("removePaths", () => {
+    it("removes paths specified in the paths option", () => {
+        const processed = removePaths({
+            paths: {
+                "/remove-me": true,
+            },
+        })(baseDoc);
+        expect(processed.paths["/remove-me"]).toBeUndefined();
+        expect(processed.paths["/example"]).toBeDefined();
+        expect(processed.paths["/another"]).toBeDefined();
+    });
+    it("removes specific methods in the paths option", () => {
+        const processed = removePaths({
+            paths: {
+                "/example": ["get"],
+            },
+        })(baseDoc);
+        expect(processed.paths["/example"].get).toBeUndefined();
+        expect(processed.paths["/example"].post).toBeDefined();
+        expect(processed.paths["/remove-me"]).toBeDefined();
+    });
+    it("removes paths and methods using paths and shouldRemove together", () => {
+        const processed = removePaths({
+            paths: {
+                "/example": ["post"],
+            },
+            shouldRemove: ({ path }) => path.startsWith("/remove"),
+        })(baseDoc);
+        expect(processed.paths["/remove-me"]).toBeUndefined();
+        expect(processed.paths["/example"].get).toBeDefined();
+        expect(processed.paths["/example"].post).toBeUndefined();
+        expect(processed.paths["/another"]).toBeDefined();
+    });
+    it("removes paths based on shouldRemove callback", () => {
+        const processed = removePaths({
+            shouldRemove: ({ path }) => path.startsWith("/remove"),
+        })(baseDoc);
+        expect(processed.paths["/remove-me"]).toBeUndefined();
+        expect(processed.paths["/example"]).toBeDefined();
+        expect(processed.paths["/another"]).toBeDefined();
+    });
+    it("removes methods based on shouldRemove callback", () => {
+        const processed = removePaths({
+            shouldRemove: ({ method }) => method === "post",
+        })(baseDoc);
+        expect(processed.paths["/example"].post).toBeUndefined();
+        expect(processed.paths["/example"].get).toBeDefined();
+        expect(processed.paths["/remove-me"]).toBeDefined();
+    });
+    it("removes both paths and methods based on shouldRemove callback", () => {
+        const processed = removePaths({
+            shouldRemove: ({ path, method }) => path.startsWith("/remove") || method === "post",
+        })(baseDoc);
+        expect(processed.paths["/remove-me"]).toBeUndefined();
+        expect(processed.paths["/example"].post).toBeUndefined();
+        expect(processed.paths["/example"].get).toBeDefined();
+        expect(processed.paths["/another"]).toBeDefined();
+    });
+    it("does nothing if shouldRemove always returns false", () => {
+        const processed = removePaths({
+            shouldRemove: () => false,
+        })(baseDoc);
+        expect(processed).toEqual(baseDoc);
+    });
+    it("removes everything if shouldRemove always returns true", () => {
+        const processed = removePaths({
+            shouldRemove: () => true,
+        })(baseDoc);
+        expect(processed.paths).toEqual({});
+    });
+    it("removes entire paths via shouldRemove callback", () => {
+        const processed = removePaths({
+            shouldRemove: ({ path, method }) => method === true && path === "/remove-me",
+        })(baseDoc);
+        expect(processed.paths["/remove-me"]).toBeUndefined();
+        expect(processed.paths["/example"]).toBeDefined();
+        expect(processed.paths["/another"]).toBeDefined();
+    });
+    it("removes specific methods while keeping paths", () => {
+        const processed = removePaths({
+            shouldRemove: ({ method }) => method === "delete",
+        })(baseDoc);
+        expect(processed.paths["/remove-me"]).toBeDefined();
+        expect(processed.paths["/remove-me"].delete).toBeUndefined();
+    });
+});
+//# sourceMappingURL=removePaths.test.js.map

package/dist/lib/plugins/openapi/post-processors/removePaths.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removePaths.test.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/post-processors/removePaths.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/plugins/openapi/post-processors/traverse.d.ts

@@ -0,0 +1 @@
+export { traverse, type RecordAny } from "../../../util/traverse.js";

package/dist/lib/plugins/openapi/post-processors/traverse.js

@@ -0,0 +1,2 @@
+export { traverse } from "../../../util/traverse.js";
+//# sourceMappingURL=traverse.js.map

package/dist/lib/plugins/openapi/post-processors/traverse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traverse.js","sourceRoot":"","sources":["../../../../../src/lib/plugins/openapi/post-processors/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,2BAA2B,CAAC"}

package/dist/lib/plugins/openapi/schema/SchemaPropertyItem.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import * as Collapsible from "@radix-ui/react-collapsible";
+import { MinusIcon, PlusIcon, RefreshCcwDotIcon } from "lucide-react";
+import { useCallback, useState } from "react";
+import { Markdown, ProseClasses } from "../../../components/Markdown.js";
+import { Button } from "../../../ui/Button.js";
+import { cn } from "../../../util/cn.js";
+import { objectEntries } from "../../../util/objectEntries.js";
+import { EnumValues } from "../components/EnumValues.js";
+import { SelectOnClick } from "../components/SelectOnClick.js";
+import { ParamInfos } from "../ParamInfos.js";
+import { LogicalGroup } from "./LogicalGroup/LogicalGroup.js";
+import { SchemaView } from "./SchemaView.js";
+import { hasLogicalGroupings, isCircularRef, isComplexType, LogicalSchemaTypeMap, } from "./utils.js";
+export const SchemaLogicalGroup = ({ schema, level, }) => {
+    const [isOpen, setIsOpen] = useState(true);
+    const toggleOpen = useCallback(() => setIsOpen((prev) => !prev), []);
+    for (const [key, type] of objectEntries(LogicalSchemaTypeMap)) {
+        if (!schema[key])
+            continue;
+        return (_jsx(LogicalGroup, { schemas: schema[key], type: type, isOpen: isOpen, toggleOpen: toggleOpen, level: level }));
+    }
+};
+const RecursiveIndicator = () => (_jsxs("div", { className: "flex items-center gap-1.5 italic text-xs text-muted-foreground font-mono bg-muted px-2 py-0.5 rounded-md", children: [_jsx(RefreshCcwDotIcon, { size: 13 }), _jsx("span", { children: "circular" })] }));
+export const SchemaPropertyItem = ({ name, schema, group, level, defaultOpen = false, showCollapseButton = true, }) => {
+    const [isOpen, setIsOpen] = useState(defaultOpen);
+    if (isCircularRef(schema)) {
+        return (_jsx("li", { className: "p-4 bg-border/20 hover:bg-border/30", children: _jsx("div", { className: "flex flex-col gap-2.5 justify-between text-sm", children: _jsxs("div", { className: "space-x-2", children: [_jsx("code", { children: name }), _jsx(ParamInfos, { schema: schema }), _jsx(RecursiveIndicator, {})] }) }) }));
+    }
+    return (_jsx("li", { className: "p-4 bg-border/20 hover:bg-border/30", children: _jsxs("div", { className: "flex flex-col gap-2.5 justify-between text-sm", children: [_jsxs("div", { className: "space-x-2", children: [_jsx(SelectOnClick, { asChild: true, children: _jsx("code", { children: name }) }), _jsx(ParamInfos, { schema: schema, extraItems: [
+                                group !== "optional" && (_jsx("span", { className: "text-primary", children: "required" })),
+                            ] }), schema.type === "array" &&
+                            "items" in schema &&
+                            isCircularRef(schema.items) && _jsx(RecursiveIndicator, {})] }), schema.description && (_jsx(Markdown, { className: cn(ProseClasses, "text-sm leading-normal line-clamp-4"), content: schema.description })), schema.type === "array" && "items" in schema && schema.items.enum && (_jsx(EnumValues, { values: schema.items.enum })), schema.enum && _jsx(EnumValues, { values: schema.enum }), (hasLogicalGroupings(schema) || isComplexType(schema)) && (_jsxs(Collapsible.Root, { defaultOpen: defaultOpen, open: isOpen, onOpenChange: () => setIsOpen(!isOpen), children: [showCollapseButton && (_jsx(Collapsible.Trigger, { asChild: true, children: _jsxs(Button, { variant: "expand", size: "sm", className: "h-7", children: [isOpen ? _jsx(MinusIcon, { size: 12 }) : _jsx(PlusIcon, { size: 12 }), !isOpen ? "Show properties" : "Hide properties"] }) })), _jsx(Collapsible.Content, { children: _jsx("div", { className: "mt-2", children: hasLogicalGroupings(schema) ? (_jsx(SchemaLogicalGroup, { schema: schema, level: level + 1 })) : schema.type === "object" ? (_jsx(SchemaView, { schema: schema, level: level + 1 })) : (schema.type === "array" &&
+                                    "items" in schema &&
+                                    typeof schema.items === "object" &&
+                                    !isCircularRef(schema.items) && (_jsx(SchemaView, { schema: schema.items, level: level + 1 }))) }) })] }))] }) }));
+};
+//# sourceMappingURL=SchemaPropertyItem.js.map