Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    wadey-rangerpublic

    Ranger

    Ranger is a node.js library for interacting with Campfire.

    Install

    Install ranger using npm.

    npm install ranger
    

    API

    Create a new client with the following:

    var client = require("ranger").createClient("account", "api-key");
    

    The createClient function takes two parameters:

    1. The account name, which is the subdomain of your account url. If your account url is 37signals.campfire.com then your account name would be 37signals.
    2. The api key of the user to connect as. You can get it from the "My info" link once logged into Campfire.

    Client

    Get a room by id:

    client.room(12345, function (room) { console.log(room); });
    

    Get an array of all rooms:

    client.rooms(function (rooms) { console.log(rooms); });
    

    Get an array of all rooms the api user is in:

    client.presence(function (rooms) { console.log(rooms) });
    

    Search for messages containing terms:

    client.search("party time", function (messages) { console.log(messages) });
    

    Get a user by id:

    client.user(12345, function (user) { console.log(user); });
    

    Get the api user:

    client.me(function (user) { console.log(user); });
    

    Room

    Speak a message:

    room.speak("hello world");
    

    Paste some text:

    room.paste("hello\nworld");
    

    Play a sound:

    room.play("trombone");
    

    Show a tweet:

    room.tweet("https://twitter.com/#!/jack/status/20");
    

    Update the room:

    room.update({ name: "Lounge", topic: "Anything goes" });
    

    Join the room:

    room.join();
    

    Leave the room:

    room.leave();
    

    Lock the room:

    room.lock();
    

    Unlock the room:

    room.unlock();
    

    Get an array of users in the room:

    room.users(function (users) { console.log(users); });
    

    Get an array of up to 5 recent file uploads in the room:

    room.recentUploads(function (uploads) { console.log(uploads); });
    

    Get an array of up to 100 recent messages in the room:

    room.recentMessages(function (messages) { console.log(messages); });
    

    Listen for messages in the room:

    room.listen(function (message) { console.log(message); });
    

    Get whether messages are being listened for:

    room.isListening();
    

    Stop listening for messages in the room:

    room.stopListening();
    

    Get an array of messages for a day:

    room.transcript(function (messages) { console.log(messages); });
    
    var newYears = new Date(2011, 0, 1);
    room.transcript(newYears, function (messages) { console.log(messages); });
    

    Message

    Star the message:

    message.star();
    

    Unstar the message:

    message.unstar();
    

    Get the upload details for the message:

    message.upload(function (upload) { console.log(upload); });
    

    Examples

    The following example joins room 123456 and plays the vuvuzela sound whenever anyone uses the word "soccer".

    var client = require("ranger").createClient("account", "api-key");
    client.room(123456, function (room) {
      room.join(function () {
        room.listen(function (message) {
          if (message.type === "TextMessage" && message.body.match(/soccer/i)) {
            room.play("vuvuzela");
          }
        });
      });
    });
    

    Contributing

    1. Fork Ranger
    2. Create a topic branch - git checkout -b mybranch
    3. Push to your branch - git push origin mybranch
    4. Create a new pull request

    Author

    Matt Duncan | mattduncan.org | matt@mattduncan.org

    Keywords

    none

    install

    npm i wadey-ranger

    Downloadsweekly downloads

    0

    version

    0.3.8

    license

    none

    repository

    github.com

    last publish

    collaborators

    • avatar