https://github.com/wtfaremyinitials/osa-imessage
Send and receive iMessages with nodejs
https://github.com/wtfaremyinitials/osa-imessage
imessage node nodejs osa promise
Last synced: about 1 month ago
JSON representation
Send and receive iMessages with nodejs
- Host: GitHub
- URL: https://github.com/wtfaremyinitials/osa-imessage
- Owner: wtfaremyinitials
- License: mit
- Created: 2014-11-21T04:21:43.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-02-21T18:14:28.000Z (about 4 years ago)
- Last Synced: 2024-03-24T17:22:38.790Z (about 1 year ago)
- Topics: imessage, node, nodejs, osa, promise
- Language: JavaScript
- Homepage:
- Size: 2.07 MB
- Stars: 322
- Watchers: 12
- Forks: 96
- Open Issues: 9
-
Metadata Files:
- Readme: readme.md
- License: license
Awesome Lists containing this project
README
osa-imessage
====
[](https://github.com/prettier/prettier)
> Send and receive iMessages through nodejs
Installation
===
**Requires OSX 10.10 Yosemite**
```bash
npm install osa-imessage --save
```
Usage
====
Be sure to require `osa-imessage`:
```js
const imessage = require('osa-imessage')
```
**Send a message**
```js
imessage.send('+15555555555', 'Hello World!')
```
**Receive messages**
```js
imessage.listen().on('message', (msg) => {
if (!msg.fromMe) console.log(`'${msg.text}' from ${msg.handle}`)
})
```
**Send message to name**
```js
imessage.handleForName('Tim Cook').then(handle => {
imessage.send(handle, 'Hello')
})
```
**Send message to group**
```js
imessage.send('chat000000000000000000', 'Hello everyone!')
```
**Get recent chats**
```js
imessage.getRecentChats(20) // Defaults to 10
```
API
===
### Send a message
`send(handle, text) -> Promise`
Sends a message to the specified handle.
**handle**
Type: `string`
The user or group to send the message to, in one of the following forms:
- phone number (`+1555555555`)
- email address (`[email protected]`)
- group chat id (`chat000000000000000000`)
**text**
Type: `string`
The content of the message to be sent.
**return**
Type: `Promise<>`
A promise that resolves when the message is sent, and rejects if the
message fails to send.
### Receive messages
`listen([interval]) -> EventEmitter`
Begins polling the local iMessage database for new messages.
**interval**
Type: `number`
The rate at which the database is polled for new messages. Defaults to the minimum of `1000 ms`.
**return**
Type: [`EventEmitter`](https://nodejs.org/api/events.html#events_class_eventemitter)
An event emitter with that listeners can be attached to. Currently it only has the `message` event.
Example message event
```js
{
text: 'Hello, world!',
handle: '+15555555555',
group: null,
date: new Date('2017-04-11T02:02:13.000Z'),
fromMe: false,
guid: 'F79E08A5-4314-43B2-BB32-563A2BB76177'
}
```
Example *group* message event
```js
{
text: 'Hello, group!',
handle: '+15555555555',
group: 'chat000000000000000000',
date: new Date('2017-04-23T21:18:54.943Z'),
fromMe: false,
guid: 'DCFE0EEC-F9DD-48FC-831B-06C75B76ACB9'
}
```
### Get a handle for a given name
`handleForName(name) -> Promise`
**name**
Type: `string`
The full name of the desired contact, as displayed in `Messages.app`.
**return**
Type: `Promise`
A promise that resolves with the `handle` of the contact, or rejects if nobody was found.
### Get the name associated with a given handle
`nameForHandle(handle) -> Promise`
**handle**
Type: `string`
The handle of a contact.
**return**
Type: `Promise`
A promise that resolved with the full name of the desired contact, as displayed in `Messages.app`.
### Get recents chats
`getRecentChats(limit) -> Promise`
**limit**
Type: `integer`
Amount of recent chats to return.
**return**
Type: `Promise`
A promise that resolves with an array of chats.