@mintlify/previewing 3.0.0

package/bin/local-preview/listener/index.js

@@ -0,0 +1,200 @@
+import chokidar from "chokidar";
+import fse from "fs-extra";
+import pathUtil from "path";
+import Chalk from "chalk";
+import mintValidation from "@mintlify/validation";
+import { isFileSizeValid, openApiCheck } from "./utils.js";
+import { updateGeneratedNav, updateOpenApiFiles } from "./update.js";
+import { CLIENT_PATH, CMD_EXEC_PATH } from "../../constants.js";
+import { promises as _promises } from "fs";
+import createPage from "./utils/createPage.js";
+import { getCategory } from "./categorize.js";
+const { readFile } = _promises;
+const listener = () => {
+    chokidar
+        .watch(CMD_EXEC_PATH, {
+        ignoreInitial: true,
+        ignored: ["node_modules", ".git", ".idea"],
+        cwd: CMD_EXEC_PATH,
+    })
+        .on("add", async (filename) => {
+        try {
+            const category = await onUpdateEvent(filename);
+            switch (category) {
+                case "page":
+                    console.log("New page detected: ", filename);
+                    break;
+                case "snippet":
+                    console.log("New snippet detected: ", filename);
+                    break;
+                case "mintConfig":
+                    console.log("Config added");
+                    break;
+                case "openApi":
+                    console.log("OpenApi spec added: ", filename);
+                    break;
+                case "staticFile":
+                    console.log("Static file added: ", filename);
+                    break;
+            }
+        }
+        catch (error) {
+            console.error(error.message);
+        }
+    })
+        .on("change", async (filename) => {
+        try {
+            const category = await onUpdateEvent(filename);
+            switch (category) {
+                case "page":
+                    console.log("Page edited: ", filename);
+                    break;
+                case "snippet":
+                    console.log("Snippet edited: ", filename);
+                    break;
+                case "mintConfig":
+                    console.log("Config edited");
+                    break;
+                case "openApi":
+                    console.log("OpenApi spec edited: ", filename);
+                    break;
+                case "staticFile":
+                    console.log("Static file edited: ", filename);
+                    break;
+            }
+        }
+        catch (error) {
+            console.error(error.message);
+        }
+    })
+        .on("unlink", async (filename) => {
+        try {
+            const potentialCategory = getCategory(filename);
+            const targetPath = getTargetPath(potentialCategory, filename);
+            if (potentialCategory === "page" ||
+                potentialCategory === "snippet" ||
+                potentialCategory === "mintConfig" ||
+                potentialCategory === "staticFile") {
+                await fse.remove(targetPath);
+            }
+            switch (potentialCategory) {
+                case "page":
+                    console.log(`Page deleted: ${filename}`);
+                    break;
+                case "snippet":
+                    console.log(`Snippet deleted: ${filename}`);
+                    break;
+                case "mintConfig":
+                    console.log("⚠️ mint.json deleted. Please create a new mint.json file as it is mandatory.");
+                    process.exit(1);
+                case "potentialJsonOpenApiSpec":
+                case "potentialYamlOpenApiSpec":
+                    await updateOpenApiFiles();
+                    await updateGeneratedNav();
+                    break;
+                case "staticFile":
+                    console.log("Static file deleted: ", filename);
+                    break;
+            }
+        }
+        catch (error) {
+            console.error(error.message);
+        }
+    });
+};
+const getTargetPath = (potentialCategory, filePath) => {
+    switch (potentialCategory) {
+        case "page":
+        case "snippet":
+            return pathUtil.join(CLIENT_PATH, "src", "_props", filePath);
+        case "mintConfig":
+            return pathUtil.join(CLIENT_PATH, "src", "_props", "mint.json");
+        case "potentialYamlOpenApiSpec":
+        case "potentialJsonOpenApiSpec":
+            return pathUtil.join(CLIENT_PATH, "src", "_props", "openApiFiles.json");
+        case "staticFile":
+            return pathUtil.join(CLIENT_PATH, "public", filePath);
+        default:
+            throw new Error("Invalid category");
+    }
+};
+/**
+ * This function is called when a file is added or changed
+ * @param filename
+ * @returns FileCategory
+ */
+const onUpdateEvent = async (filename) => {
+    const filePath = pathUtil.join(CMD_EXEC_PATH, filename);
+    const potentialCategory = getCategory(filename);
+    const targetPath = getTargetPath(potentialCategory, filename);
+    let regenerateNav = false;
+    let category = potentialCategory === "potentialYamlOpenApiSpec" ||
+        potentialCategory === "potentialJsonOpenApiSpec"
+        ? "staticFile"
+        : potentialCategory;
+    switch (potentialCategory) {
+        case "page":
+            regenerateNav = true;
+            const contentStr = (await readFile(filePath)).toString();
+            const { pageContent } = await createPage(filename, contentStr, CMD_EXEC_PATH, []);
+            await fse.outputFile(targetPath, pageContent, {
+                flag: "w",
+            });
+            break;
+        case "snippet":
+            await fse.copy(filePath, targetPath);
+            break;
+        case "mintConfig":
+            regenerateNav = true;
+            const mintJsonFileContent = (await readFile(filePath)).toString();
+            try {
+                const mintConfig = JSON.parse(mintJsonFileContent);
+                const { status, errors, warnings } = mintValidation.validateMintConfig(mintConfig);
+                errors.forEach((error) => {
+                    console.error(`🚨 ${Chalk.red(error)}`);
+                });
+                warnings.forEach((warning) => {
+                    console.warn(`⚠️ ${Chalk.yellow(warning)}`);
+                });
+                if (status === "success") {
+                    await fse.copy(filePath, targetPath);
+                }
+            }
+            catch (error) {
+                if (error.name === "SyntaxError") {
+                    console.error(`🚨 ${Chalk.red("mint.json has invalid JSON. You are likely missing a comma or a bracket. You can paste your mint.json file into https://jsonlint.com/ to get a more specific error message.")}`);
+                }
+                else {
+                    console.error(`🚨 ${Chalk.red(error.message)}`);
+                }
+            }
+            break;
+        case "potentialYamlOpenApiSpec":
+        case "potentialJsonOpenApiSpec":
+            let isOpenApi = false;
+            const openApiInfo = await openApiCheck(filePath);
+            isOpenApi = openApiInfo.isOpenApi;
+            if (isOpenApi) {
+                // TODO: Instead of re-generating all openApi files, optimize by just updating the specific file that changed.
+                await updateOpenApiFiles();
+                regenerateNav = true;
+                category = "openApi";
+            }
+            break;
+        case "staticFile":
+            if (await isFileSizeValid(filePath, 5)) {
+                await fse.copy(filePath, targetPath);
+            }
+            else {
+                console.error(Chalk.red(`🚨 The file at ${filename} is too big. The maximum file size is 5 mb.`));
+            }
+            break;
+    }
+    if (regenerateNav) {
+        // TODO: Instead of re-generating the entire nav, optimize by just updating the specific page that changed.
+        await updateGeneratedNav();
+    }
+    return category;
+};
+export default listener;
+//# sourceMappingURL=index.js.map

package/bin/local-preview/listener/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/local-preview/listener/index.ts"],"names":[],"mappings":"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"}

package/bin/local-preview/listener/update.js

@@ -0,0 +1,24 @@
+// TODO: Add Types
+import fse from "fs-extra";
+import { promises as _promises } from "fs";
+import { CLIENT_PATH, CMD_EXEC_PATH } from "../../constants.js";
+import { join } from "path";
+import { generateNav } from "./generate.js";
+import { categorizeFiles } from "./categorize.js";
+const { readFile } = _promises;
+// TODO: Put in prebuild package
+export const updateGeneratedNav = async () => {
+    const generatedNav = await generateNav();
+    const targetPath = join(CLIENT_PATH, "src", "_props", "generatedNav.json");
+    await fse.outputFile(targetPath, JSON.stringify(generatedNav, null, 2), {
+        flag: "w",
+    });
+};
+export const updateOpenApiFiles = async () => {
+    const { openApiFiles } = await categorizeFiles(CMD_EXEC_PATH);
+    const targetPath = join(CLIENT_PATH, "src", "_props", "openApiFiles.json");
+    await fse.outputFile(targetPath, JSON.stringify(openApiFiles, null, 2), {
+        flag: "w",
+    });
+};
+//# sourceMappingURL=update.js.map

package/bin/local-preview/listener/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../src/local-preview/listener/update.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAClB,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;AAE/B,gCAAgC;AAEhC,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,IAAI,EAAE;IAC3C,MAAM,YAAY,GAAG,MAAM,WAAW,EAAE,CAAC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC3E,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACtE,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,IAAI,EAAE;IAC3C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,eAAe,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC;IAC3E,MAAM,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACtE,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;AACL,CAAC,CAAC"}

package/bin/local-preview/listener/utils/createPage.js

@@ -0,0 +1,163 @@
+import matter from "gray-matter";
+import isAbsoluteUrl from "is-absolute-url";
+import { remark } from "remark";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkGfm from "remark-gfm";
+import remarkMdx from "remark-mdx";
+import { visit } from "unist-util-visit";
+const createPage = async (pagePath, pageContent, contentDirectoryPath, openApiFiles) => {
+    const { data: metadata } = matter(pageContent);
+    try {
+        const parsedContent = await preParseMdx(pageContent, contentDirectoryPath);
+        pageContent = parsedContent;
+    }
+    catch (error) {
+        pageContent = `🚧 A parsing error occured. Please contact the owner of this website.`;
+    }
+    // Replace .mdx so we can pass file paths into this function
+    const slug = pagePath.replace(/\.mdx?$/, "");
+    let defaultTitle = slugToTitle(slug);
+    // Append data from OpenAPI if it exists
+    const { title, description } = getOpenApiTitleAndDescription(openApiFiles, metadata?.openapi);
+    if (title) {
+        defaultTitle = title;
+    }
+    const pageMetadata = {
+        title: defaultTitle,
+        description,
+        ...metadata,
+        href: optionallyAddLeadingSlash(slug),
+    };
+    return {
+        pageMetadata,
+        pageContent,
+        slug: removeLeadingSlash(slug),
+    };
+};
+const preParseMdx = async (fileContent, contentDirectoryPath) => {
+    const removeContentDirectoryPath = (filePath) => {
+        const pathArr = createPathArr(filePath);
+        const contentDirectoryPathArr = createPathArr(contentDirectoryPath);
+        contentDirectoryPathArr.reverse().forEach((dir, index) => {
+            if (pathArr[index] === dir) {
+                pathArr.pop();
+            }
+        });
+        return "/" + pathArr.join("/");
+    };
+    const removeContentDirectoryPaths = () => {
+        return (tree) => {
+            visit(tree, (node) => {
+                if (node == null) {
+                    return;
+                }
+                if (node.name === "img" || node.name === "source") {
+                    const srcAttrIndex = node.attributes.findIndex((attr) => attr?.name === "src");
+                    const nodeUrl = node.attributes[srcAttrIndex].value;
+                    if (
+                    // <img/> component
+                    srcAttrIndex !== -1 &&
+                        !isAbsoluteUrl(nodeUrl) &&
+                        !isDataString(nodeUrl)) {
+                        node.attributes[srcAttrIndex].value =
+                            removeContentDirectoryPath(nodeUrl);
+                    }
+                }
+                else if (
+                // ![]() format
+                node.type === "image" &&
+                    node.url &&
+                    !isAbsoluteUrl(node.url) &&
+                    !isDataString(node.url)) {
+                    node.url = removeContentDirectoryPath(node.url);
+                }
+            });
+            return tree;
+        };
+    };
+    const file = await remark()
+        .use(remarkMdx)
+        .use(remarkGfm)
+        .use(remarkFrontmatter, ["yaml", "toml"])
+        .use(removeContentDirectoryPaths)
+        .process(fileContent);
+    return String(file);
+};
+const removeLeadingSlash = (str) => {
+    const path = createPathArr(str);
+    return path.join("/");
+};
+const createPathArr = (path) => {
+    return path.split("/").filter((dir) => dir !== "");
+};
+const isDataString = (str) => str.startsWith("data:");
+const getOpenApiTitleAndDescription = (openApiFiles, openApiMetaField) => {
+    const { operation } = getOpenApiOperationMethodAndEndpoint(openApiFiles, openApiMetaField);
+    if (operation == null) {
+        return {};
+    }
+    return {
+        title: operation.summary,
+        description: operation.description,
+    };
+};
+const getOpenApiOperationMethodAndEndpoint = (openApiFiles, openApiMetaField) => {
+    const { endpoint, method, filename } = extractMethodAndEndpoint(openApiMetaField);
+    let path;
+    openApiFiles?.forEach((file) => {
+        const openApiFile = file.spec;
+        const openApiPath = openApiFile.paths && openApiFile.paths[endpoint];
+        const isFilenameOrNone = !filename || filename === file.filename;
+        if (openApiPath && isFilenameOrNone) {
+            path = openApiPath;
+        }
+    });
+    if (path == null) {
+        return {};
+    }
+    let operation;
+    if (method) {
+        operation = path[method.toLowerCase()];
+    }
+    else {
+        const firstOperationKey = Object.keys(path)[0];
+        operation = path[firstOperationKey];
+    }
+    return {
+        operation,
+        method,
+        endpoint,
+    };
+};
+const extractMethodAndEndpoint = (openApiMetaField) => {
+    const methodRegex = /(get|post|put|delete|patch)\s/i;
+    const trimmed = openApiMetaField.trim();
+    const foundMethod = trimmed.match(methodRegex);
+    const startIndexOfMethod = foundMethod
+        ? openApiMetaField.indexOf(foundMethod[0])
+        : 0;
+    const endIndexOfMethod = foundMethod
+        ? startIndexOfMethod + foundMethod[0].length - 1
+        : 0;
+    const filename = openApiMetaField.substring(0, startIndexOfMethod).trim();
+    return {
+        method: foundMethod ? foundMethod[0].slice(0, -1).toUpperCase() : undefined,
+        endpoint: openApiMetaField.substring(endIndexOfMethod).trim(),
+        filename: filename ? filename : undefined,
+    };
+};
+function optionallyAddLeadingSlash(path) {
+    if (path.startsWith("/")) {
+        return path;
+    }
+    return "/" + path;
+}
+export const slugToTitle = (slug) => {
+    const slugArr = slug.split("/");
+    let defaultTitle = slugArr[slugArr.length - 1].split("-").join(" "); //replace all dashes
+    defaultTitle = defaultTitle.split("_").join(" "); //replace all underscores
+    defaultTitle = defaultTitle.charAt(0).toUpperCase() + defaultTitle.slice(1); //capitalize first letter
+    return defaultTitle;
+};
+export default createPage;
+//# sourceMappingURL=createPage.js.map

package/bin/local-preview/listener/utils/createPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPage.js","sourceRoot":"","sources":["../../../../src/local-preview/listener/utils/createPage.ts"],"names":[],"mappings":"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"}

package/bin/local-preview/listener/utils/getOpenApiContext.js

@@ -0,0 +1,57 @@
+export const extractMethodAndEndpoint = (api) => {
+    const methodRegex = /(get|post|put|delete|patch)\s/i;
+    const trimmed = api.trim();
+    const foundMethod = trimmed.match(methodRegex);
+    const startIndexOfMethod = foundMethod ? api.indexOf(foundMethod[0]) : 0;
+    const endIndexOfMethod = foundMethod
+        ? startIndexOfMethod + foundMethod[0].length - 1
+        : 0;
+    const filename = api.substring(0, startIndexOfMethod).trim();
+    return {
+        method: foundMethod ? foundMethod[0].slice(0, -1).toUpperCase() : undefined,
+        endpoint: api.substring(endIndexOfMethod).trim(),
+        filename: filename ? filename : undefined,
+    };
+};
+export const getOpenApiOperationMethodAndEndpoint = (openApi, openApiMetaField) => {
+    const { endpoint, method, filename } = extractMethodAndEndpoint(openApiMetaField);
+    let path;
+    openApi.files?.forEach((file) => {
+        const openApiFile = file.openapi;
+        const openApiPath = openApiFile.paths && openApiFile.paths[endpoint];
+        const isFilenameOrNone = !filename || filename === file.name;
+        if (openApiPath && isFilenameOrNone) {
+            path = openApiPath;
+        }
+    });
+    if (path == null) {
+        return {};
+    }
+    let operation;
+    if (method) {
+        operation = path[method.toLowerCase()];
+    }
+    else {
+        const firstOperationKey = Object.keys(path)[0];
+        operation = path[firstOperationKey];
+    }
+    return {
+        operation,
+        method,
+        endpoint,
+    };
+};
+export const getOpenApiTitleAndDescription = (openApi, openApiMetaField) => {
+    if (openApi == null || !openApiMetaField || openApiMetaField == null) {
+        return {};
+    }
+    const { operation } = getOpenApiOperationMethodAndEndpoint(openApi, openApiMetaField);
+    if (operation == null) {
+        return {};
+    }
+    return {
+        title: operation.summary,
+        description: operation.description,
+    };
+};
+//# sourceMappingURL=getOpenApiContext.js.map

package/bin/local-preview/listener/utils/getOpenApiContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOpenApiContext.js","sourceRoot":"","sources":["../../../../src/local-preview/listener/utils/getOpenApiContext.ts"],"names":[],"mappings":"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"}

package/bin/local-preview/listener/utils/mintConfigFile.js

@@ -0,0 +1,22 @@
+import { promises as _promises } from "fs";
+import { pathExists } from "fs-extra";
+import pathUtil from "path";
+const { readFile } = _promises;
+// TODO: Put in prebuild package
+export const getConfigPath = async (contentDirectoryPath) => {
+    if (await pathExists(pathUtil.join(contentDirectoryPath, "mint.json"))) {
+        return pathUtil.join(contentDirectoryPath, "mint.json");
+    }
+    return null;
+};
+// TODO: Put in prebuild package
+export const getConfigObj = async (contentDirectoryPath) => {
+    const configPath = await getConfigPath(contentDirectoryPath);
+    let configObj = null;
+    if (configPath) {
+        const configContents = await readFile(configPath);
+        configObj = await JSON.parse(configContents.toString());
+    }
+    return configObj;
+};
+//# sourceMappingURL=mintConfigFile.js.map

package/bin/local-preview/listener/utils/mintConfigFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mintConfigFile.js","sourceRoot":"","sources":["../../../../src/local-preview/listener/utils/mintConfigFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,QAAQ,MAAM,MAAM,CAAC;AAE5B,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;AAE/B,gCAAgC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,oBAA4B,EACJ,EAAE;IAC1B,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC,EAAE;QACtE,OAAO,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;KACzD;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,oBAA4B,EACd,EAAE;IAChB,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC,oBAAoB,CAAC,CAAC;IAC7D,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,UAAU,EAAE;QACd,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClD,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;KACzD;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/bin/local-preview/listener/utils/toTitleCase.js

@@ -0,0 +1,36 @@
+export function toTitleCase(text) {
+    const smallWords = /^(a|an|and|as|at|but|by|en|for|if|in|nor|of|on|or|per|the|to|v.?|vs.?|via)$/i;
+    const alphanumericPattern = /([A-Za-z0-9\u00C0-\u00FF])/;
+    const wordSeparators = /([ :–—-])/;
+    return text
+        .split(wordSeparators)
+        .map(function (current, index, array) {
+        if (
+        // Check for small words
+        current.search(smallWords) > -1 &&
+            // Skip first and last word
+            index !== 0 &&
+            index !== array.length - 1 &&
+            // Ignore title end and subtitle start
+            array[index - 3] !== ':' &&
+            array[index + 1] !== ':' &&
+            // Ignore small words that start a hyphenated phrase
+            (array[index + 1] !== '-' || (array[index - 1] === '-' && array[index + 1] === '-'))) {
+            return current.toLowerCase();
+        }
+        // Ignore intentional capitalization
+        if (current.substring(1).search(/[A-Z]|\../) > -1) {
+            return current;
+        }
+        // Ignore URLs
+        if (array[index + 1] === ':' && array[index + 2] !== '') {
+            return current;
+        }
+        // Capitalize the first letter
+        return current.replace(alphanumericPattern, function (match) {
+            return match.toUpperCase();
+        });
+    })
+        .join('');
+}
+//# sourceMappingURL=toTitleCase.js.map

package/bin/local-preview/listener/utils/toTitleCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toTitleCase.js","sourceRoot":"","sources":["../../../../src/local-preview/listener/utils/toTitleCase.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,8EAA8E,CAAC;IAClG,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;IACzD,MAAM,cAAc,GAAG,WAAW,CAAC;IAEnC,OAAO,IAAI;SACR,KAAK,CAAC,cAAc,CAAC;SACrB,GAAG,CAAC,UAAU,OAAO,EAAE,KAAK,EAAE,KAAK;QAClC;QACE,wBAAwB;QACxB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YAC/B,2BAA2B;YAC3B,KAAK,KAAK,CAAC;YACX,KAAK,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC;YAC1B,sCAAsC;YACtC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;YACxB,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG;YACxB,oDAAoD;YACpD,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,EACpF;YACA,OAAO,OAAO,CAAC,WAAW,EAAE,CAAC;SAC9B;QAED,oCAAoC;QACpC,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE;YACjD,OAAO,OAAO,CAAC;SAChB;QAED,cAAc;QACd,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACvD,OAAO,OAAO,CAAC;SAChB;QAED,8BAA8B;QAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,UAAU,KAAa;YACjE,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;QAC7B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/bin/local-preview/listener/utils/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/bin/local-preview/listener/utils/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/local-preview/listener/utils/types.ts"],"names":[],"mappings":""}

package/bin/local-preview/listener/utils.js

@@ -0,0 +1,68 @@
+import SwaggerParser from "@apidevtools/swagger-parser";
+import { promises as _promises } from "fs";
+const { readdir, stat } = _promises;
+export const getFileExtension = (filename) => {
+    return (filename.substring(filename.lastIndexOf(".") + 1, filename.length) ||
+        filename);
+};
+export const openApiCheck = async (path) => {
+    let spec;
+    let isOpenApi = false;
+    try {
+        spec = await SwaggerParser.validate(path);
+        isOpenApi = true;
+    }
+    catch {
+        // not valid openApi
+    }
+    return { spec, isOpenApi };
+};
+export const filterOutNullInGroup = (group) => {
+    const newPages = filterOutNullInPages(group.pages);
+    const newGroup = {
+        ...group,
+        pages: newPages,
+    };
+    return newGroup;
+};
+const filterOutNullInPages = (pages) => {
+    const newPages = [];
+    pages.forEach((page) => {
+        if (page == null) {
+            return;
+        }
+        if (page.hasOwnProperty("pages")) {
+            const group = page;
+            const newGroup = filterOutNullInGroup(group);
+            newPages.push(newGroup);
+        }
+        else {
+            newPages.push(page);
+        }
+    });
+    return newPages;
+};
+export const getFileList = async (dirName, og = dirName) => {
+    let files = [];
+    const items = await readdir(dirName, { withFileTypes: true });
+    for (const item of items) {
+        if (item.isDirectory()) {
+            files = [...files, ...(await getFileList(`${dirName}/${item.name}`, og))];
+        }
+        else {
+            const path = `${dirName}/${item.name}`;
+            const name = path.replace(og, "");
+            files.push(name);
+        }
+    }
+    return files;
+};
+export const isFileSizeValid = async (path, maxFileSizeInMb) => {
+    const maxFileSizeBytes = maxFileSizeInMb * 1000000;
+    const stats = await stat(path);
+    return stats.size <= maxFileSizeBytes;
+};
+export function isError(obj) {
+    return Object.prototype.toString.call(obj) === "[object Error]";
+}
+//# sourceMappingURL=utils.js.map

package/bin/local-preview/listener/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/local-preview/listener/utils.ts"],"names":[],"mappings":"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"}