Wondering what‚Äôs next for npm?Check out our public roadmap! ¬Ľ

    aerospike-session-store

    0.4.0¬†‚Äʬ†Public¬†‚Äʬ†Published

    Aerospike Express Session Store travis codecov npm

    The Aerospike Express Session Store is an implementation of the Express.js session store that uses Aerospike as the persistence layer for sessions. The session middleware for Express is provided by the session-express module. Aerospike DB is a high-performance NoSQL key-value store: www.aerospike.com.

    Installation

    Via npm:

    $ npm install aerospike-session-store

    Usage

    Initialization

    Pass the express-session store into aerospike-session-store to create an AerospikeStore constructor. Then use that constructor to create a new store instance:

    const session = require('express-session')
    const AerospikeStore = require('aerospike-session-store')(session)
     
    var app = express()
    app.use(session({
      secret: '123456789QWERTY',
      store: new AerospikeStore({
        namespace: 'express',
        set: 'session',
        ttl: 86400, // 1 day
        hosts: '10.0.0.1:3000,10.0.0.2:3000'
      }),
      resave: false,
      saveUninitialized: false
    }))

    Options

    The session store requires an Aerospike Client instance to connect to the DB cluster. An existing client instance can be passed in using the client option. Otherwise, the session store will create it's own client instance. The Aerospike session store can be initialized with a number of optional parameters:

    • client - An existing Aerospike client instance that the session store should use instead of creating it's own instance.
    • namespace - The Aerospike namespace to be used for session storage. (default: 'test')
    • set - The Aerospike set name used when creating session records. (default: 'express-session')
    • ttl - Time-to-live in seconds for the session records created in the Aerospike db. If not specified, the ttl will be determined based on the maxAge of the session cookie, if any. Set ttl to zero to disable usage of ttl. However, note that a default ttl at the namespace level might still apply.
    • mapper - A custom data mapper to convert session objects to/from a format suitable for storage in an Aerospike record. By default, the JSON module is used to serialize session objects to/from JSON format.

    Additional options are passed on to the Aerospike client when creating a new client instance (i.e. unless the client paramter is used.) Please refer to the client's API documentation for a detailed list of supported paramters.

    License

    The Aerospike Express Session Store is made availabled under the terms of the Apache License, Version 2, as stated in the file LICENSE.

    Individual files may be made available under their own specific license, all compatible with Apache License, Version 2. Please see individual files for details.

    Install

    npm i aerospike-session-store

    DownloadsWeekly Downloads

    25

    Version

    0.4.0

    License

    Apache-2.0

    Last publish

    Collaborators

    • avatar
    • avatar
    • avatar