mintlify 1.1.0 → 1.1.2

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

@@ -0,0 +1,121 @@
+// TODO - add types
+import fse from "fs-extra";
+import { promises as _promises } from "fs";
+import matter from "gray-matter";
+import path from "path";
+import categorizeFiles from "./categorizeFiles.js";
+import { getConfigObj } from "./mintConfigFile.js";
+import { getOpenApiTitleAndDescription } from "./getOpenApiContext.js";
+import { slugToTitle } from "./slugToTitle.js";
+import { CLIENT_PATH, CMD_EXEC_PATH } from "../../constants.js";
+const { readFile } = _promises;
+// End matter is front matter, but at the end
+const getIndexOfEndMatter = (fileContents) => {
+    const frontMatters = fileContents.match(/---\n(title:.+\n|description:.+\n|sidebarTitle:.+\n|api:.+\n|openapi:.+\n)+---$/m);
+    if (frontMatters) {
+        return fileContents.indexOf(frontMatters[0]);
+    }
+    return -1;
+};
+export const potentiallyRemoveEndMatter = (fileContents) => {
+    const endMatterIndex = getIndexOfEndMatter(fileContents);
+    if (endMatterIndex === -1) {
+        return fileContents;
+    }
+    return fileContents.substring(0, endMatterIndex);
+};
+const getMetadata = (fileContents) => {
+    const { data } = matter(fileContents);
+    if (Object.keys(data).length > 0) {
+        return data;
+    }
+    const startIndex = getIndexOfEndMatter(fileContents);
+    if (startIndex === -1) {
+        return {};
+    }
+    const fileContentFromFrontMatter = fileContents.substring(startIndex);
+    const { data: nonTopFrontMatter } = matter(fileContentFromFrontMatter);
+    return nonTopFrontMatter;
+};
+export const createPage = (path, content, openApiObj) => {
+    const slug = path.replace(/\.mdx?$/, "").substring(1);
+    let defaultTitle = slugToTitle(slug);
+    const metadata = getMetadata(content);
+    // Append data from OpenAPI if it exists
+    const { title, description } = getOpenApiTitleAndDescription(openApiObj, metadata === null || metadata === void 0 ? void 0 : metadata.openapi);
+    if (title) {
+        defaultTitle = title;
+    }
+    return {
+        [slug]: Object.assign(Object.assign({ title: defaultTitle, description }, metadata), { href: `/${slug}` }),
+    };
+};
+export const createMetadataFileFromPages = (pages, configObj) => {
+    const targetPath = path.join(CLIENT_PATH, "src", "metadata.json");
+    const createNav = (nav) => {
+        return {
+            group: nav.group,
+            pages: nav.pages.map((page) => {
+                if (typeof page === "string") {
+                    return pages[page];
+                }
+                return createNav(page);
+            }),
+        };
+    };
+    if ((configObj === null || configObj === void 0 ? void 0 : configObj.navigation) == null) {
+        return;
+    }
+    let navFile = configObj.navigation.map((nav) => createNav(nav));
+    const filterOutNullInPages = (pages) => {
+        const newPages = [];
+        pages.forEach((page) => {
+            if (page == null) {
+                return;
+            }
+            if (page === null || page === void 0 ? void 0 : page.pages) {
+                const newGroup = filterOutNullInGroup(page);
+                newPages.push(newGroup);
+            }
+            else {
+                newPages.push(page);
+            }
+        });
+        return newPages;
+    };
+    const filterOutNullInGroup = (group) => {
+        const newPages = filterOutNullInPages(group.pages);
+        const newGroup = Object.assign(Object.assign({}, group), { pages: newPages });
+        return newGroup;
+    };
+    const newNavFile = navFile.map((group) => {
+        return filterOutNullInGroup(group);
+    });
+    fse.outputFileSync(targetPath, JSON.stringify(newNavFile, null, 2), {
+        flag: "w",
+    });
+};
+export const createMetadataFile = async () => {
+    // create pages
+    const { markdownFiles, openApiBuffer } = await categorizeFiles();
+    let openApiObj = null;
+    if (openApiBuffer) {
+        openApiObj = JSON.parse(openApiBuffer.toString());
+    }
+    // create config object
+    const configObj = await getConfigObj();
+    let pages = {};
+    const mdPromises = [];
+    markdownFiles.forEach((filename) => {
+        mdPromises.push((async () => {
+            const sourcePath = path.join(CMD_EXEC_PATH, filename);
+            const fileContent = await readFile(sourcePath);
+            const contentStr = fileContent.toString();
+            const page = createPage(filename, contentStr, openApiObj);
+            pages = Object.assign(Object.assign({}, pages), page);
+        })());
+    });
+    await Promise.all(mdPromises);
+    createMetadataFileFromPages(pages, configObj);
+};
+//# sourceMappingURL=metadata.js.map

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

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

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

@@ -0,0 +1,43 @@
+import { promises as _promises } from "fs";
+import fse, { pathExists } from "fs-extra";
+import path from "path";
+import { CLIENT_PATH, CMD_EXEC_PATH } from "../../constants.js";
+const { readFile } = _promises;
+const getConfigPath = async () => {
+    let configPath = null;
+    if (await pathExists(path.join(CMD_EXEC_PATH, "mint.config.json"))) {
+        configPath = path.join(CMD_EXEC_PATH, "mint.config.json");
+    }
+    if (await pathExists(path.join(CMD_EXEC_PATH, "mint.json"))) {
+        configPath = path.join(CMD_EXEC_PATH, "mint.json");
+    }
+    return configPath;
+};
+export const getConfigObj = async () => {
+    const configPath = await getConfigPath();
+    let configObj = null;
+    if (configPath) {
+        const configContents = await readFile(configPath);
+        configObj = JSON.parse(configContents.toString());
+    }
+    return configObj;
+};
+export const updateConfigFile = async (logger) => {
+    const configTargetPath = path.join(CLIENT_PATH, "src", "mint.json");
+    await fse.remove(configTargetPath);
+    let configObj = null;
+    const configPath = await getConfigPath();
+    if (configPath) {
+        await fse.remove(configTargetPath);
+        await fse.copy(configPath, configTargetPath);
+        logger.succeed("mint config file synced");
+        const configContents = await readFile(configPath);
+        configObj = JSON.parse(configContents.toString());
+    }
+    else {
+        logger.fail("Must be ran in a directory where a mint.json file exists.");
+        process.exit(1);
+    }
+    return configObj;
+};
+//# sourceMappingURL=mintConfigFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mintConfigFile.js","sourceRoot":"","sources":["../../../src/local-preview/utils/mintConfigFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,GAAG,EAAE,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEhE,MAAM,EAAE,QAAQ,EAAE,GAAG,SAAS,CAAC;AAE/B,MAAM,aAAa,GAAG,KAAK,IAA4B,EAAE;IACvD,IAAI,UAAU,GAAG,IAAI,CAAC;IACtB,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC,EAAE;QAClE,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;KAC3D;IAED,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC,EAAE;QAC3D,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;KACpD;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,IAA4B,EAAE;IAC7D,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IACzC,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,IAAI,UAAU,EAAE;QACd,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;KACnD;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,MAAW,EAAE,EAAE;IACpD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC;IACpE,MAAM,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IACnC,IAAI,SAAS,GAAG,IAAI,CAAC;IACrB,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAC;IAEzC,IAAI,UAAU,EAAE;QACd,MAAM,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACnC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC7C,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;QAC1C,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClD,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC,CAAC;KACnD;SAAM;QACL,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACjB;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

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

@@ -0,0 +1,16 @@
+import SwaggerParser from "@apidevtools/swagger-parser";
+const openApiCheck = async (path) => {
+    let buffer = undefined;
+    let isOpenApi = false;
+    try {
+        const api = await SwaggerParser.validate(path);
+        buffer = Buffer.from(JSON.stringify(api, null, 2), "utf-8");
+        isOpenApi = true;
+    }
+    catch (_a) {
+        // not valid openApi
+    }
+    return { buffer, isOpenApi };
+};
+export default openApiCheck;
+//# sourceMappingURL=openApiCheck.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openApiCheck.js","sourceRoot":"","sources":["../../../src/local-preview/utils/openApiCheck.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,MAAM,6BAA6B,CAAC;AAGxD,MAAM,YAAY,GAAG,KAAK,EACxB,IAAY,EACiD,EAAE;IAC/D,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI;QACF,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC5D,SAAS,GAAG,IAAI,CAAC;KAClB;IAAC,WAAM;QACN,oBAAoB;KACrB;IACD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AAC/B,CAAC,CAAC;AAEF,eAAe,YAAY,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"slugToTitle.js","sourceRoot":"","sources":["../../../src/local-preview/utils/slugToTitle.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,EAAE;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,oBAAoB;IACzF,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,yBAAyB;IAC3E,YAAY,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,yBAAyB;IACtG,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC"}

package/bin/mint/client/README.md

@@ -20,9 +20,7 @@ yarn
 ### Build
 
 - `INTERNAL_SITE_BEARER_TOKEN=example yarn prebuild` - fetches the files for the site associated with that bearer token from GitHub. You need the pre-hashed bearer token for that to work. Mintlify employees can request the token that grants access to a test site. In the future, we will work on a way of generating temporary bearer tokens from an employee login.
-- `yarn local` - the local version of `yarn prebuild` (fetches the content from the local `../docs` folder)
-- `yarn local-to-docs` - transfers the untracked files to the `../docs` file (helpful for when you're working on content and you want to see changes live)
-  - Both `yarn local` and `yarn local-to-docs` take in a filepath as a parameter for when you want to transfer files to a directory that isn't `../docs`. For example, let's say I'm working on a migration for a client, then I can run `yarn local ../../clients/vital/docs` to get the files from that folder.
+- `yarn local` - the local version of `yarn prebuild` (fetches the content from the local `../docs` folder). It can take in a filepath as a parameter for when you want to transfer files to a directory that isn't `../docs`. For example, let's say I'm working on a migration for a client, then I can run `yarn local ../../clients/vital/docs` to get the files from that folder.
 
 ### Watch
 

package/bin/mint/client/package.json

@@ -4,7 +4,6 @@
   "scripts": {
     "prebuild": "node prebuild index.ts",
     "local": "node scripts/local",
-    "local-to-docs": "node scripts/local-to-docs",
     "dev": "next dev",
     "build": "next build",
     "start": "next start",

package/bin/mint/client/src/nav.json

@@ -0,0 +1,219 @@
+[
+  {
+    "group": "Getting started",
+    "pages": [
+      {
+        "title": "Onboarding and Setup",
+        "description": "This page will help you get started with Telematica EV APIs",
+        "href": "/onboarding"
+      },
+      {
+        "title": "Contact us",
+        "href": "/contact-us"
+      },
+      {
+        "title": "Supported EV brands",
+        "href": "/supported-ev-models-india"
+      }
+    ]
+  },
+  {
+    "group": "Products",
+    "pages": [
+      {
+        "title": "Telematica Connect UI",
+        "description": "Authenticate users with 26+ EV brands using white labeled UI",
+        "href": "/products/vehicle-apis"
+      },
+      {
+        "title": "Unified Vehicle APIs",
+        "description": "Single API to read and issue commands to 26+ EV brands",
+        "href": "/products/unified-vehicle-apis"
+      },
+      {
+        "title": "Telematica Poller",
+        "description": "Effortless polling of EV data",
+        "href": "/products/telematica-poller"
+      },
+      {
+        "title": "Telematica Webhooks",
+        "href": "/products/webhooks"
+      },
+      {
+        "title": "Telematica Schedules",
+        "description": "Schedule commands or report generation for your customer vehicles",
+        "href": "/products/telematica-schedules-beta"
+      },
+      {
+        "title": "Telematica Routing APIs (beta)",
+        "description": "Plug and play routing module for EVs with advanced features",
+        "href": "/products/telematica-routing-apis-in-alpha"
+      }
+    ]
+  },
+  {
+    "group": "Guides and How-To's",
+    "pages": [
+      {
+        "title": "Consent UI and custom query parameters",
+        "href": "/guides/consent-ui-parameters"
+      },
+      {
+        "title": "Creating the POST callback endpoint",
+        "href": "/guides/callback-endpoint"
+      },
+      {
+        "title": "Expected Errors",
+        "href": "/guides/expected-errors"
+      },
+      {
+        "title": "FAQs",
+        "href": "/guides/faqs"
+      }
+    ]
+  },
+  {
+    "group": "Telematica Vehicle APIs",
+    "pages": [
+      {
+        "group": "Vehicle Data - v2",
+        "pages": [
+          {
+            "title": "SOC",
+            "description": "Get the current SOC of the vehicle in kms",
+            "href": "/reference/vehicledatacontroller_getsoc"
+          },
+          {
+            "title": "Range",
+            "description": "Get the current range of the vehicle in kms",
+            "href": "/reference/vehicledatacontroller_getrange"
+          },
+          {
+            "title": "Odometer",
+            "description": "Get the current odometer reading of the vehicle in kms",
+            "href": "/reference/vehicledatacontroller_getodo"
+          },
+          {
+            "title": "Location",
+            "description": "Get the current location of the vehicle",
+            "href": "/reference/vehicledatacontroller_getlocation"
+          },
+          {
+            "title": "Charging Status",
+            "description": "Get the current charging status of the vehicle",
+            "href": "/reference/vehicledatacontroller_getchargingstatus"
+          },
+          {
+            "title": "Static Attributes",
+            "description": "Get the static attributes of the vehicle",
+            "href": "/reference/vehicledatacontroller_getstaticattributes"
+          },
+          {
+            "title": "Start Charge",
+            "description": "Command the vehicle to start charging",
+            "href": "/reference/vehicledatacontroller_startcharging"
+          },
+          {
+            "title": "Stop Charge",
+            "description": "Command the vehicle to stop charging",
+            "href": "/reference/vehicledatacontroller_stopcharging"
+          }
+        ]
+      },
+      {
+        "group": "Testing Endpoints",
+        "pages": [
+          {
+            "title": "Testing Endpoints",
+            "href": "/reference/testing"
+          },
+          {
+            "title": "Test SOC",
+            "description": "Test the soc endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getsoctest"
+          },
+          {
+            "title": "Test Range",
+            "description": "Test the range endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getrangetest"
+          },
+          {
+            "title": "Test Range-SOC",
+            "description": "Test the range-soc endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getrangesoctest"
+          },
+          {
+            "title": "Test Location",
+            "description": "Test the location endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getlocationtest"
+          },
+          {
+            "title": "Test Charging Status",
+            "description": "Test the charging-status endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getchargingstatustest"
+          },
+          {
+            "title": "Test Odometer",
+            "description": "Test the odo endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getodotest"
+          },
+          {
+            "title": "Test static-attributes",
+            "description": "Test the static-attributes endpoint on a dummy vehicle",
+            "href": "/reference/testing/vehicledatacontroller_getstaticattributestest"
+          }
+        ]
+      },
+      {
+        "group": "Vehicle Data - v1",
+        "pages": [
+          {
+            "title": "SOC (battery level)",
+            "description": "Get the current SOC (battery level) of the vehicle",
+            "href": "/reference/vehicledatacontroller_getsocv1"
+          },
+          {
+            "title": "Range",
+            "description": "Get the current range of the vehicle in kms",
+            "href": "/reference/vehicledatacontroller_getrangev1"
+          },
+          {
+            "title": "Range-SOC",
+            "description": "Get the current range and SOC of the vehicle in single call",
+            "href": "/reference/vehicledatacontroller_getrangesocv1"
+          },
+          {
+            "title": "Location",
+            "description": "Get the last known location of the vehicle",
+            "href": "/reference/vehicledatacontroller_getlocationv1"
+          },
+          {
+            "title": "Charging Status",
+            "description": "Get the current charging status of the vehicle",
+            "href": "/reference/vehicledatacontroller_getchargingstatusv1"
+          },
+          {
+            "title": "Odometer",
+            "description": "Get the odometer reading of the vehicle",
+            "href": "/reference/vehicledatacontroller_getodov1"
+          },
+          {
+            "title": "Static Attributes",
+            "description": "Get static attributes for a vehicle (like VIN, model, year etc.)",
+            "href": "/reference/vehicledatacontroller_getstaticattributesv1"
+          }
+        ]
+      }
+    ]
+  },
+  {
+    "group": "Sample callback endpoints",
+    "pages": [
+      {
+        "title": "New vehicle connection callback",
+        "description": "This is a dummy callback endpoint.       Please share the POST callback endpoint created in your app's backend with Telematica to get callback requests of below format",
+        "href": "/reference/appcontroller_callback"
+      }
+    ]
+  }
+]

package/bin/mint/client/tailwind.config.cjs

@@ -58,7 +58,7 @@ module.exports = {
         'primary-ultralight': config?.colors?.ultraLight ?? '#ddd6fe',
         'primary-ultradark': config?.colors?.ultraDark ?? '#5b21b6',
         'background-light': config?.colors?.background?.light ?? '#ffffff',
-        'background-dark': config?.colors?.background?.dark ?? '#0f1728',
+        'background-dark': config?.colors?.background?.dark ?? '#0C1322',
         ...ctaColors,
       },
       typography: (theme) => ({

package/bin/scraping/downloadAllImages.js

@@ -16,6 +16,10 @@ export default async function downloadAllImages($, content, origin, baseDir, mod
     ];
     // Wait to all images to download before continuing
     const origToNewArray = await Promise.all(imageSrcs.map(async (origImageSrc) => {
+        // We do not support downloading base64 in-line images.
+        if (origImageSrc.startsWith("data:")) {
+            return undefined;
+        }
         // Add origin if the image tags are using relative sources
         const imageHref = origImageSrc.startsWith("http")
             ? origImageSrc

package/bin/scraping/downloadAllImages.js.map

@@ -1 +1 @@
-{"version":3,"file":"downloadAllImages.js","sourceRoot":"","sources":["../../src/scraping/downloadAllImages.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,iBAAiB,CAC7C,CAAM,EACN,OAAY,EACZ,MAAc,EACd,OAAe,EACf,cAAoB;IAEpB,IAAI,CAAC,OAAO,EAAE;QACZ,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO;KACR;IAED,kEAAkE;IAClE,4CAA4C;IAC5C,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI,GAAG,CACR,OAAO;aACJ,IAAI,CAAC,UAAU,CAAC;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aACvC,OAAO,EAAE,CACb;KACF,CAAC;IAEF,mDAAmD;IACnD,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACtC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,YAAoB,EAAE,EAAE;QAC3C,0DAA0D;QAC1D,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC;QAEvC,IAAI,QAAQ,GAAG,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACrE,IAAI,cAAc,EAAE;YAClB,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;SACrC;QAED,IAAI,CAAC,QAAQ,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;YACjD,OAAO;SACR;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE/C,MAAM,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC;aACtC,IAAI,CAAC,GAAG,EAAE;YACT,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;QACpC,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YACX,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE;gBACvB,OAAO,CAAC,GAAG,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;aACvD;iBAAM;gBACL,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAClB;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IACvC,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,cAAc,CAAC,MAAM,CAC1B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,EAAE,CACH,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAW;IAC9C,2BAA2B;IAC3B,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEnC,eAAe,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;QACxC,iFAAiF;QACjF,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"downloadAllImages.js","sourceRoot":"","sources":["../../src/scraping/downloadAllImages.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,aAAa,MAAM,qBAAqB,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,iBAAiB,CAC7C,CAAM,EACN,OAAY,EACZ,MAAc,EACd,OAAe,EACf,cAAoB;IAEpB,IAAI,CAAC,OAAO,EAAE;QACZ,OAAO,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5C,OAAO;KACR;IAED,kEAAkE;IAClE,4CAA4C;IAC5C,MAAM,SAAS,GAAG;QAChB,GAAG,IAAI,GAAG,CACR,OAAO;aACJ,IAAI,CAAC,UAAU,CAAC;aAChB,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;aACvC,OAAO,EAAE,CACb;KACF,CAAC;IAEF,mDAAmD;IACnD,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,GAAG,CACtC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,YAAoB,EAAE,EAAE;QAC3C,uDAAuD;QACvD,IAAI,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE;YACpC,OAAO,SAAS,CAAC;SAClB;QAED,0DAA0D;QAC1D,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC;YAC/C,CAAC,CAAC,YAAY;YACd,CAAC,CAAC,IAAI,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC;QAEvC,IAAI,QAAQ,GAAG,2BAA2B,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QACrE,IAAI,cAAc,EAAE;YAClB,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;SACrC;QAED,IAAI,CAAC,QAAQ,EAAE;YACb,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;YACjD,OAAO;SACR;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAE/C,MAAM,aAAa,CAAC,SAAS,EAAE,SAAS,CAAC;aACtC,IAAI,CAAC,GAAG,EAAE;YACT,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;QACpC,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;YACX,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE;gBACvB,OAAO,CAAC,GAAG,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;aACvD;iBAAM;gBACL,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;aAClB;QACH,CAAC,CAAC,CAAC;QAEL,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IACvC,CAAC,CAAC,CACH,CAAC;IAEF,OAAO,cAAc,CAAC,MAAM,CAC1B,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,EAAE,CACH,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAW;IAC9C,2BAA2B;IAC3B,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEnC,eAAe,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,EAAE;QACxC,iFAAiF;QACjF,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/bin/scraping/scrapeSectionCommands.js

@@ -3,18 +3,11 @@ import { detectFramework, Frameworks } from "./detectFramework.js";
 import { getHrefFromArgs, getOrigin } from "../util.js";
 import { scrapeSection } from "./scrapeSection.js";
 import { scrapeDocusaurusSection } from "./site-scrapers/scrapeDocusaurusSection.js";
+import openNestedDocusaurusMenus from "./site-scrapers/openNestedDocusaurusMenus.js";
 import { scrapeGitBookSection } from "./site-scrapers/scrapeGitBookSection.js";
+import openNestedGitbookMenus from "./site-scrapers/openNestedGitbookMenus.js";
 import { scrapeReadMeSection } from "./site-scrapers/scrapeReadMeSection.js";
 import { startBrowser } from "../browser.js";
-function validateFramework(framework) {
-    if (!framework) {
-        console.log("Could not detect the framework automatically. Please use one of:");
-        console.log("scrape-page-docusaurus");
-        console.log("scrape-page-gitbook");
-        console.log("scrape-page-readme");
-        return process.exit(1);
-    }
-}
 export async function scrapeSectionAxiosWrapper(argv, scrapeFunc) {
     const href = getHrefFromArgs(argv);
     const res = await axios.default.get(href);
@@ -22,50 +15,20 @@ export async function scrapeSectionAxiosWrapper(argv, scrapeFunc) {
     await scrapeSection(scrapeFunc, html, getOrigin(href), argv.overwrite);
     process.exit(0);
 }
+export async function scrapeDocusaurusSectionCommand(argv) {
+    await scrapeSectionOpeningAllNested(argv, openNestedDocusaurusMenus, scrapeDocusaurusSection);
+}
 export async function scrapeGitbookSectionCommand(argv) {
-    await scrapeSectionGitBookWrapper(argv, scrapeGitBookSection);
+    await scrapeSectionOpeningAllNested(argv, openNestedGitbookMenus, scrapeGitBookSection);
 }
-async function scrapeSectionGitBookWrapper(argv, scrapeFunc) {
+async function scrapeSectionOpeningAllNested(argv, openLinks, scrapeFunc) {
     const href = getHrefFromArgs(argv);
     const browser = await startBrowser();
     const page = await browser.newPage();
     await page.goto(href, {
         waitUntil: "networkidle2",
     });
-    let prevEncountered = [];
-    let encounteredHref = ["fake"];
-    // Loop until we've encountered every link
-    while (!encounteredHref.every((href) => prevEncountered.includes(href))) {
-        prevEncountered = encounteredHref;
-        encounteredHref = await page.evaluate((encounteredHref) => {
-            const icons = Array.from(document.querySelectorAll('path[d="M9 18l6-6-6-6"]'));
-            const linksFound = [];
-            icons.forEach(async (icon) => {
-                var _a, _b;
-                const toClick = (_a = icon === null || icon === void 0 ? void 0 : icon.parentElement) === null || _a === void 0 ? void 0 : _a.parentElement;
-                const link = (_b = toClick === null || toClick === void 0 ? void 0 : toClick.parentElement) === null || _b === void 0 ? void 0 : _b.parentElement;
-                // Skip icons not in the side navigation
-                if (!(link === null || link === void 0 ? void 0 : link.hasAttribute("href"))) {
-                    return;
-                }
-                const href = link.getAttribute("href");
-                // Should never occur but we keep it as a fail-safe
-                if ((href === null || href === void 0 ? void 0 : href.startsWith("https://")) || (href === null || href === void 0 ? void 0 : href.startsWith("http://"))) {
-                    return;
-                }
-                // Click any links we haven't seen before
-                if (href && !encounteredHref.includes(href)) {
-                    toClick === null || toClick === void 0 ? void 0 : toClick.click();
-                }
-                if (href) {
-                    linksFound.push(href);
-                }
-            });
-            return linksFound;
-        }, encounteredHref // Need to pass array into the browser
-        );
-    }
-    const html = await page.content();
+    const html = await openLinks(page);
     browser.close();
     await scrapeSection(scrapeFunc, html, getOrigin(href), argv.overwrite);
     process.exit(0);
@@ -78,7 +41,7 @@ export async function scrapeSectionAutomatically(argv) {
     validateFramework(framework);
     console.log("Detected framework: " + framework);
     if (framework === Frameworks.DOCUSAURUS) {
-        await scrapeSectionAxiosWrapper(argv, scrapeDocusaurusSection);
+        await scrapeDocusaurusSectionCommand(argv);
     }
     else if (framework === Frameworks.GITBOOK) {
         await scrapeGitbookSectionCommand(argv);
@@ -87,4 +50,13 @@ export async function scrapeSectionAutomatically(argv) {
         await scrapeSectionAxiosWrapper(argv, scrapeReadMeSection);
     }
 }
+function validateFramework(framework) {
+    if (!framework) {
+        console.log("Could not detect the framework automatically. Please use one of:");
+        console.log("scrape-page-docusaurus");
+        console.log("scrape-page-gitbook");
+        console.log("scrape-page-readme");
+        return process.exit(1);
+    }
+}
 //# sourceMappingURL=scrapeSectionCommands.js.map

package/bin/scraping/scrapeSectionCommands.js.map

@@ -1 +1 @@
-{"version":3,"file":"scrapeSectionCommands.js","sourceRoot":"","sources":["../../src/scraping/scrapeSectionCommands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"scrapeSectionCommands.js","sourceRoot":"","sources":["../../src/scraping/scrapeSectionCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,yBAAyB,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,sBAAsB,MAAM,2CAA2C,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,IAAS,EAAE,UAAe;IACxE,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,MAAM,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,IAAS;IAC5D,MAAM,6BAA6B,CACjC,IAAI,EACJ,yBAAyB,EACzB,uBAAuB,CACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,IAAS;IACzD,MAAM,6BAA6B,CACjC,IAAI,EACJ,sBAAsB,EACtB,oBAAoB,CACrB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,IAAS,EACT,SAAc,EACd,UAAe;IAEf,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEnC,MAAM,OAAO,GAAG,MAAM,YAAY,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACpB,SAAS,EAAE,cAAc;KAC1B,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,CAAC;IAChB,MAAM,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAS;IACxD,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAExC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAAC;IAEhD,IAAI,SAAS,KAAK,UAAU,CAAC,UAAU,EAAE;QACvC,MAAM,8BAA8B,CAAC,IAAI,CAAC,CAAC;KAC5C;SAAM,IAAI,SAAS,KAAK,UAAU,CAAC,OAAO,EAAE;QAC3C,MAAM,2BAA2B,CAAC,IAAI,CAAC,CAAC;KACzC;SAAM,IAAI,SAAS,KAAK,UAAU,CAAC,MAAM,EAAE;QAC1C,MAAM,yBAAyB,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC;KAC5D;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiC;IAC1D,IAAI,CAAC,SAAS,EAAE;QACd,OAAO,CAAC,GAAG,CACT,kEAAkE,CACnE,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACxB;AACH,CAAC"}

package/bin/scraping/site-scrapers/alternateGroupTitle.js

@@ -0,0 +1,9 @@
+export default function alternateGroupTitle(firstLink, pages) {
+    // Only assign titles to nested navigation menus outside a section.
+    // Others should not have a title so we can merge them into one section.
+    if (pages.length > 0) {
+        return firstLink === null || firstLink === void 0 ? void 0 : firstLink.text();
+    }
+    return "";
+}
+//# sourceMappingURL=alternateGroupTitle.js.map

package/bin/scraping/site-scrapers/alternateGroupTitle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alternateGroupTitle.js","sourceRoot":"","sources":["../../../src/scraping/site-scrapers/alternateGroupTitle.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,SAAS,EAAE,KAAK;IAC1D,mEAAmE;IACnE,wEAAwE;IACxE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE;QACpB,OAAO,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,IAAI,EAAE,CAAC;KAC1B;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/bin/scraping/site-scrapers/getLinksRecursively.js

@@ -1,4 +1,4 @@
-// Used by GitBook and ReadMe section scrapers
+// Used by Docusaurus, GitBook, and ReadMe section scrapers
 export default function getLinksRecursively(linkSections, $) {
     if (linkSections == null || linkSections.length === 0) {
         return [];
@@ -6,12 +6,17 @@ export default function getLinksRecursively(linkSections, $) {
     return linkSections
         .map((i, s) => {
         const subsection = $(s);
-        const link = subsection.children().first();
+        let link = subsection.children().first();
+        if (!link.attr("href")) {
+            // Docusaurus nests the <a> inside a <div>
+            link = link.find("a[href]").first();
+        }
         const linkHref = link.attr("href");
         // Skip missing links. For example, GitBook uses
         // empty divs are used for styling a line beside the nav.
         // Skip external links until Mintlify supports them
         if (!linkHref ||
+            linkHref === "#" ||
             linkHref.startsWith("https://") ||
             linkHref.startsWith("http://")) {
             return undefined;