@mintlify/previewing 4.0.1017 → 4.0.1018

package/export-scripts/serve.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+// Serves the exported docs folder as a local static site. This is shipped with the export zip from `mint export`.
+const http = require('http');
+const fs = require('fs');
+const path = require('path');
+const { execFile } = require('child_process');
+
+const PORT = process.env.PORT || 3000;
+const DIR = __dirname;
+
+const MIME_TYPES = {
+  '.html': 'text/html',
+  '.css': 'text/css',
+  '.js': 'application/javascript',
+  '.json': 'application/json',
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon',
+  '.woff': 'font/woff',
+  '.woff2': 'font/woff2',
+  '.ttf': 'font/ttf',
+  '.webp': 'image/webp',
+  '.mp4': 'video/mp4',
+  '.webm': 'video/webm',
+  '.xml': 'application/xml',
+  '.txt': 'text/plain',
+};
+
+function openInBrowser(url) {
+  let command = 'xdg-open';
+  switch (process.platform) {
+    case 'darwin':
+      command = 'open';
+      break;
+    case 'win32':
+      command = 'explorer.exe';
+      break;
+    default:
+      command = 'xdg-open';
+  }
+
+  execFile(command, [url], () => undefined);
+}
+
+function resolveFile(urlPath) {
+  const filePath = path.resolve(DIR, urlPath.replace(/^\/+/, ''));
+  if (!filePath.startsWith(DIR + path.sep) && filePath !== DIR) return undefined;
+  const candidates = [filePath, path.join(filePath, 'index.html'), filePath + '.html'];
+  return candidates.find((c) => fs.existsSync(c) && fs.statSync(c).isFile());
+}
+
+http
+  .createServer((req, res) => {
+    let urlPath;
+    try {
+      const rawPath = (req.url || '/').split('?')[0];
+      urlPath = decodeURIComponent(rawPath);
+    } catch {
+      res.writeHead(404, { 'Content-Type': 'text/plain' });
+      res.end('404 Not Found');
+      return;
+    }
+
+    const file = resolveFile(urlPath);
+
+    if (file) {
+      const ext = path.extname(file).toLowerCase();
+      res.writeHead(200, { 'Content-Type': MIME_TYPES[ext] || 'application/octet-stream' });
+      fs.createReadStream(file).pipe(res);
+    } else {
+      res.writeHead(404, { 'Content-Type': 'text/plain' });
+      res.end('404 Not Found');
+    }
+  })
+  .listen(PORT, () => {
+    const url = 'http://localhost:' + PORT;
+    console.log('Serving docs at ' + url);
+    openInBrowser(url);
+  });

package/export-scripts/start-docs.bat

@@ -0,0 +1,10 @@
+@echo off
+cd /d "%~dp0"
+where node >nul 2>nul
+if %errorlevel%==0 (
+  node serve.js
+) else (
+  echo Error: Node.js is required to view these docs.
+  echo Install Node.js from https://nodejs.org
+  pause
+)

package/export-scripts/start-docs.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+cd "$(dirname "$0")"
+if command -v node &> /dev/null; then
+  node serve.js
+else
+  echo "Error: Node.js is required to view these docs."
+  echo "Install Node.js from https://nodejs.org"
+  read -p "Press Enter to exit..."
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/previewing",
-  "version": "4.0.1017",
+  "version": "4.0.1018",
   "description": "Preview Mintlify docs locally",
   "engines": {
     "node": ">=18.0.0"
@@ -28,7 +28,8 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "export-scripts"
   ],
   "scripts": {
     "prepare": "npm run build",
@@ -46,6 +47,7 @@
     "@mintlify/common": "1.0.818",
     "@mintlify/prebuild": "1.0.959",
     "@mintlify/validation": "0.1.643",
+    "adm-zip": "0.5.16",
     "better-opn": "3.0.2",
     "chalk": "5.2.0",
     "chokidar": "3.5.3",
@@ -86,5 +88,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "87821bd4fd4fd84aea3932e8ae0928bd15dc3c28"
+  "gitHead": "689313194fd46d5dd2211b59062a041ba91f3981"
 }