npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

hubot-xmpp

v0.3.0

Published

XMPP adapter for Hubot.

Downloads

132

Readme

Hubot XMPP

Connects Hubot to your XMPP network

Build Status

Setup

Install dependencies with npm

npm install

Configuration

There are a few configuration values you can use when getting hubot-xmpp running. The XMPP adapter requires only 3 (5 if you need specify server and port) environment variables to be set to able to use it.

  • HUBOT_XMPP_USERNAME
  • HUBOT_XMPP_PASSWORD
  • HUBOT_XMPP_ROOMS

Optional:

  • HUBOT_XMPP_HOST The host name you want to connect to if its different than what is in the username jid.
  • HUBOT_XMPP_PORT The port to connect to on the jabber server.
  • HUBOT_XMPP_LEGACYSSL Set to 1 to enable legacy SSL port. This requires the host to be defined.
  • HUBOT_XMPP_PREFERRED_SASL_MECHANISM Used to change the encoding used for SASL.
  • HUBOT_XMPP_DISALLOW_TLS Prevent upgrading the connection to a secure one via TLS.
  • HUBOT_XMPP_PM_ADD_PREFIX Make commands work in PMs to hubot without robot name/alias.
  • HUBOT_XMPP_KEEPALIVE_INTERVAL Keep-alive interval in ms.
  • HUBOT_XMPP_RECONNECT_TRY the number of reconnect retry in case of disconnection, default is 5.
  • HUBOT_XMPP_RECONNECT_WAIT the time in ms to wait before reconnecting, default is 5000.

HUBOT_XMPP_ROOMS can be a comma separated list of rooms to join. If your rooms require passwords you should use the jid:password syntax. Room passwords cannot contain ,. Room names must be the full jid of the room for example [email protected].

HUBOT_XMPP_PM_ADD_PREFIX works by prefixing the private message with hubot name, so a side effect is that the bot ignores commands of type /^command/i.

Installation

Create a standalone hubot with xmpp adapter:

mkdir -p ./my-bot
cd ./my-bot
npx -p yo -p generator-hubot -c 'yo hubot --adapter=xmpp'

See also https://hubot.github.com/docs/ .

Group chat vs private JID

The jabber protocol does not broadcast real user JID in groupchat presence stanzas unless the server/chat room is configured to do so.

If you need to send private chat in response to a groupchat message, use hubot's send method with the groupchat jid and envelope.user.type = 'direct'. hubot-xmpp will then automatically resolve the JID to a private chat JID, and private message the sender.

If you need to get the private chat JID, you can use msg.envelope.user.privateChatJid where msg is the parameter of hubot's route callback.

Example:

robot.respond(/talk to me$/i, msg => {
  // Simply reply
  msg.reply(`Hello ${msg.envelope.user.name}. Your private JID is ${msg.envelope.user.privateChatJID}`);
});

robot.respond(/talk to me in private$/i, msg => {
  msg.envelope.user.type = 'direct';
  msg.send(`Hey ${msg.envelope.user.name}! You told me in room ${msg.envelope.user.room} to talk to you.`);
});