bomb

bomb

A cache busting middleware for express.

• Acts as a static middleware
• Caches file contents in RAM
• Serves on a hashed filename route too

###Install

npm install --save bomb

###Example

Let's say we want to serve all the files in our public directory:

├── index.js
    └── public
        ├── example.css
        ├── example.js
        ├── example.png
        └── other
            └── index.html
            

We can create a new bomb box and use it as a middleware:

var Express = require('express');
var Bomb = require('bomb');
var Path = require('path');

var app = Express();

var box = new Bomb.Box({
    url: '/public',                           // use this as the URL root
    path: Path.join(__dirname, 'public'),     // look in this directory for files
    regex: /\.(css|js|html)/                  // only serve files that match regex
});

app.use(box);

app.listen(4000);

We can now request the files on the natural or hashed URLS:

• /public/example.css
• /public/example-4591dd5c9fd5aab8f5d7df6ac939441c.css
• /public/example.js
• /public/example-00e062122c3306198fdbe5d3ddd01fe0.js
• /public/other/index.html
• /public/other/index-33c805c6162941684b6fc618d0e42ab8.html

To get the hashed URL from a natural one, just call box.url(url):

box.url('/public/example.css') === '/public/example-4591dd5c9fd5aab8f5d7df6ac939441c.css'