extension-from-store 0.2.0 → 0.2.2

package/README.md

@@ -1,4 +1,4 @@
-[npm-version-image]: https://img.shields.io/npm/v/extension-from-store.svg?color=0078D7
+[npm-version-image]: https://img.shields.io/npm/v/extension-from-store.svg?color=0971fe
 [npm-version-url]: https://www.npmjs.com/package/extension-from-store
 [npm-downloads-image]: https://img.shields.io/npm/dm/extension-from-store.svg?color=2ecc40
 [npm-downloads-url]: https://www.npmjs.com/package/extension-from-store
@@ -151,6 +151,14 @@ Library logging is opt-in via the `logger` hooks. The library never writes direc
 - `6` filesystem conflict
 - `7` store incompatibility
 
+## Related projects
+
+* [browser-extension-manifest-fields](https://github.com/cezaraugusto/browser-extension-manifest-fields)
+* [browser-extension-capabilities](https://github.com/cezaraugusto/browser-extension-capabilities)
+* [browser-extension-compat-data](https://github.com/cezaraugusto/browser-extension-compat-data)
+* [chrome-extension-manifest-json-schema](https://github.com/cezaraugusto/chrome-extension-manifest-json-schema)
+* [parse5-asset-patcher](https://github.com/cezaraugusto/parse5-asset-patcher)
+
 ## License
 
 MIT (c) Cezar Augusto.

package/bin.cjs

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
-'use strict';
 
-const mod = require('./dist/index.cjs');
-const fetchExtensionFromStore = mod.fetchExtensionFromStore;
-const extensionFromStoreError = mod.extensionFromStoreError;
+'use strict'
+
+const mod = require('./dist/index.cjs')
+
+const {fetchExtensionFromStore} = mod
+const {extensionFromStoreError} = mod
 
 const EXIT_CODES = {
   InvalidInput: 1,
@@ -13,12 +15,13 @@ const EXIT_CODES = {
   DownloadFailed: 4,
   ExtractionFailed: 5,
   FilesystemConflict: 6,
-  StoreIncompatibility: 7,
-};
+  StoreIncompatibility: 7
+}
+
+function parseArgs (argv) {
+  const args = [...argv]
 
-function parseArgs(argv) {
-  const args = [...argv];
-  if (args[0] === 'fetch') args.shift();
+  if (args[0] === 'fetch') args.shift()
 
   const result = {
     url: '',
@@ -28,126 +31,130 @@ function parseArgs(argv) {
     extract: false,
     quiet: false,
     verbose: false,
-    json: false,
-  };
+    json: false
+  }
 
   for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
+    const arg = args[i]
 
     if (arg === '--url') {
-      result.url = args[++i] || '';
-      continue;
+      result.url = args[++i] || ''
+      continue
     }
 
     if (arg === '--out') {
-      result.out = args[++i] || '';
-      continue;
+      result.out = args[++i] || ''
+      continue
     }
 
     if (arg === '--version') {
-      result.version = args[++i] || '';
-      continue;
+      result.version = args[++i] || ''
+      continue
     }
+
     if (arg === '--extract') {
-      result.extract = true;
-      continue;
+      result.extract = true
+      continue
     }
 
     if (arg === '--user-agent') {
-      result.userAgent = args[++i] || '';
-      continue;
+      result.userAgent = args[++i] || ''
+      continue
     }
 
     if (arg === '--quiet') {
-      result.quiet = true;
-      continue;
+      result.quiet = true
+      continue
     }
 
     if (arg === '--verbose') {
-      result.verbose = true;
-      continue;
+      result.verbose = true
+      continue
     }
 
     if (arg === '--json') {
-      result.json = true;
-      continue;
+      result.json = true
+      continue
     }
 
-    throw new Error(`Unknown flag: ${arg}`);
+    throw new Error(`Unknown flag: ${arg}`)
   }
 
   if (!result.url) {
-    throw new Error('Missing required flag: --url');
+    throw new Error('Missing required flag: --url')
   }
 
-  return result;
+  return result
 }
 
-function createCliLogger(opts) {
+function createCliLogger (opts) {
   const emit = (level, message, error) => {
-    const payload = { level, message };
+    const payload = {level, message}
 
-    if (error) payload.error = String(error);
+    if (error) payload.error = String(error)
 
-    console.log(JSON.stringify(payload));
-  };
+    console.log(JSON.stringify(payload))
+  }
 
   if (opts.json) {
     return {
       onInfo: (message) => emit('info', message),
       onWarn: (message) => emit('warn', message),
-      onError: (message, error) => emit('error', message, error),
-    };
+      onError: (message, error) => emit('error', message, error)
+    }
   }
 
   return {
     onInfo: opts.quiet ? undefined : (message) => console.log(message),
     onWarn: opts.quiet ? undefined : (message) => console.error(message),
     onError: (message, error) => {
-      const text = error ? `${message}\n${String(error)}` : message;
-      console.error(text);
-    },
-  };
+      const text = error ? `${message}\n${String(error)}` : message
+
+      console.error(text)
+    }
+  }
 }
 
-async function main() {
-  let args = null;
+async function main () {
+  let args = null
 
   try {
-    args = parseArgs(process.argv.slice(2));
-    const logger = createCliLogger(args);
+    args = parseArgs(process.argv.slice(2))
+    const logger = createCliLogger(args)
+
     await fetchExtensionFromStore(args.url, {
       outDir: args.out || undefined,
       userAgent: args.userAgent || undefined,
       version: args.version || undefined,
       extract: args.extract,
-      logger,
-    });
+      logger
+    })
 
-    process.exit(0);
+    process.exit(0)
   } catch (error) {
     if (error instanceof extensionFromStoreError) {
-      const code = EXIT_CODES[error.code] || 1;
-      const message = error.message || 'Extension fetch failed';
+      const code = EXIT_CODES[error.code] || 1
+      const message = error.message || 'Extension fetch failed'
 
       if (args?.json) {
-        console.log(JSON.stringify({ level: 'error', message }));
+        console.log(JSON.stringify({level: 'error', message}))
       } else if (code !== 0) {
-        console.error(message);
+        console.error(message)
       }
 
-      process.exit(code);
+      process.exit(code)
     }
-    const message = String(error?.message || error);
+
+    const message = String(error?.message || error)
 
     if (args?.json) {
-      console.log(JSON.stringify({ level: 'error', message }));
+      console.log(JSON.stringify({level: 'error', message}))
     } else {
-      console.error(message);
+      console.error(message)
     }
 
-    process.exit(1);
+    process.exit(1)
   }
 }
 
-main();
+main()

package/bin.js

@@ -1,8 +1,8 @@
-#!/usr/bin/env node
 
-const mod = require('./dist/index.cjs');
-const fetchExtensionFromStore = mod.fetchExtensionFromStore;
-const extensionFromStoreError = mod.extensionFromStoreError;
+const mod = require('./dist/index.cjs')
+
+const {fetchExtensionFromStore} = mod
+const {extensionFromStoreError} = mod
 
 const EXIT_CODES = {
   InvalidInput: 1,
@@ -12,13 +12,13 @@ const EXIT_CODES = {
   DownloadFailed: 4,
   ExtractionFailed: 5,
   FilesystemConflict: 6,
-  StoreIncompatibility: 7,
-};
+  StoreIncompatibility: 7
+}
 
-function parseArgs(argv) {
-  const args = [...argv];
+function parseArgs (argv) {
+  const args = [...argv]
 
-  if (args[0] === 'fetch') args.shift();
+  if (args[0] === 'fetch') args.shift()
 
   const result = {
     url: '',
@@ -28,123 +28,129 @@ function parseArgs(argv) {
     extract: false,
     quiet: false,
     verbose: false,
-    json: false,
-  };
+    json: false
+  }
 
   for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
+    const arg = args[i]
 
     if (arg === '--url') {
-      result.url = args[++i] || '';
-      continue;
+      result.url = args[++i] || ''
+      continue
     }
 
     if (arg === '--out') {
-      result.out = args[++i] || '';
-      continue;
+      result.out = args[++i] || ''
+      continue
     }
 
     if (arg === '--version') {
-      result.version = args[++i] || '';
-      continue;
+      result.version = args[++i] || ''
+      continue
     }
+
     if (arg === '--extract') {
-      result.extract = true;
-      continue;
+      result.extract = true
+      continue
     }
 
     if (arg === '--user-agent') {
-      result.userAgent = args[++i] || '';
-      continue;
+      result.userAgent = args[++i] || ''
+      continue
     }
 
     if (arg === '--quiet') {
-      result.quiet = true;
-      continue;
+      result.quiet = true
+      continue
     }
 
     if (arg === '--verbose') {
-      result.verbose = true;
-      continue;
+      result.verbose = true
+      continue
     }
 
     if (arg === '--json') {
-      result.json = true;
-      continue;
+      result.json = true
+      continue
     }
 
-    throw new Error(`Unknown flag: ${arg}`);
+    throw new Error(`Unknown flag: ${arg}`)
   }
 
   if (!result.url) {
-    throw new Error('Missing required flag: --url');
+    throw new Error('Missing required flag: --url')
   }
 
-  return result;
+  return result
 }
 
-function createCliLogger(opts) {
+function createCliLogger (opts) {
   const emit = (level, message, error) => {
-    const payload = { level, message };
-    if (error) payload.error = String(error);
-    console.log(JSON.stringify(payload));
-  };
+    const payload = {level, message}
+
+    if (error) payload.error = String(error)
+
+    console.log(JSON.stringify(payload))
+  }
 
   if (opts.json) {
     return {
       onInfo: (message) => emit('info', message),
       onWarn: (message) => emit('warn', message),
-      onError: (message, error) => emit('error', message, error),
-    };
+      onError: (message, error) => emit('error', message, error)
+    }
   }
 
   return {
     onInfo: opts.quiet ? undefined : (message) => console.log(message),
     onWarn: opts.quiet ? undefined : (message) => console.error(message),
     onError: (message, error) => {
-      const text = error ? `${message}\n${String(error)}` : message;
-      console.error(text);
-    },
-  };
+      const text = error ? `${message}\n${String(error)}` : message
+
+      console.error(text)
+    }
+  }
 }
 
-async function main() {
-  let args = null;
+async function main () {
+  let args = null
 
   try {
-    args = parseArgs(process.argv.slice(2));
-    const logger = createCliLogger(args);
+    args = parseArgs(process.argv.slice(2))
+    const logger = createCliLogger(args)
+
     await fetchExtensionFromStore(args.url, {
       outDir: args.out || undefined,
       userAgent: args.userAgent || undefined,
       version: args.version || undefined,
       extract: args.extract,
-      logger,
-    });
-    process.exit(0);
+      logger
+    })
+    process.exit(0)
   } catch (error) {
     if (error instanceof extensionFromStoreError) {
-      const code = EXIT_CODES[error.code] || 1;
-      const message = error.message || 'Extension fetch failed';
+      const code = EXIT_CODES[error.code] || 1
+      const message = error.message || 'Extension fetch failed'
 
       if (args?.json) {
-        console.log(JSON.stringify({ level: 'error', message }));
+        console.log(JSON.stringify({level: 'error', message}))
       } else if (code !== 0) {
-        console.error(message);
+        console.error(message)
       }
 
-      process.exit(code);
+      process.exit(code)
     }
-    const message = String(error?.message || error);
+
+    const message = String(error?.message || error)
 
     if (args?.json) {
-      console.log(JSON.stringify({ level: 'error', message }));
+      console.log(JSON.stringify({level: 'error', message}))
     } else {
-      console.error(message);
+      console.error(message)
     }
 
-    process.exit(1);
+    process.exit(1)
   }
 }
 
-main();
+main()

package/dist/588.js

@@ -0,0 +1,211 @@
+function _define_property(obj, key, value) {
+    if (key in obj) Object.defineProperty(obj, key, {
+        value: value,
+        enumerable: true,
+        configurable: true,
+        writable: true
+    });
+    else obj[key] = value;
+    return obj;
+}
+class extensionFromStoreError extends Error {
+    constructor(code, message, cause){
+        super(message), _define_property(this, "code", void 0), _define_property(this, "cause", void 0);
+        this.code = code;
+        this.cause = cause;
+    }
+}
+function asExtensionFromStoreError(error, fallback) {
+    if (error instanceof extensionFromStoreError) return error;
+    return new extensionFromStoreError(fallback.code, fallback.message, error);
+}
+function readUInt32LE(bytes, offset) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset + offset, Uint32Array.BYTES_PER_ELEMENT);
+    return view.getUint32(0, true);
+}
+function readMagic(bytes) {
+    let out = '';
+    const slice = bytes.subarray(0, 4);
+    for(let index = 0; index < slice.length; index += 1)out += String.fromCharCode(slice[index]);
+    return out;
+}
+function stripCrxHeader(buffer) {
+    if (buffer.length < 16) throw new extensionFromStoreError('ExtractionFailed', 'CRX file too small');
+    const magic = readMagic(buffer);
+    if ('Cr24' !== magic) throw new extensionFromStoreError('ExtractionFailed', 'Invalid CRX header');
+    const version = readUInt32LE(buffer, 4);
+    if (2 === version) {
+        const publicKeyLength = readUInt32LE(buffer, 8);
+        const signatureLength = readUInt32LE(buffer, 12);
+        const headerSize = 16 + publicKeyLength + signatureLength;
+        return buffer.subarray(headerSize);
+    }
+    if (3 === version) {
+        const headerSize = readUInt32LE(buffer, 8);
+        return buffer.subarray(12 + headerSize);
+    }
+    throw new extensionFromStoreError('ExtractionFailed', `Unsupported CRX version ${version}`);
+}
+function createLogger(logger) {
+    return {
+        info: (message)=>logger?.onInfo?.(message),
+        warn: (message)=>logger?.onWarn?.(message),
+        error: (message, error)=>logger?.onError?.(message, error)
+    };
+}
+function parseManifestInfo(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    } catch (error) {
+        throw new extensionFromStoreError('ExtractionFailed', 'manifest.json is not valid JSON', error);
+    }
+    if (!parsed || 'object' != typeof parsed || Array.isArray(parsed)) throw new extensionFromStoreError('ExtractionFailed', 'manifest.json must contain an object');
+    const manifest = parsed;
+    const manifestVersion = manifest.manifest_version;
+    const extensionVersion = manifest.version;
+    if (2 !== manifestVersion && 3 !== manifestVersion) throw new extensionFromStoreError('ExtractionFailed', 'manifest_version must be 2 or 3');
+    if (!extensionVersion || 'string' != typeof extensionVersion) throw new extensionFromStoreError('ExtractionFailed', 'manifest.json is missing a version');
+    return {
+        manifest,
+        manifestVersion,
+        extensionVersion
+    };
+}
+function normalizeChromePlatformInfo(platform) {
+    return {
+        os: platform.os,
+        arch: platform.arch,
+        naclArch: platform.naclArch || platform.arch
+    };
+}
+const DEFAULT_CHROME_PLATFORM = {
+    os: 'linux',
+    arch: 'x64'
+};
+function getChromeDownloadUrl(id, platformInfo = DEFAULT_CHROME_PLATFORM) {
+    const encoded = encodeURIComponent(id);
+    const platform = normalizeChromePlatformInfo(platformInfo);
+    const productId = 'chromiumcrx';
+    const productChannel = 'unknown';
+    const productVersion = '9999.0.9999.0';
+    return [
+        'https://clients2.google.com/service/update2/crx',
+        '?response=redirect',
+        `&os=${platform.os}`,
+        `&arch=${platform.arch}`,
+        `&os_arch=${platform.arch}`,
+        `&nacl_arch=${platform.naclArch}`,
+        `&prod=${productId}`,
+        `&prodchannel=${productChannel}`,
+        `&prodversion=${productVersion}`,
+        '&acceptformat=crx2,crx3',
+        `&x=id%3D${encoded}%26uc`
+    ].join('');
+}
+function getEdgeDownloadUrl(id) {
+    const encoded = encodeURIComponent(id);
+    return [
+        'https://edge.microsoft.com/extensionwebstorebase/v1/crx',
+        '?response=redirect',
+        '&prodversion=109.0.0.0',
+        `&x=id%3D${encoded}%26installsource%3Dondemand%26uc`
+    ].join('');
+}
+async function resolveFirefoxDownload(idOrSlug, versionHint, options) {
+    const baseUrl = `https://addons.mozilla.org/api/v5/addons/addon/${encodeURIComponent(idOrSlug)}/`;
+    const addon = await options.requestJson(baseUrl, options);
+    const slugOrId = addon.slug || idOrSlug;
+    if (versionHint) {
+        const versionUrl = `${baseUrl}versions/${encodeURIComponent(versionHint)}/`;
+        const version = await options.requestJson(versionUrl, options);
+        const downloadUrl = version.file?.url;
+        if (!downloadUrl) throw new extensionFromStoreError('NotPublic', `Version ${versionHint} is not publicly downloadable`);
+        return {
+            downloadUrl,
+            version: version.version || versionHint,
+            slugOrId
+        };
+    }
+    const downloadUrl = addon.current_version?.file?.url;
+    const version = addon.current_version?.version;
+    if (!downloadUrl || !version) throw new extensionFromStoreError('NotPublic', 'Extension is not publicly downloadable');
+    return {
+        downloadUrl,
+        version,
+        slugOrId
+    };
+}
+const chromePattern = /^https?:\/\/(?:chrome\.google\.com\/webstore|chromewebstore\.google\.com)\/.+?\/([a-p]{32})(?=[\/#?]|$)/i;
+const chromeDownloadPattern = /^https?:\/\/clients2\.google\.com\/service\/update2\/crx\b.*?%3D([a-p]{32})%26uc/i;
+const edgePattern = /^https?:\/\/microsoftedge\.microsoft\.com\/addons\/.+?\/([a-z]{32})(?=[\/#?]|$)/i;
+const edgeDownloadPattern = /^https?:\/\/edge\.microsoft\.com\/extensionwebstorebase\/v1\/crx\b.*?%3D([a-z]{32})%26/i;
+const firefoxPattern = /^https?:\/\/((?:reviewers\.)?(?:addons\.mozilla\.org|addons(?:-dev)?\.allizom\.org))\/.*?(?:addon|review)\/([^/<>"'?#]+)/i;
+const firefoxDownloadPattern = /^https?:\/\/(addons\.mozilla\.org|addons(?:-dev)?\.allizom\.org)\/[^?#]*\/downloads\/latest\/([^/?#]+)/i;
+function detectStoreFromUrl(url) {
+    if (chromePattern.test(url) || chromeDownloadPattern.test(url)) return 'chrome';
+    if (edgePattern.test(url) || edgeDownloadPattern.test(url)) return 'edge';
+    if (firefoxPattern.test(url) || firefoxDownloadPattern.test(url)) return 'firefox';
+    return null;
+}
+function extractChromeIdFromUrl(url) {
+    const match = chromePattern.exec(url) || chromeDownloadPattern.exec(url);
+    return match ? match[1] : null;
+}
+function extractEdgeIdFromUrl(url) {
+    const match = edgePattern.exec(url) || edgeDownloadPattern.exec(url);
+    return match ? match[1] : null;
+}
+function extractFirefoxSlugFromUrl(url) {
+    const match = firefoxPattern.exec(url) || firefoxDownloadPattern.exec(url);
+    return match ? match[2] : null;
+}
+function validateInput(url) {
+    if (!url || 'string' != typeof url) throw new extensionFromStoreError('InvalidInput', 'URL is required');
+}
+function sanitizeSegment(value, label) {
+    const sanitized = value.replace(/[\\/]/g, '-').trim();
+    if (!sanitized) throw new extensionFromStoreError('InvalidInput', `${label} is not a valid path segment`);
+    return sanitized;
+}
+async function resolveDownload(url, options) {
+    const store = detectStoreFromUrl(url);
+    if (!store) throw new extensionFromStoreError('UnsupportedStore', 'URL does not match a supported store');
+    if ('chrome' === store) {
+        const downloadId = extractChromeIdFromUrl(url);
+        if (!downloadId) throw new extensionFromStoreError('NotFound', 'Chrome extension id not found in URL');
+        return {
+            store,
+            downloadUrl: getChromeDownloadUrl(downloadId, options.platform),
+            archiveType: 'crx',
+            downloadId,
+            slugOrId: downloadId
+        };
+    }
+    if ('edge' === store) {
+        const downloadId = extractEdgeIdFromUrl(url);
+        if (!downloadId) throw new extensionFromStoreError('NotFound', 'Edge extension id not found in URL');
+        return {
+            store,
+            downloadUrl: getEdgeDownloadUrl(downloadId),
+            archiveType: 'crx',
+            downloadId,
+            slugOrId: downloadId
+        };
+    }
+    const slug = extractFirefoxSlugFromUrl(url);
+    if (!slug) throw new extensionFromStoreError('NotFound', 'Firefox extension slug not found in URL');
+    const firefox = await resolveFirefoxDownload(slug, options.version, {
+        userAgent: options.userAgent,
+        logger: options.logger,
+        requestJson: options.requestJson
+    });
+    return {
+        store,
+        downloadUrl: firefox.downloadUrl,
+        archiveType: 'xpi',
+        versionHint: firefox.version,
+        slugOrId: firefox.slugOrId
+    };
+}
+export { asExtensionFromStoreError, createLogger, detectStoreFromUrl, extensionFromStoreError, extractChromeIdFromUrl, extractEdgeIdFromUrl, extractFirefoxSlugFromUrl, getChromeDownloadUrl, getEdgeDownloadUrl, normalizeChromePlatformInfo, parseManifestInfo, resolveDownload, resolveFirefoxDownload, sanitizeSegment, stripCrxHeader, validateInput };