Bundle rules, scripts and hooks to deploy them to Auth0.
Last updated 10 months ago by lo1tuma .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install auth0-bundler 
SYNC missed versions from official npm registry.


NPM version Build status License

Bundle rules, scripts and hooks to deploy them to Auth0.

This allows you to

  • test rules, scripts and hooks dedicated to be deployed to Auth0, as they can be required in node as well.
  • import other modules by using require statements with relative file paths. This way common functionality can be shared between rules.
  • write your rules using the whole ES2015 feature set, as the rules will be transpiled at bundle time.
  • pass in configuration at bundling time which can be used in your rule when it is executed.



const createBundler = require('auth0-bundler');

const bundler = createBundler(options);


  • nodeVersion: the node version that should be targeted (used for @babel/preset-env), the default is 4

bundler.bundleScript(injectedConfig, scriptFilename) -> Promise<bundledScript>

bundler.bundleRule(injectedConfig, ruleFilename) -> Promise<bundledRule>

bundler.bundleHook(injectedConfig, hookFilename) -> Promise<bundledHook>

Bundles a single script, rule or hook so it can be deployed to Auth0. The rule needs to be written as a commonjs module that exports a single function. This function takes an additional first parameter compared to being defined in Auth0: The injectedConfig that can be specified at bundle time. Modules required from the node_modules folder will not be bundled and will be required in the Auth0 environment as well. Auth0 provides a number of modules inside the Auth0 environment, to check whether a module can be required check webtaskio-canirequire.



// my-rule.js
// Example rule to be deployed to auth0

// This dependency will be automatically bundled into the rule
const doRequest = require('../common/function');
// This dependency will be loaded using require
const R = require('ramda');

module.exports = function myRule(config, user, context, callback) {
    return doRequest(`${config.baseUrl}/some/endpoint`, user).then(function (result) {
        callback(null, R.merge({ some: 'result' }, result), context);

Bundle dependencies:

const createBundler = require('auth0-bundler');
const bundler = createBundler();
const config = { baseUrl: '' };

    .bundleRule(config, `${__dirname}/my-rule.js`)

Using auth0-bundler during deployment

This is an example on how to use auth0-bundler and the Auth0 Management API client to automatically deploy a rule using auth0-bundler. Like this you can automatically deploy rules e.g. during a CI run.

const ManagementClient = require('auth0').ManagementClient;
const management = new ManagementClient({
  token: '{YOUR_API_V2_TOKEN}',
  domain: '{YOUR_ACCOUNT}'
const createBundler = require('auth0-bundler');
const bundler = createBundler();
const config = { baseUrl: '' };

bundler.bundleRule(config, `${__dirname}/my-rule.js`).then((bundledRule) => {
    return management.createRule({
        enabled: true,
        name: 'my-rule',
        order: 1,
        stage: 'login_success',
        script: bundledRule


This project is licensed under the MIT license. See the LICENSE file for more info.

Current Tags

  • 1.2.0                                ...           latest (10 months ago)

7 Versions

  • 1.2.0                                ...           10 months ago
  • 1.1.2                                ...           a year ago
  • 1.1.1                                ...           a year ago
  • 1.1.0                                ...           a year ago
  • 1.0.2                                ...           2 years ago
  • 1.0.1                                ...           2 years ago
  • 1.0.0                                ...           2 years ago
Today 0
This Week 2
This Month 2
Last Day 0
Last Week 0
Last Month 11
Dev Dependencies (6)
Dependents (0)

Copyright 2014 - 2016 © |