md-lv 1.0.0

package/src/routes/directory.js

@@ -0,0 +1,110 @@
+import { Router } from 'express';
+import fs from 'fs/promises';
+import path from 'path';
+import { validatePath } from '../utils/path.js';
+import { getIconClass, formatFileSize } from '../utils/icons.js';
+import { renderTemplate } from '../utils/template.js';
+import { generateBreadcrumbs } from '../utils/navigation.js';
+import { escapeHtml } from '../utils/html.js';
+
+const router = Router();
+
+/**
+ * ディレクトリ一覧表示ルート
+ */
+router.get(/^\/.*/, async (req, res, next) => {
+  try {
+    const requestPath = req.path;
+    const docRoot = req.app.get('docRoot');
+
+    let dirPath;
+    try {
+      dirPath = validatePath(requestPath, docRoot);
+    } catch (error) {
+      if (error.code === 'ETRAVERSAL') {
+        return res.status(403).send('Access denied');
+      }
+      throw error;
+    }
+
+    // ディレクトリ存在確認
+    let stat;
+    try {
+      stat = await fs.stat(dirPath);
+    } catch {
+      return next(); // 存在しない場合は次のハンドラへ
+    }
+
+    if (!stat.isDirectory()) {
+      return next(); // ディレクトリでなければ次のハンドラへ
+    }
+
+    // ディレクトリ内容を取得
+    const entries = await fs.readdir(dirPath, { withFileTypes: true });
+
+    // エントリー情報を取得（サイズなど）
+    const entriesWithInfo = await Promise.all(
+      entries.map(async (entry) => {
+        const fullPath = path.join(dirPath, entry.name);
+        let size = 0;
+        let mtime = new Date();
+
+        try {
+          const entryStat = await fs.stat(fullPath);
+          size = entryStat.size;
+          mtime = entryStat.mtime;
+        } catch {
+          // エラーは無視
+        }
+
+        return {
+          name: entry.name,
+          isDirectory: entry.isDirectory(),
+          size,
+          mtime
+        };
+      })
+    );
+
+    // ソート（ディレクトリ優先、アルファベット順）
+    const sorted = entriesWithInfo.sort((a, b) => {
+      if (a.isDirectory && !b.isDirectory) return -1;
+      if (!a.isDirectory && b.isDirectory) return 1;
+      return a.name.localeCompare(b.name);
+    });
+
+    // 隠しファイルをフィルタ（オプション）
+    const visible = sorted.filter(entry => !entry.name.startsWith('.'));
+
+    // HTML リスト生成
+    const listHtml = visible.map(entry => {
+      const isDir = entry.isDirectory;
+      const href = path.join(requestPath, entry.name) + (isDir ? '/' : '');
+      const iconClass = getIconClass(entry.name, isDir);
+      const sizeText = isDir ? '-' : formatFileSize(entry.size);
+
+      return `<li class="${iconClass}">
+        <a href="${escapeHtml(href)}">${escapeHtml(entry.name)}${isDir ? '/' : ''}</a>
+        <span class="size">${sizeText}</span>
+      </li>`;
+    }).join('\n');
+
+    // 親ディレクトリへのリンク（ルート以外）
+    const parentLink = requestPath !== '/'
+      ? `<li class="folder parent"><a href="${path.dirname(requestPath)}/">..</a><span class="size">-</span></li>\n`
+      : '';
+
+    const html = renderTemplate('page', {
+      title: `Index of ${requestPath}`,
+      content: `<h1>Index of ${escapeHtml(requestPath)}</h1>
+                <ul class="directory-listing">${parentLink}${listHtml}</ul>`,
+      breadcrumbs: generateBreadcrumbs(requestPath)
+    });
+
+    res.type('html').send(html);
+  } catch (error) {
+    next(error);
+  }
+});
+
+export default router;

package/src/routes/markdown.js

@@ -0,0 +1,53 @@
+import { Router } from 'express';
+import fs from 'fs/promises';
+import path from 'path';
+import { validatePath } from '../utils/path.js';
+import { renderTemplate } from '../utils/template.js';
+import { escapeHtml } from '../utils/html.js';
+import { generateBreadcrumbs } from '../utils/navigation.js';
+
+const router = Router();
+
+/**
+ * Markdown ファイルのレンダリングルート
+ * .md ファイルへのリクエストを処理
+ */
+router.get(/.*\.md$/i, async (req, res, next) => {
+  try {
+    const requestPath = req.path;
+    const docRoot = req.app.get('docRoot');
+
+    // パス検証（パストラバーサル防止）
+    const filePath = validatePath(requestPath, docRoot);
+
+    // ファイル存在確認
+    try {
+      await fs.access(filePath);
+    } catch {
+      return res.status(404).send('File not found');
+    }
+
+    // ファイル読み込み
+    const content = await fs.readFile(filePath, 'utf-8');
+
+    // テンプレートにMarkdownを埋め込み（クライアント側でレンダリング）
+    const html = renderTemplate('page', {
+      title: path.basename(filePath),
+      content: `<div id="markdown-source" style="display:none">${escapeHtml(content)}</div>
+                <div id="markdown-rendered"></div>`,
+      breadcrumbs: generateBreadcrumbs(requestPath)
+    });
+
+    res.type('html').send(html);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      res.status(404).send('File not found');
+    } else if (error.code === 'ETRAVERSAL') {
+      res.status(403).send('Access denied');
+    } else {
+      next(error);
+    }
+  }
+});
+
+export default router;

package/src/routes/raw.js

@@ -0,0 +1,74 @@
+import { Router } from 'express';
+import fs from 'fs/promises';
+import path from 'path';
+import { validatePath } from '../utils/path.js';
+import { renderTemplate } from '../utils/template.js';
+import { getLanguageFromExtension, isSupportedExtension } from '../utils/language.js';
+import { escapeHtml } from '../utils/html.js';
+import { generateBreadcrumbs } from '../utils/navigation.js';
+
+const router = Router();
+
+/**
+ * Raw コード表示ルート
+ * 非 Markdown ファイルをシンタックスハイライト付きで表示
+ */
+router.get(/^\/.*/, async (req, res, next) => {
+  try {
+    const requestPath = req.path;
+    const ext = path.extname(requestPath).toLowerCase();
+
+    // Markdown ファイルは除外（markdown router が処理）
+    if (ext === '.md') {
+      return next();
+    }
+
+    // サポートされていない拡張子は次のハンドラへ
+    if (!isSupportedExtension(ext)) {
+      return next();
+    }
+
+    const docRoot = req.app.get('docRoot');
+    let filePath;
+
+    try {
+      filePath = validatePath(requestPath, docRoot);
+    } catch (error) {
+      if (error.code === 'ETRAVERSAL') {
+        return res.status(403).send('Access denied');
+      }
+      throw error;
+    }
+
+    // ファイル存在確認
+    let stat;
+    try {
+      stat = await fs.stat(filePath);
+    } catch {
+      return next(); // 存在しない場合は次のハンドラへ
+    }
+
+    // ディレクトリの場合は次のハンドラへ
+    if (stat.isDirectory()) {
+      return next();
+    }
+
+    // ファイル読み込み
+    const content = await fs.readFile(filePath, 'utf-8');
+    const language = getLanguageFromExtension(ext);
+    const fileName = path.basename(filePath);
+
+    const html = renderTemplate('page', {
+      title: fileName,
+      content: `<h1>${escapeHtml(fileName)}</h1>
+                <pre><code class="language-${language}">${escapeHtml(content)}</code></pre>`,
+      breadcrumbs: generateBreadcrumbs(requestPath)
+    });
+
+    res.type('html').send(html);
+  } catch (error) {
+    next(error);
+  }
+});
+
+export default router;

package/src/server.js

@@ -0,0 +1,61 @@
+import express from 'express';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import markdownRouter from './routes/markdown.js';
+import rawRouter from './routes/raw.js';
+import directoryRouter from './routes/directory.js';
+import apiRouter from './routes/api.js';
+import { securityHeaders, pathTraversalGuard } from './middleware/security.js';
+import { notFoundHandler, errorHandler } from './middleware/error.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * Express サーバーを作成
+ * @param {object} options - サーバーオプション
+ * @param {string} options.dir - ドキュメントルート
+ * @returns {express.Application} - Express アプリケーション
+ */
+export function createServer(options = {}) {
+  const app = express();
+
+  // ドキュメントルートの設定
+  const docRoot = path.resolve(options.dir || '.');
+  app.set('docRoot', docRoot);
+
+  // セキュリティミドルウェア（最初に登録）
+  app.use(securityHeaders);
+  app.use(pathTraversalGuard);
+
+  // 静的ファイル配信（public ディレクトリ）
+  const publicDir = path.join(__dirname, '..', 'public');
+  app.use('/static', express.static(publicDir));
+
+  // ヘルスチェック
+  app.get('/health', (req, res) => {
+    res.json({
+      status: 'ok',
+      timestamp: new Date().toISOString(),
+      docRoot: docRoot
+    });
+  });
+
+  // API ルート
+  app.use(apiRouter);
+
+  // Markdown ルート（.md ファイル）
+  app.use(markdownRouter);
+
+  // Raw コード表示ルート（.js, .py 等）
+  app.use(rawRouter);
+
+  // ディレクトリ一覧ルート
+  app.use(directoryRouter);
+
+  // エラーハンドラ（最後に登録）
+  app.use(notFoundHandler);
+  app.use(errorHandler);
+
+  return app;
+}

package/src/utils/html.js

@@ -0,0 +1,37 @@
+/**
+ * HTML 特殊文字をエスケープ
+ * @param {string} str - エスケープ対象文字列
+ * @returns {string} - エスケープ済み文字列
+ */
+export function escapeHtml(str) {
+  if (typeof str !== 'string') {
+    return '';
+  }
+  const map = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#039;'
+  };
+  return str.replace(/[&<>"']/g, c => map[c]);
+}
+
+/**
+ * HTML エスケープを解除
+ * @param {string} str - エスケープ解除対象文字列
+ * @returns {string} - エスケープ解除済み文字列
+ */
+export function unescapeHtml(str) {
+  if (typeof str !== 'string') {
+    return '';
+  }
+  const map = {
+    '&amp;': '&',
+    '&lt;': '<',
+    '&gt;': '>',
+    '&quot;': '"',
+    '&#039;': "'"
+  };
+  return str.replace(/&amp;|&lt;|&gt;|&quot;|&#039;/g, m => map[m]);
+}

package/src/utils/icons.js

@@ -0,0 +1,79 @@
+/**
+ * ファイル名から適切なアイコンクラスを取得
+ * @param {string} fileName - ファイル名
+ * @param {boolean} isDirectory - ディレクトリかどうか
+ * @returns {string} - CSS クラス名
+ */
+export function getIconClass(fileName, isDirectory) {
+  if (isDirectory) {
+    return 'folder';
+  }
+
+  const ext = fileName.split('.').pop()?.toLowerCase() || '';
+
+  // 拡張子に基づくアイコンクラス
+  const iconMap = {
+    // Markdown
+    'md': 'file-md',
+    'markdown': 'file-md',
+
+    // Code
+    'js': 'file-code',
+    'ts': 'file-code',
+    'jsx': 'file-code',
+    'tsx': 'file-code',
+    'py': 'file-code',
+    'rb': 'file-code',
+    'java': 'file-code',
+    'c': 'file-code',
+    'cpp': 'file-code',
+    'h': 'file-code',
+    'go': 'file-code',
+    'rs': 'file-code',
+
+    // Web
+    'html': 'file-web',
+    'htm': 'file-web',
+    'css': 'file-web',
+    'scss': 'file-web',
+    'less': 'file-web',
+
+    // Data
+    'json': 'file-data',
+    'xml': 'file-data',
+    'yaml': 'file-data',
+    'yml': 'file-data',
+    'toml': 'file-data',
+
+    // Images
+    'png': 'file-image',
+    'jpg': 'file-image',
+    'jpeg': 'file-image',
+    'gif': 'file-image',
+    'svg': 'file-image',
+    'webp': 'file-image',
+
+    // Documents
+    'pdf': 'file-doc',
+    'doc': 'file-doc',
+    'docx': 'file-doc',
+    'txt': 'file-text'
+  };
+
+  return iconMap[ext] || 'file';
+}
+
+/**
+ * ファイルサイズを人間が読みやすい形式に変換
+ * @param {number} bytes - バイト数
+ * @returns {string} - フォーマット済みサイズ
+ */
+export function formatFileSize(bytes) {
+  if (bytes === 0) return '0 B';
+
+  const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+  const k = 1024;
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+
+  return parseFloat((bytes / Math.pow(k, i)).toFixed(1)) + ' ' + units[i];
+}

package/src/utils/language.js

@@ -0,0 +1,102 @@
+/**
+ * ファイル拡張子から highlight.js の言語名を取得
+ * @param {string} ext - ファイル拡張子（.付き）
+ * @returns {string} - highlight.js の言語名
+ */
+export function getLanguageFromExtension(ext) {
+  const languageMap = {
+    // JavaScript
+    '.js': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    '.jsx': 'javascript',
+
+    // TypeScript
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+
+    // Web
+    '.html': 'html',
+    '.htm': 'html',
+    '.css': 'css',
+    '.scss': 'scss',
+    '.less': 'less',
+
+    // Data formats
+    '.json': 'json',
+    '.xml': 'xml',
+    '.yaml': 'yaml',
+    '.yml': 'yaml',
+    '.toml': 'toml',
+
+    // Python
+    '.py': 'python',
+    '.pyw': 'python',
+
+    // Ruby
+    '.rb': 'ruby',
+    '.erb': 'erb',
+
+    // Go
+    '.go': 'go',
+
+    // Rust
+    '.rs': 'rust',
+
+    // Java
+    '.java': 'java',
+
+    // C/C++
+    '.c': 'c',
+    '.h': 'c',
+    '.cpp': 'cpp',
+    '.hpp': 'cpp',
+    '.cc': 'cpp',
+    '.cxx': 'cpp',
+
+    // Shell
+    '.sh': 'bash',
+    '.bash': 'bash',
+    '.zsh': 'zsh',
+    '.fish': 'shell',
+
+    // SQL
+    '.sql': 'sql',
+
+    // PHP
+    '.php': 'php',
+
+    // Markdown (fallback for non-.md markdown)
+    '.markdown': 'markdown',
+
+    // Plain text
+    '.txt': 'plaintext',
+    '.text': 'plaintext',
+    '.log': 'plaintext'
+  };
+
+  return languageMap[ext.toLowerCase()] || 'plaintext';
+}
+
+/**
+ * ファイル拡張子がサポートされているかチェック
+ * @param {string} ext - ファイル拡張子（.付き）
+ * @returns {boolean}
+ */
+export function isSupportedExtension(ext) {
+  const supportedExtensions = [
+    '.js', '.mjs', '.cjs', '.jsx',
+    '.ts', '.tsx',
+    '.html', '.htm', '.css', '.scss', '.less',
+    '.json', '.xml', '.yaml', '.yml', '.toml',
+    '.py', '.pyw',
+    '.rb', '.erb',
+    '.go', '.rs', '.java',
+    '.c', '.h', '.cpp', '.hpp', '.cc', '.cxx',
+    '.sh', '.bash', '.zsh', '.fish',
+    '.sql', '.php',
+    '.txt', '.text', '.log'
+  ];
+
+  return supportedExtensions.includes(ext.toLowerCase());
+}

package/src/utils/logger.js

@@ -0,0 +1,81 @@
+/**
+ * ログレベル
+ */
+const LOG_LEVELS = {
+  DEBUG: 0,
+  INFO: 1,
+  WARN: 2,
+  ERROR: 3,
+  SILENT: 4
+};
+
+/**
+ * 統一ロガークラス
+ */
+class Logger {
+  constructor(level = 'INFO') {
+    this.level = LOG_LEVELS[level.toUpperCase()] ?? LOG_LEVELS.INFO;
+    this.prefix = '[mdv]';
+  }
+
+  /**
+   * ログレベルを設定
+   * @param {string} level - ログレベル名
+   */
+  setLevel(level) {
+    this.level = LOG_LEVELS[level.toUpperCase()] ?? LOG_LEVELS.INFO;
+  }
+
+  /**
+   * タイムスタンプを生成
+   * @returns {string}
+   */
+  _timestamp() {
+    return new Date().toISOString();
+  }
+
+  /**
+   * ログ出力の共通処理
+   * @param {string} levelName - レベル名
+   * @param {string} message - メッセージ
+   * @param {object} meta - メタデータ
+   * @param {function} outputFn - 出力関数
+   */
+  _log(levelName, message, meta, outputFn) {
+    const timestamp = this._timestamp();
+    const metaStr = meta && Object.keys(meta).length > 0
+      ? ' ' + JSON.stringify(meta)
+      : '';
+    outputFn(`${timestamp} ${this.prefix} [${levelName}] ${message}${metaStr}`);
+  }
+
+  debug(message, meta = {}) {
+    if (this.level <= LOG_LEVELS.DEBUG) {
+      this._log('DEBUG', message, meta, console.log);
+    }
+  }
+
+  info(message, meta = {}) {
+    if (this.level <= LOG_LEVELS.INFO) {
+      this._log('INFO', message, meta, console.log);
+    }
+  }
+
+  warn(message, meta = {}) {
+    if (this.level <= LOG_LEVELS.WARN) {
+      this._log('WARN', message, meta, console.warn);
+    }
+  }
+
+  error(message, meta = {}) {
+    if (this.level <= LOG_LEVELS.ERROR) {
+      this._log('ERROR', message, meta, console.error);
+    }
+  }
+}
+
+// シングルトンインスタンスをエクスポート
+export const logger = new Logger(process.env.LOG_LEVEL || 'INFO');
+
+// クラスもエクスポート（テスト用）
+export { Logger, LOG_LEVELS };

package/src/utils/navigation.js

@@ -0,0 +1,41 @@
+/**
+ * パスからブレッドクラム HTML を生成
+ * @param {string} requestPath - リクエストパス
+ * @returns {string} - ブレッドクラム HTML
+ */
+export function generateBreadcrumbs(requestPath) {
+  const parts = requestPath.split('/').filter(Boolean);
+  const breadcrumbs = [{ href: '/', text: 'Home' }];
+
+  let currentPath = '';
+  for (const part of parts) {
+    currentPath += `/${part}`;
+    breadcrumbs.push({ href: currentPath, text: decodeURIComponent(part) });
+  }
+
+  return breadcrumbs
+    .map((crumb, index) => {
+      const isLast = index === breadcrumbs.length - 1;
+      if (isLast) {
+        return `<span class="current">${escapeHtml(crumb.text)}</span>`;
+      }
+      return `<a href="${crumb.href}">${escapeHtml(crumb.text)}</a>`;
+    })
+    .join(' / ');
+}
+
+/**
+ * HTML 特殊文字をエスケープ
+ * @param {string} str - エスケープ対象文字列
+ * @returns {string} - エスケープ済み文字列
+ */
+function escapeHtml(str) {
+  const map = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&#039;'
+  };
+  return str.replace(/[&<>"']/g, c => map[c]);
+}