sails-hook-sockets

    2.0.1 • Public • Published

    sails-hook-sockets

    Implements Socket.io support in Sails.

    This is a core hook in the Sails.js framework. You can override or disable it using your .sailsrc file or environment variables. See Concepts > Configuration for more information.

    Help

    If you have further questions or are having trouble, click here.

    What version of Sails is this for?

    This hook is for Sails v1.0 and up.

    Prior to Sails v1.0, this hook was a dependency of Sails core. But now, it is now installed as a direct dependency of your Sails app.

    What is this? What does it do?

    This repo contains a hook, one of the building blocks Sails is made out of.

    This hook's responsibilities are:

    • When initialized...
      • fire up socket.io server
      • listen for connect / disconnect events
        • listen for get/post/put/delete/patch events
          • create bare-bones request and response contexts, then pass them to the core interpreter in Sails to be routed on the fly.
      • Bind after "shadow" routes...
        • GET /__getcookie
      • Expose on the sails app object:

    What version of Socket.io does this hook use?

    Click here to check out the semver range for this hook's Socket.io dependency.

    For reproducibility, we always pin 3rd party dependencies to a specific version, using a consistent verified version string when possible (see kit).

    Bugs   NPM version

    To report a bug, click here.

    Contributing

    Please observe the guidelines and conventions laid out in the Sails project contribution guide when opening issues or submitting pull requests.

    NPM

    Running the tests

    First, clone this repo, cd into it, and install dependencies:

    git clone https://github.com/balderdashy/sails-hook-sockets.git
    cd sails-hook-sockets
    npm install
    Run them all

    To run all the tests, start a local redis server on port 6380 and then run the tests using mocha:

    redis-server --port 6380 --requirepass 'secret'
    npm test
    Run only certain tests

    Alternatively, you can run a particular set of tests with:

    node ./node_modules/mocha/bin/mocha -g 'without session'

    (this may be useful if you don't want to wait for all the tests to run, or e.g. if you aren't able to install a redis server locally. However please make sure all the tests pass before submitting a PR.)

    License

    The Sails framework is free and open-source under the MIT License.

    Install

    npm i sails-hook-sockets

    DownloadsWeekly Downloads

    16,874

    Version

    2.0.1

    License

    MIT

    Unpacked Size

    384 kB

    Total Files

    63

    Last publish

    Collaborators

    • particlebanana
    • rachaelshaw
    • sgress454
    • balderdashy
    • mikermcneil
    • eashaw