# IRC IRC **Kind**: global class * [IRC](#IRC) * [new IRC(cfg)](#new_IRC_new) * [.schema](#IRC+schema) * [.connect(job, credentials, done)](#IRC+connect) * [.join(job, done)](#IRC+join) * [.leave(job, done)](#IRC+leave) * [.send(job, done)](#IRC+send) * [.update(job, done)](#IRC+update) * [.query(job, done)](#IRC+query) ## new IRC(cfg) Handles all actions related to communication via. the IRC protocol. Uses the `irc-factory` node module as a base tool for interacting with IRC. [https://github.com/ircanywhere/irc-factory](https://github.com/ircanywhere/irc-factory)

Param	Type	Description
cfg	`object`	a unique config object for this instance // TODO LINK

## irC.schema JSON schema defining the types this platform accepts. In the below example, Sockethub will validate the incoming credentials object against whatever is defined in the `credentials` portion of the schema object. It will also check if the incoming AS object uses a type which exists in the `types` portion of the schema object (should be an array of type names). * **NOTE**: For more information on using the credentials object from a client, see [Sockethub Client](https://github.com/sockethub/sockethub/wiki/Sockethub-Client) Valid AS object for setting IRC credentials: **Kind**: instance property of [IRC](#IRC) **Example** ```js { type: 'credentials', context: 'irc', actor: { id: 'testuser@irc.host.net', type: 'person', name: 'Mr. Test User', userName: 'testuser' }, object: { type: 'credentials', server: 'irc.host.net', nick: 'testuser', password: 'asdasdasdasd', port: 6697, secure: true, sasl: true } } ``` ## irC.connect(job, credentials, done) Function: connect Conenct to an IRC server. **Kind**: instance method of [IRC](#IRC)

Param	Type	Description
job	`object`	activity streams object
credentials	`object`	credentials object
done	`object`	callback when job is done

## irC.join(job, done) Function: join Join a room or private conversation. **Kind**: instance method of [IRC](#IRC)

Param	Type	Description
job	`object`	activity streams object // TODO LINK
done	`object`	callback when job is done // TODO LINK

**Example** ```js { context: 'irc', type: 'join', actor: { id: 'slvrbckt@irc.freenode.net', type: 'person', name: 'slvrbckt' }, target: { id: 'irc.freenode.net/a-room', type: 'room', name: '#a-room' }, object: {} } ``` ## irC.leave(job, done) Function leave Leave a room or private conversation. **Kind**: instance method of [IRC](#IRC)

Param	Type	Description
job	`object`	activity streams object // TODO LINK
done	`object`	callback when job is done // TODO LINK

**Example** ```js { context: 'irc', type: 'leave', actor: { id: 'slvrbckt@irc.freenode.net', type: 'person', name: 'slvrbckt' }, target: { id: 'irc.freenode.net/remotestorage', type: 'room', name: '#remotestorage' }, object: {} } ``` ## irC.send(job, done) Function: send Send a message to a room or private conversation. **Kind**: instance method of [IRC](#IRC)

Param	Type	Description
job	`object`	activity streams object // TODO LINK
done	`object`	callback when job is done // TODO LINK

**Example** ```js { context: 'irc', type: 'send', actor: { id: 'slvrbckt@irc.freenode.net', type: 'person', name: 'Nick Jennings', userName: 'slvrbckt' }, target: { id: 'irc.freenode.net/remotestorage', type: 'room', name: '#remotestorage' }, object: { type: 'message', content: 'Hello from Sockethub!' } } ``` ## irC.update(job, done) Function: update Indicate a change (ie. room topic update, or nickname change). **Kind**: instance method of [IRC](#IRC)

Param	Type	Description
job	`object`	activity streams object // TODO LINK
done	`object`	callback when job is done // TODO LINK

**Example** ```js change topic { context: 'irc', type: 'update', actor: { id: 'slvrbckt@irc.freenode.net', type: 'person', name: 'Nick Jennings', userName: 'slvrbckt' }, target: { id: 'irc.freenode.net/a-room', type: 'room', name: '#a-room' }, object: { type: 'topic', content: 'New version of Socekthub released!' } } ``` **Example** ```js change nickname { context: 'irc' type: 'udpate', actor: { id: 'slvrbckt@irc.freenode.net', type: 'person', name: 'slvrbckt' }, object: { type: "address", }, target: { id: 'cooldude@irc.freenode.net', type: 'person', name: cooldude } } ``` ## irC.query(job, done) Function: query Indicate an intent to query something (e.g. get a list of users in a room). **Kind**: instance method of [IRC](#IRC)

Param	Type	Description
job	`object`	activity streams object // TODO LINK
done	`object`	callback when job is done // TODO LINK

**Example** ```js { context: 'irc', type: 'query', actor: { id: 'slvrbckt@irc.freenode.net', type: 'person', name: 'Nick Jennings', userName: 'slvrbckt' }, target: { id: 'irc.freenode.net/a-room', type: 'room', name: '#a-room' }, object: { type: 'attendance' } } // The above object might return: { context: 'irc', type: 'query', actor: { id: 'irc.freenode.net/a-room', type: 'room', name: '#a-room' }, target: {}, object: { type: 'attendance' members: [ 'RyanGosling', 'PeeWeeHerman', 'Commando', 'Smoochie', 'neo' ] } } ```