webstore-upload

Automatically upload new versions of Chrome Extensions or Apps to the Chrome Webstore - integrated in your node project!

Usage no npm install needed!

<script type="module">
  import webstoreUpload from 'https://cdn.skypack.dev/webstore-upload';
</script>

README

webstore-upload

Automatically upload new versions of Chrome Extensions or Apps to the Chrome Webstore - integrated in your node project!

Forked from c301's grunt-webstore-upload to make it usable as a node module instead of a grunt task.

Getting Started

Overview

Read more about great ability to automate this task here: Chrome Web Store Publish API.

Please note, that you have to upload your extension first time manually, and then provide appID to update ( see below ). Also please make sure, that your draft ready to be published, ie all required fields was populated

Install

With npm: npm install --save webstore-upload

Example


// Promise api
var webstore_upload = require('webstore-upload');

webstore_upload(uploadOptions, loggerFn)
.then(function(result) {
    console.log(result);
    // do somethings nice
    return 'yay';
})
.catch(function(err) {
    console.error(err);
});


// Deprecated callback api - meanwhile it's here for compatability and whoever is already depend on it.
var webstore_upload = require('webstore-upload/deprecated');

webstore_upload(uploadOptions, function(result) {
    console.log('complete!');
    console.log(result);
});
var uploadOptions = {
    accounts: {
        default: { //account under this section will be used by default
            publish: true, //publish item right after uploading. default false
            client_id: 'ie204es2mninvnb.apps.googleusercontent.com',
            client_secret: 'LEJDeBHfS'
        },
        other_account: {
            publish: true, //publish item right after uploading. default false
            client_id: 'ie204es2mninvnb.apps.googleusercontent.com',
            client_secret: 'LEJDeBHfS',
            refresh_token: '1/eeeeeeeeeeeeeeeeeeeeeee_aaaaaaaaaaaaaaaaaaa'
        },
        new_account: {
            cli_auth: true, // Use server-less cli prompt go get access token. Default false
            publish: true, //publish item right after uploading. default false
            client_id: 'kie204es2mninvnb.apps.googleusercontent.com',
            client_secret: 'EbDeHfShcj'
        }
    },
    extensions: {
        extension1: {
            //required
            appID: 'jcbeonnlikcefedeaijjln',
            //required, we can use dir name and upload most recent zip file
            zip: 'test/files/test1.zip'
        },
        extension2: {
            account: 'new_account',
            //will rewrite values from 'account' section
            publish: true,
            appID: 'jcbeonnlikcefedeaijjln',
            zip: 'test/files/test2.zip',
            publishTarget: 'trustedTesters'
        }
    },
    uploadExtensions : ['extension2']
};

Tests

Test cases:

  • All should work with existing refresh_token
  • All should work with creating new token from web
  • All should work with creating new token from cmd
  • Fail on bad existing refresh_token
  • Fail on Non developer account
  • Fail on incorrect publishTarget value

Logger

Can be 'default', 'quiet' or your logger function (winston and similar):

// info, log, warn, err
logger('log', 'message');

CLI

If you want the cli option, you can use the original grunt project

Configuration

Name Type Required Default Description Notes
accounts Object Yes List of the accounts (see Accounts section for details).
extensions Object Yes List of the extension (see Extensions section for details).
onComplete Function No Function that will be executed when all extensions uploaded. See result example below

onComplete / Promise result

Array of released extensions passed as argument:

[{
    fileName        : zip,
    extensionName   : options.name,
    extensionId     : options.appID,
    published       : true
}..]

Accounts

Since Google allows only 20 extensions under one account, you can create multiple records here. It is object with arbitrary meaningful accounts names as a keys (see example above). Special account named default will be used by defaults.

Name Type Required Default Description Notes
publish Boolean No false Make item available at Chrome Webstore or not.
client_id String Yes Client ID to access to Chrome Console API. How to get it
client_secret String Yes Client Secret to access to Chrome Console API. How to get it
refresh_token String No Refresh token for the Chrome Console API. How to get it

Extensions

It is object with arbitrary meaningful extensions names as a keys (see example above).

Name Type Required Default Description Notes
appID String Yes Extension id or Application id at Chrome Webstore
zip String Yes Path to zip file. Upload most recent zip file in case of path is directory
zip String Yes
publish Boolean No false Make item available at Chrome Webstore or not. This option under extensions will rewrite publish under related account section.
publishTarget String No default Make item available at Chrome Webstore. Can be trustedTesters or default Publish
account String No default Name of the account, that we should use to upload extension.

Workflow

Read more about Chrome Web Store Publish API and how to get Client ID and Client secret

  • require the module with the configuration (see examples)
  • call the module
  • browser should be opened
  • confirm privileges in browser ( we have to manually do this )
  • wait until uploading will be finished

To automatically pull a new access token using a refresh token just set the refresh_token property in your configuration. If the refresh_token is present it will automatically refresh the token for you without any manual intervention.

Contributing

  • Bugs, features and etc. are welcome!
  • In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality.

License

Mine: Copyright (c) 2016 Ariel Jannai. Licensed under the MIT license.

Original project: Copyright (c) 2014 Anton Sivolapov. Licensed under the MIT license.