vite-plugin-sri4 2.0.0 → 3.1.0

package/dist/index.js

@@ -2,29 +2,9 @@ import { createHash } from 'crypto';
 import path from 'path';
 import fetch from 'cross-fetch';
 
-// Constants definition
-const VITE_INTERNAL_ANALYSIS_PLUGIN = 'vite:build-import-analysis';
-const DEFAULT_TIMEOUT = 5000;
-const DEFAULT_HASH_ALGORITHM = 'sha384';
-const DEFAULT_PLUGIN_NAME = 'vite-plugin-sri4';
-
-// Optimized regex patterns for better readability and efficiency
-const HTML_PATTERNS = {
-  script: {
-    regex: /<script\b[^>]*?\bsrc\s*=\s*["']([^"']+)["'][^>]*><\/script>/g,
-    endOffset: 10
-  },
-  stylesheet: {
-    regex: /<link\b[^>]*?\brel\s*=\s*["']stylesheet["'][^>]*?\bhref\s*=\s*["']([^"']+)["'][^>]*>/g,
-    endOffset: 1
-  },
-  modulepreload: {
-    regex: /<link\b[^>]*?\brel\s*=\s*["']modulepreload["'][^>]*?\bhref\s*=\s*["']([^"']+)["'][^>]*>/g,
-    endOffset: 1
-  }
-};
-
-// Extended caching mechanism with expiration time
+/**
+ * Extended caching mechanism with expiration time
+ */
 class ResourceCache {
   constructor(ttl = 3600000) { // Default cache for 1 hour
     this.cache = new Map();
@@ -60,11 +40,35 @@ class ResourceCache {
   }
 }
 
-const urlSupportCache = new ResourceCache();
-const resourceCache = new ResourceCache();
+/**
+ * Cache manager for plugin instances
+ */
+class CacheManager {
+  constructor() {
+    this.urlSupportCache = new ResourceCache();
+    this.resourceCache = new ResourceCache();
+  }
 
-// Check if URL is from a bypass domain
-function isUrlFromBypassDomain(url, bypassDomains = []) {
+  getUrlSupportCache() {
+    return this.urlSupportCache
+  }
+
+  getResourceCache() {
+    return this.resourceCache
+  }
+
+  clearAll() {
+    this.urlSupportCache.clear();
+    this.resourceCache.clear();
+  }
+}
+
+const DEFAULT_TIMEOUT = 5000;
+
+/**
+ * Check if URL is from a bypass domain
+ */
+function isUrlFromBypassDomain(url, bypassDomains = [], logger = null) {
   if (!url || typeof url !== 'string' || !url.startsWith('http')) return false
 
   try {
@@ -73,13 +77,17 @@ function isUrlFromBypassDomain(url, bypassDomains = []) {
       urlObj.hostname === domain || urlObj.hostname.endsWith(`.${domain}`)
     )
   } catch (error) {
-    console.warn(`[${DEFAULT_PLUGIN_NAME}] Invalid URL: ${url}`, error);
+    if (logger) {
+      logger.warn(`Invalid URL: ${url}`, error);
+    }
     return false
   }
 }
 
-// Resource check with retry mechanism
-async function checkResourceSupport(url, retries = 2) {
+/**
+ * Resource check with retry mechanism
+ */
+async function checkResourceSupport(url, urlSupportCache, logger = null, retries = 2) {
   if (urlSupportCache.has(url)) {
     return urlSupportCache.get(url)
   }
@@ -104,7 +112,9 @@ async function checkResourceSupport(url, retries = 2) {
     } catch (error) {
       lastError = error;
       if (error.name === 'AbortError') {
-        console.warn(`[${DEFAULT_PLUGIN_NAME}] Resource check timed out: ${url}`);
+        if (logger) {
+          logger.warn(`Resource check timed out: ${url}`);
+        }
         break // Don't retry timeouts
       }
 
@@ -115,13 +125,17 @@ async function checkResourceSupport(url, retries = 2) {
     }
   }
 
-  console.warn(`[${DEFAULT_PLUGIN_NAME}] Failed to check resource support: ${url}`, lastError);
+  if (logger) {
+    logger.warn(`Failed to check resource support: ${url}`, lastError);
+  }
   urlSupportCache.set(url, false);
   return false
 }
 
-// Optimized resource fetching function with retry mechanism and caching
-async function fetchResource(url, retries = 1) {
+/**
+ * Optimized resource fetching function with retry mechanism and caching
+ */
+async function fetchResource(url, resourceCache, logger = null, retries = 1) {
   // Check cache
   if (resourceCache.has(url)) {
     return resourceCache.get(url)
@@ -146,7 +160,9 @@ async function fetchResource(url, retries = 1) {
     } catch (error) {
       lastError = error;
       if (error.name === 'AbortError') {
-        console.warn(`[${DEFAULT_PLUGIN_NAME}] Resource fetch timed out: ${url}`);
+        if (logger) {
+          logger.warn(`Resource fetch timed out: ${url}`);
+        }
         break // Don't retry timeouts
       }
 
@@ -156,144 +172,373 @@ async function fetchResource(url, retries = 1) {
     }
   }
 
-  console.warn(`[${DEFAULT_PLUGIN_NAME}] Failed to fetch external resource: ${url}`, lastError);
+  if (logger) {
+    logger.warn(`Failed to fetch external resource: ${url}`, lastError);
+  }
   return null
 }
 
-function createTransformer(options, config) {
-  const {
-    ignoreMissingAsset,
-    bypassDomains,
-    hashAlgorithm = DEFAULT_HASH_ALGORITHM
-  } = options;
-
-  // Improved method for getting bundle keys
-  const getBundleKey = (htmlPath, url) => {
-    // Handle absolute path URLs
-    if (url.startsWith('/')) {
-      // Remove leading slash to match keys in bundle
-      return url.substring(1)
-    }
-
-    // Handle relative paths (when config.base is relative)
-    if (config.base === './' || config.base === '') {
-      return path.posix.resolve(path.posix.dirname(htmlPath), url)
-    }
+/**
+ * Improved method for getting bundle keys
+ */
+function getBundleKey(htmlPath, url, config) {
+  // Handle absolute path URLs
+  if (url.startsWith('/')) {
+    // Remove leading slash to match keys in bundle
+    return url.substring(1)
+  }
 
-    // Handle other cases, remove base prefix from URL
-    return url.startsWith(config.base)
-      ? url.substring(config.base.length)
-      : url
-  };
+  // Handle relative paths (when config.base is relative)
+  if (config.base === './' || config.base === '') {
+    return path.posix.resolve(path.posix.dirname(htmlPath), url)
+  }
 
-  const calculateIntegrity = async (bundle, htmlPath, url) => {
-    // Skip specified domains
-    if (isUrlFromBypassDomain(url, bypassDomains)) {
-      return null
-    }
+  // Handle other cases, remove base prefix from URL
+  return url.startsWith(config.base)
+    ? url.substring(config.base.length)
+    : url
+}
 
-    let source;
-    if (url.startsWith('http')) {
-      const isSupported = await checkResourceSupport(url);
-      if (!isSupported) return null
-      source = await fetchResource(url);
-      if (!source) return null
-    } else {
-      const bundleKey = getBundleKey(htmlPath, url);
-      const bundleItem = bundle[bundleKey];
+/**
+ * Calculate SRI integrity hash for a given resource
+ */
+async function calculateIntegrity(
+  bundle, 
+  htmlPath, 
+  url, 
+  options, 
+  config, 
+  cacheManager,
+  logger = null
+) {
+  const { 
+    ignoreMissingAsset, 
+    bypassDomains, 
+    hashAlgorithm 
+  } = options;
 
-      if (!bundleItem) {
-        // Try to find a matching item with more flexible matching
-        const possibleMatch = Object.keys(bundle).find(key =>
-          key.endsWith(bundleKey) || bundleKey.endsWith(key)
-        );
+  // Skip specified domains
+  if (isUrlFromBypassDomain(url, bypassDomains, logger)) {
+    return null
+  }
 
-        if (possibleMatch) {
-          source = bundle[possibleMatch].type === 'chunk'
-            ? bundle[possibleMatch].code
-            : bundle[possibleMatch].source;
-        } else if (ignoreMissingAsset) {
-          console.warn(`[${DEFAULT_PLUGIN_NAME}] Asset not found in bundle: ${url} (path: ${htmlPath}, key: ${bundleKey})`);
-          return null
-        } else {
-          throw new Error(`Asset ${url} not found in bundle (path: ${htmlPath}, key: ${bundleKey})`)
+  let source;
+  if (url.startsWith('http')) {
+    const isSupported = await checkResourceSupport(url, cacheManager.getUrlSupportCache(), logger);
+    if (!isSupported) return null
+    source = await fetchResource(url, cacheManager.getResourceCache(), logger);
+    if (!source) return null
+  } else {
+    const bundleKey = getBundleKey(htmlPath, url, config);
+    const bundleItem = bundle[bundleKey];
+
+    if (!bundleItem) {
+      // Try to find a matching item with more flexible matching
+      const possibleMatch = Object.keys(bundle).find(key =>
+        key.endsWith(bundleKey) || bundleKey.endsWith(key)
+      );
+
+      if (possibleMatch) {
+        source = bundle[possibleMatch].type === 'chunk'
+          ? bundle[possibleMatch].code
+          : bundle[possibleMatch].source;
+      } else if (ignoreMissingAsset) {
+        if (logger) {
+          logger.warn(`Asset not found in bundle: ${url} (path: ${htmlPath}, key: ${bundleKey})`);
         }
+        return null
       } else {
-        source = bundleItem.type === 'chunk' ? bundleItem.code : bundleItem.source;
+        throw new Error(`Asset ${url} not found in bundle (path: ${htmlPath}, key: ${bundleKey})`)
       }
+    } else {
+      source = bundleItem.type === 'chunk' ? bundleItem.code : bundleItem.source;
     }
+  }
 
-    // Ensure source is a Uint8Array or string
-    if (!source) return null
+  // Ensure source is a Uint8Array or string
+  if (!source) return null
+
+  if (typeof source === 'string') {
+    return `${hashAlgorithm}-${createHash(hashAlgorithm).update(source).digest('base64')}`
+  }
+
+  return `${hashAlgorithm}-${createHash(hashAlgorithm).update(Buffer.from(source)).digest('base64')}`
+}
+
+// Optimized regex patterns for better readability and efficiency
+const HTML_PATTERNS = {
+  script: {
+    regex: /<script\b[^>]*?\bsrc\s*=\s*["']([^"']+)["'][^>]*><\/script>/g,
+    endOffset: 10
+  },
+  stylesheet: {
+    regex: /<link\b[^>]*?\brel\s*=\s*["']stylesheet["'][^>]*?\bhref\s*=\s*["']([^"']+)["'][^>]*>/g,
+    endOffset: 1
+  },
+  modulepreload: {
+    regex: /<link\b[^>]*?\brel\s*=\s*["']modulepreload["'][^>]*?\bhref\s*=\s*["']([^"']+)["'][^>]*>/g,
+    endOffset: 1
+  }
+};
 
-    if (typeof source === 'string') {
-      return `${hashAlgorithm}-${createHash(hashAlgorithm).update(source).digest('base64')}`
+/**
+ * Validate HTML input
+ */
+function validateHtmlInput(html, htmlPath, logger) {
+  if (!html || typeof html !== 'string') {
+    logger.warn(`Invalid HTML content for ${htmlPath}`);
+    return false
+  }
+  return true
+}
+
+/**
+ * Process a single match to create an integrity change object
+ */
+async function processMatch(
+  match, 
+  endOffset, 
+  bundle, 
+  htmlPath, 
+  options, 
+  config, 
+  cacheManager,
+  logger
+) {
+  const [, url] = match;
+  if (!url) return null
+
+  const end = match.index + match[0].length;
+  const integrity = await calculateIntegrity(
+    bundle, 
+    htmlPath, 
+    url, 
+    options, 
+    config, 
+    cacheManager,
+    logger
+  );
+
+  if (integrity) {
+    return {
+      integrity,
+      position: end - endOffset,
+      url // For logging
     }
+  }
+  return null
+}
+
+/**
+ * Process matches for a specific HTML pattern
+ */
+async function processPatternMatches(
+  html, 
+  pattern, 
+  bundle, 
+  htmlPath, 
+  options, 
+  config, 
+  cacheManager,
+  logger
+) {
+  const { regex, endOffset } = pattern;
+  const matches = [...html.matchAll(regex)];
+
+  // Process each match in parallel
+  const matchResults = await Promise.all(
+    matches.map(match => 
+      processMatch(match, endOffset, bundle, htmlPath, options, config, cacheManager, logger)
+    )
+  );
 
-    return `${hashAlgorithm}-${createHash(hashAlgorithm).update(Buffer.from(source)).digest('base64')}`
-  };
+  // Filter out null results
+  return matchResults.filter(Boolean)
+}
 
-  const transformHTML = async (bundle, htmlPath, html) => {
-    if (!html || typeof html !== 'string') {
-      console.warn(`[${DEFAULT_PLUGIN_NAME}] Invalid HTML content for ${htmlPath}`);
-      return html
+/**
+ * Collect all integrity changes from HTML patterns
+ */
+async function collectIntegrityChanges(
+  html, 
+  bundle, 
+  htmlPath, 
+  options, 
+  config, 
+  cacheManager,
+  logger
+) {
+  const changes = [];
+
+  // Collect changes from all patterns in parallel
+  await Promise.all(
+    Object.values(HTML_PATTERNS).map(async pattern => {
+      const patternChanges = await processPatternMatches(
+        html, 
+        pattern, 
+        bundle, 
+        htmlPath, 
+        options, 
+        config, 
+        cacheManager,
+        logger
+      );
+      changes.push(...patternChanges);
+    })
+  );
+
+  return changes
+}
+
+/**
+ * Check if integrity attribute already exists in HTML segment
+ */
+function hasExistingIntegrity(html, position, integrity) {
+  const segment = html.slice(Math.max(0, position - 100), position + 100);
+  return segment.includes(`integrity="${integrity}"`)
+}
+
+/**
+ * Apply integrity changes to HTML content
+ */
+function applyIntegrityChanges(html, changes, logger) {
+  // Sort by position in descending order to insert from back to front
+  changes.sort((a, b) => b.position - a.position);
+
+  for (const { integrity, position, url } of changes) {
+    // Skip if integrity attribute already exists
+    if (hasExistingIntegrity(html, position, integrity)) {
+      continue
     }
 
-    const changes = [];
+    const insertText = ` integrity="${integrity}"`;
+    html = html.slice(0, position) + insertText + html.slice(position);
+    logger.debug(`Added integrity for: ${url}`);
+  }
 
-    // Collect changes from all patterns in parallel
-    await Promise.all(
-      Object.values(HTML_PATTERNS).map(async ({ regex, endOffset }) => {
-        const matches = [...html.matchAll(regex)];
+  return html
+}
 
-        // Process each match in parallel
-        const matchResults = await Promise.all(
-          matches.map(async match => {
-            const [, url] = match;
-            if (!url) return null
+/**
+ * Transform HTML by adding SRI integrity attributes
+ */
+async function transformHTML(
+  bundle, 
+  htmlPath, 
+  html, 
+  options, 
+  config, 
+  cacheManager,
+  logger
+) {
+  if (!validateHtmlInput(html, htmlPath, logger)) {
+    return html
+  }
 
-            const end = match.index + match[0].length;
-            const integrity = await calculateIntegrity(bundle, htmlPath, url);
+  const changes = await collectIntegrityChanges(
+    html, 
+    bundle, 
+    htmlPath, 
+    options, 
+    config, 
+    cacheManager,
+    logger
+  );
+
+  return applyIntegrityChanges(html, changes, logger)
+}
 
-            if (integrity) {
-              return {
-                integrity,
-                position: end - endOffset,
-                url // For logging
-              }
-            }
-            return null
-          })
-        );
+/**
+ * Create HTML transformer with given options and config
+ */
+function createTransformer(options, config, cacheManager, logger) {
+  return {
+    transformHTML: (bundle, htmlPath, html) => 
+      transformHTML(bundle, htmlPath, html, options, config, cacheManager, logger),
+    calculateIntegrity: (bundle, htmlPath, url) => 
+      calculateIntegrity(bundle, htmlPath, url, options, config, cacheManager, logger)
+  }
+}
 
-        // Filter out null results
-        matchResults.filter(Boolean).forEach(result => changes.push(result));
-      })
-    );
+const DEFAULT_PLUGIN_NAME$1 = 'vite-plugin-sri4';
+
+/**
+ * Logger class to handle different log levels without hijacking global console
+ */
+class Logger {
+  constructor(logLevel = 'warn', pluginName = DEFAULT_PLUGIN_NAME$1) {
+    this.logLevel = logLevel;
+    this.pluginName = pluginName;
+    this.levels = {
+      silent: 0,
+      error: 1,
+      warn: 2,
+      info: 3,
+      debug: 4
+    };
+    this.currentLevel = this.levels[logLevel] || this.levels.warn;
+  }
 
-    // Sort by position in descending order to insert from back to front (won't affect insertion points ahead)
-    changes.sort((a, b) => b.position - a.position);
+  /**
+   * Format message with plugin name prefix
+   */
+  formatMessage(message, ...args) {
+    const prefix = `[${this.pluginName}]`;
+    if (typeof message === 'string') {
+      return [prefix + ' ' + message, ...args]
+    }
+    return [prefix, message, ...args]
+  }
 
-    // Check if identical integrity attributes already exist to avoid duplicates
-    for (const { integrity, position, url } of changes) {
-      const insertText = ` integrity="${integrity}"`;
+  /**
+   * Log error messages
+   */
+  error(message, ...args) {
+    if (this.currentLevel >= this.levels.error) {
+      console.error(...this.formatMessage(message, ...args));
+    }
+  }
 
-      // Check if integrity attribute already exists
-      const segment = html.slice(Math.max(0, position - 100), position + 100);
-      if (segment.includes(`integrity="${integrity}"`)) {
-        continue // Skip elements that already have the same integrity
-      }
+  /**
+   * Log warning messages
+   */
+  warn(message, ...args) {
+    if (this.currentLevel >= this.levels.warn) {
+      console.warn(...this.formatMessage(message, ...args));
+    }
+  }
 
-      html = html.slice(0, position) + insertText + html.slice(position);
-      console.debug(`[${DEFAULT_PLUGIN_NAME}] Added integrity for: ${url}`);
+  /**
+   * Log info messages
+   */
+  info(message, ...args) {
+    if (this.currentLevel >= this.levels.info) {
+      console.info(...this.formatMessage(message, ...args));
     }
+  }
 
-    return html
-  };
+  /**
+   * Log debug messages
+   */
+  debug(message, ...args) {
+    if (this.currentLevel >= this.levels.debug) {
+      console.debug(...this.formatMessage(message, ...args));
+    }
+  }
 
-  return { transformHTML, calculateIntegrity }
+  /**
+   * Create a child logger with the same configuration
+   */
+  child(name) {
+    return new Logger(this.logLevel, `${this.pluginName}:${name}`)
+  }
 }
 
+// Constants definition
+const VITE_INTERNAL_ANALYSIS_PLUGIN = 'vite:build-import-analysis';
+const DEFAULT_HASH_ALGORITHM = 'sha384';
+const DEFAULT_PLUGIN_NAME = 'vite-plugin-sri4';
+
 function sri(options = {}) {
   const {
     ignoreMissingAsset = false,
@@ -302,16 +547,9 @@ function sri(options = {}) {
     logLevel = 'warn'
   } = options;
 
-  // Adjust log level
-  const originalConsoleWarn = console.warn;
-  const originalConsoleDebug = console.debug;
-
-  if (logLevel === 'error') {
-    console.warn = () => {};
-    console.debug = () => {};
-  } else if (logLevel === 'warn') {
-    console.debug = () => {};
-  }
+  // Create cache manager and logger instances for this plugin instance
+  const cacheManager = new CacheManager();
+  const logger = new Logger(logLevel, DEFAULT_PLUGIN_NAME);
 
   return {
     name: DEFAULT_PLUGIN_NAME,
@@ -320,13 +558,8 @@ function sri(options = {}) {
 
     // Cleanup work
     buildEnd() {
-      // Restore console functions
-      console.warn = originalConsoleWarn;
-      console.debug = originalConsoleDebug;
-
       // Clear caches
-      urlSupportCache.clear();
-      resourceCache.clear();
+      cacheManager.clearAll();
     },
 
     configResolved(config) {
@@ -334,7 +567,7 @@ function sri(options = {}) {
         ignoreMissingAsset,
         bypassDomains,
         hashAlgorithm
-      }, config);
+      }, config, cacheManager, logger);
 
       const generateBundle = async function(_, bundle) {
         const htmlFiles = Object.entries(bundle).filter(
@@ -344,7 +577,7 @@ function sri(options = {}) {
         );
 
         if (htmlFiles.length === 0) {
-          console.debug(`[${DEFAULT_PLUGIN_NAME}] No HTML files found in bundle`);
+          logger.debug('No HTML files found in bundle');
           return
         }
 
@@ -356,10 +589,10 @@ function sri(options = {}) {
               chunk.source = await transformer.transformHTML(bundle, name, originalContent);
 
               if (originalContent !== chunk.source) {
-                console.debug(`[${DEFAULT_PLUGIN_NAME}] SRI attributes added to ${name}`);
+                logger.debug(`SRI attributes added to ${name}`);
               }
             } catch (error) {
-              console.warn(`[${DEFAULT_PLUGIN_NAME}] Error processing ${name}:`, error);
+              logger.warn(`Error processing ${name}:`, error);
               // Keep original content on error
             }
           })