apidocly 1.0.3

package/lib/parser/languages.js

@@ -0,0 +1,57 @@
+const COMMENT_PATTERNS = {
+  js: {
+    block: /\/\*\*[\s\S]*?\*\//g,
+    linePrefix: /^\s*\*\s?/gm,
+    start: '/**',
+    end: '*/'
+  },
+  php: {
+    block: /\/\*\*[\s\S]*?\*\//g,
+    linePrefix: /^\s*\*\s?/gm,
+    start: '/**',
+    end: '*/'
+  },
+  python: {
+    block: /"""[\s\S]*?"""|\'\'\'[\s\S]*?\'\'\'/g,
+    linePrefix: /^\s*/gm,
+    start: '"""',
+    end: '"""'
+  }
+};
+
+function extractCommentBlocks(content, language) {
+  const pattern = COMMENT_PATTERNS[language];
+  if (!pattern) return [];
+
+  const blocks = [];
+  const matches = content.match(pattern.block);
+
+  if (!matches) return [];
+
+  for (const match of matches) {
+    if (!match.includes('@api')) continue;
+
+    let cleaned = match;
+
+    if (language === 'js' || language === 'php') {
+      cleaned = match
+        .replace(/^\/\*\*\s*/, '')
+        .replace(/\s*\*\/$/, '')
+        .replace(pattern.linePrefix, '')
+        .trim();
+    } else if (language === 'python') {
+      cleaned = match
+        .replace(/^"""\s*/, '')
+        .replace(/\s*"""$/, '')
+        .replace(/^'''\s*/, '')
+        .replace(/\s*'''$/, '')
+        .trim();
+    }
+
+    blocks.push(cleaned);
+  }
+
+  return blocks;
+}
+
+module.exports = { extractCommentBlocks, COMMENT_PATTERNS };

package/lib/utils/config-loader.js

@@ -0,0 +1,67 @@
+const fs = require('fs');
+const path = require('path');
+
+const DEFAULT_CONFIG = {
+  name: 'API Documentation',
+  version: '1.0.0',
+  description: '',
+  title: 'API Documentation',
+  url: '',
+  sampleUrl: '',
+  environments: [],
+  template: {
+    withCompare: true,
+    withGenerator: true
+  },
+  password: null,
+  passwordMessage: 'Enter password to view API documentation',
+  header: null,
+  footer: null
+};
+
+const CONFIG_FILES = [
+  'apidocly.json',
+];
+
+function loadConfig(configPath, inputPath) {
+  let config = { ...DEFAULT_CONFIG };
+  let configDir = inputPath;
+
+  if (configPath) {
+    if (fs.existsSync(configPath)) {
+      const userConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+      config = { ...config, ...userConfig };
+      configDir = path.dirname(configPath);
+    } else {
+      throw new Error(`Config file not found: ${configPath}`);
+    }
+  } else {
+    for (const filename of CONFIG_FILES) {
+      const filePath = path.join(inputPath, filename);
+      if (fs.existsSync(filePath)) {
+        const userConfig = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        config = { ...config, ...userConfig };
+        configDir = inputPath;
+        break;
+      }
+    }
+  }
+
+  if (config.header && config.header.filename) {
+    const headerPath = path.join(configDir, config.header.filename);
+    if (fs.existsSync(headerPath)) {
+      config.header.content = fs.readFileSync(headerPath, 'utf8');
+    }
+  }
+
+  if (config.footer && config.footer.filename) {
+    const footerPath = path.join(configDir, config.footer.filename);
+    if (fs.existsSync(footerPath)) {
+      config.footer.content = fs.readFileSync(footerPath, 'utf8');
+    }
+  }
+
+  return config;
+}
+
+module.exports = { loadConfig, DEFAULT_CONFIG };

package/lib/utils/file-scanner.js

@@ -0,0 +1,64 @@
+const fs = require('fs');
+const path = require('path');
+const { glob } = require('glob');
+
+const SUPPORTED_EXTENSIONS = {
+  js: ['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs'],
+  php: ['.php'],
+  python: ['.py']
+};
+
+const ALL_EXTENSIONS = Object.values(SUPPORTED_EXTENSIONS).flat();
+
+async function scanFiles(inputPath, options = {}) {
+  const { verbose } = options;
+  const files = [];
+
+  const stat = fs.statSync(inputPath);
+
+  if (stat.isFile()) {
+    const ext = path.extname(inputPath).toLowerCase();
+    if (ALL_EXTENSIONS.includes(ext)) {
+      files.push(inputPath);
+    }
+  } else if (stat.isDirectory()) {
+    const patterns = ALL_EXTENSIONS.map(ext => `**/*${ext}`);
+
+    for (const pattern of patterns) {
+      const matches = await glob(pattern, {
+        cwd: inputPath,
+        absolute: true,
+        ignore: [
+          '**/node_modules/**',
+          '**/vendor/**',
+          '**/.git/**',
+          '**/dist/**',
+          '**/build/**',
+          '**/__pycache__/**',
+          '**/venv/**'
+        ]
+      });
+      files.push(...matches);
+    }
+  }
+
+  const uniqueFiles = [...new Set(files)];
+
+  if (verbose) {
+    console.log(`  Found ${uniqueFiles.length} source files`);
+  }
+
+  return uniqueFiles;
+}
+
+function getLanguage(filePath) {
+  const ext = path.extname(filePath).toLowerCase();
+
+  if (SUPPORTED_EXTENSIONS.js.includes(ext)) return 'js';
+  if (SUPPORTED_EXTENSIONS.php.includes(ext)) return 'php';
+  if (SUPPORTED_EXTENSIONS.python.includes(ext)) return 'python';
+
+  return null;
+}
+
+module.exports = { scanFiles, getLanguage, SUPPORTED_EXTENSIONS };

package/lib/utils/minifier.js

@@ -0,0 +1,106 @@
+/**
+ * CSS/JS Minifier using Terser
+ * Terser provides reliable minification and obfuscation with proper scope analysis
+ */
+
+const { minify } = require('terser');
+
+/**
+ * Minify CSS
+ */
+function minifyCSS(css) {
+  return css
+    .replace(/\/\*[\s\S]*?\*\//g, '')
+    .replace(/[\n\r\t]/g, '')
+    .replace(/\s*([{}:;,>~+])\s*/g, '$1')
+    .replace(/\s{2,}/g, ' ')
+    .replace(/;}/g, '}')
+    .trim();
+}
+
+/**
+ * Minify JavaScript using Terser (synchronous wrapper)
+ */
+function minifyJS(js) {
+  // Terser is async, but we need sync for compatibility
+  // Use basic minification for sync context
+  return js
+    .replace(/\/\/[^\n]*/g, '') // Remove single-line comments
+    .replace(/\/\*[\s\S]*?\*\//g, '') // Remove multi-line comments
+    .replace(/\s+/g, ' ') // Collapse whitespace
+    .replace(/\s*([{}:;,=()[\]<>!&|?+\-*\/])\s*/g, '$1') // Remove space around operators
+    .replace(/;\s*}/g, '}') // Remove trailing semicolons
+    .trim();
+}
+
+/**
+ * Minify JSON (for api_data.js)
+ */
+function minifyJSON(obj) {
+  return JSON.stringify(obj);
+}
+
+/**
+ * Minify and obfuscate JavaScript using Terser (async)
+ * Returns a Promise
+ */
+async function minifyAndObfuscateJSAsync(js) {
+  try {
+    const result = await minify(js, {
+      compress: {
+        dead_code: true,
+        drop_debugger: true,
+        conditionals: true,
+        evaluate: true,
+        booleans: true,
+        loops: true,
+        unused: true,
+        hoist_funs: true,
+        keep_fargs: false,
+        hoist_vars: false,
+        if_return: true,
+        join_vars: true,
+        side_effects: true,
+        warnings: false
+      },
+      mangle: {
+        toplevel: false,  // Don't mangle top-level names (preserves window.* functions)
+        reserved: [
+          // Preserve API data variables
+          'apiData', 'apiDataEncrypted', 'apiDataAuth', 'apiVersions',
+          // Preserve global functions exposed via window.*
+          'downloadOpenAPI', 'downloadPostmanCollection', 'downloadInsomniaCollection',
+          'switchCodeSample', 'copyCodeSample', 'toggleEndpoint', 'toggleGroup',
+          'showEndpoint', 'goBack', 'hashChange'
+        ]
+      },
+      format: {
+        comments: false
+      },
+      sourceMap: false
+    });
+
+    return result.code || js;
+  } catch (error) {
+    console.warn('Terser minification failed, using basic minification:', error.message);
+    return minifyJS(js);
+  }
+}
+
+/**
+ * Synchronous wrapper for minifyAndObfuscateJS
+ * Uses basic minification (Terser is async-only)
+ */
+function minifyAndObfuscateJS(js) {
+  // For sync usage, just do basic minification
+  // The async version should be preferred
+  return minifyJS(js);
+}
+
+module.exports = {
+  minifyCSS,
+  minifyJS,
+  minifyJSON,
+  minifyAndObfuscateJS,
+  minifyAndObfuscateJSAsync
+};

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "apidocly",
+  "version": "1.0.3",
+  "description": "API documentation generator with beautiful dark UI, password protection, and OpenAPI/Rest client export.",
+  "main": "lib/index.js",
+  "bin": {
+    "apidocly": "bin/apidocly.js"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\" && exit 0"
+  },
+  "keywords": [
+    "api",
+    "documentation",
+    "generator",
+    "apidoc",
+    "openapi",
+    "swagger",
+    "dark-mode",
+    "rest-api",
+    "api-docs",
+    "jsdoc",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "homepage": "https://apidocly.com",
+  "bugs": {
+    "url": "https://apidocly.com"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "glob": "11.1.0",
+    "terser": "^5.37.0"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "template",
+    "README.md",
+    "LICENSE"
+  ]
+}