extension-develop 0.0.0-next-20250825144602

package/dist/extensions/chrome-manager-extension/reload-service.js

@@ -0,0 +1,297 @@
+const TEN_SECONDS_MS = 10 * 1000
+const INSTANT_MS = 100
+let webSocket = null
+
+// Get instance ID from the service worker context
+const instanceId = '__INSTANCE_ID__'
+
+export async function connect() {
+  if (webSocket) {
+    // If already connected, do nothing
+    return
+  }
+
+  // Get port from the placeholder that will be replaced during build
+  const port = '__RELOAD_PORT__'
+
+  let reconnectAttempts = 0
+  const maxReconnectAttempts = 10
+  const baseBackoffMs = 250
+  const maxBackoffMs = 5000
+
+  const establish = () => {
+    webSocket = new WebSocket(`ws://127.0.0.1:${port}`)
+
+    webSocket.onerror = (_event) => {
+      try {
+        webSocket && webSocket.close()
+      } catch {}
+    }
+
+    webSocket.onopen = () => {
+      reconnectAttempts = 0
+      console.info(
+        `[Extension.js] Connection opened. Listening on port ${port} for instance ${instanceId}...`
+      )
+    }
+
+    let reloadDebounce
+    webSocket.onmessage = async (event) => {
+      const message = JSON.parse(event.data)
+
+      // Only process messages for this instance
+      if (message.instanceId && message.instanceId !== instanceId) {
+        return
+      }
+
+      if (message.status === 'serverReady') {
+        await requestInitialLoadData()
+      }
+
+      if (message.changedFile) {
+        clearTimeout(reloadDebounce)
+        reloadDebounce = setTimeout(async () => {
+          await hardReloadAllExtensions(message.changedFile)
+        }, 200)
+      }
+    }
+
+    webSocket.onclose = () => {
+      webSocket = null
+      if (reconnectAttempts >= maxReconnectAttempts) return
+      reconnectAttempts++
+      const backoff = Math.min(
+        maxBackoffMs,
+        baseBackoffMs * 2 ** reconnectAttempts
+      )
+      setTimeout(establish, backoff)
+    }
+  }
+
+  establish()
+}
+
+export function disconnect() {
+  if (webSocket) {
+    webSocket.close()
+  }
+}
+
+async function requestInitialLoadData() {
+  const devExtensions = await getDevExtensions()
+
+  for (const extension of devExtensions) {
+    try {
+      const response = await chrome.runtime.sendMessage(extension.id, {
+        initialLoadData: true
+      })
+
+      if (response) {
+        // Send the response back to the server with instance ID
+        webSocket.send(
+          JSON.stringify({
+            status: 'clientReady',
+            instanceId: instanceId,
+            data: response
+          })
+        )
+      }
+    } catch (error) {
+      console.error(
+        `[Extension.js] Error sending message to ${extension.id}: ${error.message}`
+      )
+    }
+  }
+}
+
+async function getDevExtensions() {
+  const allExtensions = await new Promise((resolve) => {
+    chrome.management.getAll(resolve)
+  })
+
+  return allExtensions.filter((extension) => {
+    return (
+      // Do not include itself
+      extension.id !== chrome.runtime.id &&
+      // Manager extension
+      extension.id !== 'hkklidinfhnfidkjiknmmbmcloigimco' &&
+      // Show only unpackaged extensions
+      extension.installType === 'development'
+    )
+  })
+}
+
+async function hardReloadAllExtensions(changedFile) {
+  // For critical files like manifest.json, skip the long delay
+  const isCriticalFile =
+    changedFile === 'manifest.json' ||
+    changedFile === 'service_worker' ||
+    changedFile === 'declarative_net_request'
+
+  // Check if the external extension is ready with optimized timing
+  const isExtensionReady = await checkExtensionReadiness(isCriticalFile)
+
+  if (isExtensionReady) {
+    const devExtensions = await getDevExtensions()
+    const reloadAll = devExtensions.map(async (extension) => {
+      await hardReloadExtension(extension.id)
+
+      chrome.runtime.sendMessage(extension.id, {changedFile}, (response) => {
+        if (response) {
+          console.info(
+            `[Extension.js] Extension reloaded and ready for instance ${instanceId}.`
+          )
+        }
+      })
+
+      return true
+    })
+
+    await Promise.all(reloadAll)
+  } else {
+    console.info(
+      `[Extension.js] External extension is not ready for instance ${instanceId}.`
+    )
+  }
+}
+
+async function checkExtensionReadiness(isCriticalFile = false) {
+  return new Promise((resolve) => {
+    // For critical files like manifest.json, use minimal delay
+    // For regular files, use longer delay to ensure stability
+    const delay = isCriticalFile ? INSTANT_MS : TEN_SECONDS_MS
+
+    setTimeout(() => {
+      resolve(true)
+    }, delay)
+  })
+}
+
+// Smart reload strategy: Try standard method first, fallback to CDP if needed
+async function hardReloadExtension(extensionId) {
+  try {
+    // Try the standard enable/disable reload first (feels natural)
+    await chrome.management.setEnabled(extensionId, false)
+    await chrome.management.setEnabled(extensionId, true)
+
+    // Verify it worked with a simple health check
+    const isHealthy = await verifyExtensionHealth(extensionId)
+    if (isHealthy) {
+      console.info(
+        `[Extension.js] Standard reload successful for ${extensionId}`
+      )
+      return true
+    }
+
+    // If we get here, the reload "succeeded" but extension isn't healthy
+    throw new Error('[Reload Service] Extension reloaded but not responding')
+  } catch (error) {
+    console.warn(
+      `[Extension.js] Standard reload failed for ${extensionId}, trying CDP fallback: ${error.message}`
+    )
+
+    // Only use CDP when the natural approach fails
+    return await attemptCDPFallback(extensionId)
+  }
+}
+
+// CDP fallback for when standard reload fails
+async function attemptCDPFallback(extensionId) {
+  try {
+    // Get extension info to find its source path
+    const extensionInfo = await new Promise((resolve) => {
+      chrome.management.get(extensionId, resolve)
+    })
+
+    if (!extensionInfo || !extensionInfo.path) {
+      console.warn(
+        `[Extension.js] No path info for ${extensionId}, CDP fallback not possible`
+      )
+      return false
+    }
+
+    // Use CDP client directly for seamless fallback
+    const cdpClient = await getCDPClient()
+    if (!cdpClient) {
+      console.warn(`[Extension.js] CDP client not available for ${extensionId}`)
+      return false
+    }
+
+    // Use CDP to force reload the extension
+    const success = await cdpClient.forceReloadExtension(extensionId)
+    if (success) {
+      console.info(`[Extension.js] CDP fallback successful for ${extensionId}`)
+      return true
+    } else {
+      console.warn(`[Extension.js] CDP fallback failed for ${extensionId}`)
+      return false
+    }
+  } catch (cdpError) {
+    console.error(
+      `[Extension.js] CDP fallback also failed for ${extensionId}: ${cdpError.message}`
+    )
+    return false
+  }
+}
+
+// Get CDP client instance
+// This will be injected by the build process
+async function getCDPClient() {
+  try {
+    // The CDP client will be available globally when injected
+    if (typeof window !== 'undefined' && window.cdpClient) {
+      return window.cdpClient
+    }
+
+    // Fallback for service worker context
+    if (typeof globalThis !== 'undefined' && globalThis.cdpClient) {
+      return globalThis.cdpClient
+    }
+
+    console.warn(`[Extension.js] CDP client not found in global scope`)
+    return null
+  } catch (error) {
+    console.warn(`[Extension.js] Failed to get CDP client: ${error.message}`)
+    return null
+  }
+}
+
+/**
+ * Simple health check to verify extension is responsive
+ */
+async function verifyExtensionHealth(extensionId) {
+  try {
+    // Simple ping to see if extension responds
+    await new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error('Health check timeout'))
+      }, 2000)
+
+      chrome.runtime.sendMessage(extensionId, {type: 'PING'}, (response) => {
+        clearTimeout(timeout)
+        if (chrome.runtime.lastError) {
+          reject(new Error(chrome.runtime.lastError.message))
+        } else {
+          resolve(response)
+        }
+      })
+    })
+    return true
+  } catch (error) {
+    console.warn(
+      `[Extension.js] Health check failed for ${extensionId}: ${error.message}`
+    )
+    return false
+  }
+}
+
+export function keepAlive() {
+  const keepAliveIntervalId = setInterval(() => {
+    if (webSocket) {
+      webSocket.send(JSON.stringify({status: 'ping'}))
+      console.info('[Extension.js] Listening for changes...')
+    } else {
+      clearInterval(keepAliveIntervalId)
+    }
+  }, TEN_SECONDS_MS)
+}

package/dist/extensions/chromium-based-manager-extension/background.js

@@ -0,0 +1,58 @@
+import {createExtensionsPageTab, handleFirstRun} from './define-initial-tab.js'
+import {connect, disconnect, keepAlive} from './reload-service.js'
+
+function bgGreen(str) {
+  return `background: transparent; color: #0971fe; ${str}`
+}
+chrome.tabs.query({active: true}, async ([initialTab]) => {
+  console.log(
+    `%c
+██████████████████████████████████████████████████████████
+██████████████████████████████████████████████████████████
+████████████████████████████    ██████████████████████████
+█████████████████████████        ██████    ███████████████
+███████████████████████     ███   ███         ████████████
+██████████████████████    ██████        ███    ███████████
+███████████████████████     ██████    ██████   ███████████
+████████████████   ██████   ██████████████     ███████████
+█████████████       ████    ████████████      ████████████
+███████████     ██         █████████████   ███████████████
+██████████    ██████    █████████████████    █████████████
+███████████    ████████████████████████████    ███████████
+█████████████    █████████████████    ██████    ██████████
+███████████████   ██████████████        ██      ██████████
+████████████      ████████████    ████       █████████████
+███████████      █████████████   ██████    ███████████████
+███████████   ██████    ██████     ███████████████████████
+███████████    ████       ██████    ██████████████████████
+████████████         ██    ███     ███████████████████████
+███████████████    ██████        █████████████████████████
+██████████████████████████    ████████████████████████████
+██████████████████████████████████████████████████████████
+██████████████████████████████████████████████████████████
+MIT (c) ${new Date().getFullYear()} - Cezar Augusto and the Extension.js Authors.
+`,
+    bgGreen('')
+  )
+
+  if (
+    initialTab.url === 'chrome://newtab/' ||
+    initialTab.url === 'chrome://welcome/'
+  ) {
+    await handleFirstRun()
+  } else {
+    createExtensionsPageTab(initialTab, 'chrome://extensions/')
+  }
+})
+
+chrome.runtime.onInstalled.addListener(async () => {
+  let isConnected = false
+
+  if (isConnected) {
+    disconnect()
+  } else {
+    await connect()
+    isConnected = true
+    keepAlive()
+  }
+})

package/dist/extensions/chromium-based-manager-extension/define-initial-tab.js

@@ -0,0 +1,77 @@
+async function getDevExtension() {
+  const allExtensions = await new Promise((resolve) => {
+    chrome.management.getAll(resolve)
+  })
+
+  const devExtensions = allExtensions.filter((extension) => {
+    return (
+      // Do not include itself
+      extension.id !== chrome.runtime.id &&
+      // Reload extension
+      extension.id !== 'igcijhgmihmjbbahdabahfbpffalcfnn' &&
+      // Show only unpackaged extensions
+      extension.installType === 'development'
+    )
+  })
+
+  return devExtensions[0]
+}
+
+// Ideas here are adapted from
+// https://github.com/jeremyben/webpack-chrome-extension-launcher
+// Released under MIT license.
+
+// Create a new tab and set it to background.
+// We want the user-selected page to be active,
+// not chrome://extensions.
+export function createExtensionsPageTab(initialTab, url) {
+  // Check if url tab is open
+  chrome.tabs.query({url: 'chrome://extensions/'}, (tabs) => {
+    const extensionsTabExist = tabs.length > 0
+
+    // Return if url exists
+    if (extensionsTabExist) return
+
+    // Create an inactive tab
+    chrome.tabs.create(
+      {url, active: false},
+      function setBackgroundTab(extensionsTab) {
+        // Get current url tab and move it left.
+        // This action auto-activates the tab
+        chrome.tabs.move(extensionsTab.id, {index: 0}, () => {
+          // Get user-selected initial page tab and activate the right tab
+          setTimeout(() => {
+            chrome.tabs.update(initialTab.id, {active: true})
+          }, 500)
+        })
+      }
+    )
+  })
+}
+
+// Function to handle first run logic
+export async function handleFirstRun() {
+  chrome.tabs.update({url: 'chrome://extensions/'})
+
+  const devExtension = await getDevExtension()
+
+  chrome.storage.local.get(devExtension.id, (result) => {
+    if (result[devExtension.id] && result[devExtension.id].didRun) {
+      return
+    }
+
+    // Guard against opening multiple welcome pages
+    chrome.tabs.query(
+      {url: chrome.runtime.getURL('pages/welcome.html')},
+      (tabs) => {
+        if (Array.isArray(tabs) && tabs.length > 0) {
+          // Already open; do not create another
+          return
+        }
+        chrome.tabs.create({url: 'pages/welcome.html'})
+      }
+    )
+    // Ensure the welcome page shows only once per extension installation
+    chrome.storage.local.set({[devExtension.id]: {didRun: true}})
+  })
+}

package/dist/extensions/chromium-based-manager-extension/manifest.json

@@ -0,0 +1,17 @@
+{
+  "name": "Extension.js DevTools",
+  "description": "Extension.js built-in developer tools for browser instance ID __INSTANCE_ID__",
+  "version": "1.0.0",
+  "manifest_version": 3,
+  "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAolEJq/DBHxY5dBpOqBRWNCl7vRPBvJPlpEzF19fYFVzzaH44AF6+sKjN3jwIKlsgI82F3TIuwoNFiN1yBu5Unf8SVBE4BTO92P02/ACcGYQxicgCLFUGQKlq4uSrwSPaBYl7FHcYl5SERgxnIGCGnaGMdL2vC7waCj2/U/iKoBF9I1lBH9/aKCSjTd3h2UYo7gg6n5nY/ENbzylDt42T3ATmvnVJfYhSNKA9Dv/zryknfnHYYgBKHtz7pDZwWnYdxs78n2VEKwGj7TgbXuIPDpCkrMnU9PTKpHbXFYARA4H9qYORQmYazfIxUZRnKQNSR+GAOGrb8JK+ijeQdwzDAwIDAQAB",
+  "background": {
+    "service_worker": "background.js",
+    "type": "module"
+  },
+  "icons": {
+    "16": "images/logo.png",
+    "48": "images/logo.png",
+    "128": "images/logo.png"
+  },
+  "permissions": ["management", "tabs", "storage"]
+}