extension-from-store 0.1.1 → 0.2.1

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
@@ -45,6 +45,33 @@ const options = {
 await fetchExtensionFromStore(url, options)
 ```
 
+**Via browser entrypoint:**
+
+```ts
+import {fetchExtensionFromStoreBrowser} from 'extension-from-store/browser'
+
+const result = await fetchExtensionFromStoreBrowser(
+  'https://chromewebstore.google.com/detail/adblock-plus-free-ad-bloc/cfhdojbkjhnklbpkdaibdccddilifddb',
+)
+
+console.log(result.meta)
+console.log(result.files.find((file) => file.path === 'manifest.json')?.text)
+```
+
+The browser entry keeps everything in memory and returns archive bytes, extracted files, and parsed manifest metadata. It does not write to disk.
+
+**Via core helpers:**
+
+```ts
+import {
+  detectStoreFromUrl,
+  extractChromeIdFromUrl,
+  getChromeDownloadUrl,
+  parseManifestInfo,
+  stripCrxHeader,
+} from 'extension-from-store/core'
+```
+
 **Via CLI (default command is `fetch`):**
 
 ```bash
@@ -124,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];
-  if (args[0] === 'fetch') args.shift();
+function parseArgs (argv) {
+  const args = [...argv]
+
+  if (args[0] === 'fetch') args.shift()
 
   const result = {
     url: '',
@@ -28,129 +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);
-    await fetchExtensionFromStore(
-      args.url,
-      {
-        outDir: args.out || undefined,
-        userAgent: args.userAgent || undefined,
-        version: args.version || undefined,
-        extract: args.extract,
-        logger,
-      },
-    );
-
-    process.exit(0);
+    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)
   } 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,126 +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);
-    await fetchExtensionFromStore(
-      args.url,
-      {
-        outDir: args.out || undefined,
-        userAgent: args.userAgent || undefined,
-        version: args.version || undefined,
-        extract: args.extract,
-        logger,
-      },
-    );
-    process.exit(0);
+    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)
   } 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()