Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/michielbdejong/meute

Platform for building server-less web apps with per-user backends.
https://github.com/michielbdejong/meute

Last synced: 28 days ago
JSON representation

Platform for building server-less web apps with per-user backends.

Awesome Lists containing this project

README 

        
meute: JS lib for social unhosted web apps

======



To use, adapt the index.html page. It shows which files to include,

and includes a short example of how to use the `meute`

object to enter an irc channel, say something, and leave. Here is a

reference documentation of all the functions the library exposes in

the v0.7.* API:



* `meute.debugState()`: returns all internal state, namely:

  *  config: all configs (currently sockethub, irc and email are supported),

  *  configDone: which configs have been sent to sockethub successfully,

  *  outbox: commands that have been queued up until they can be sent,

  *  registeredActor: the name and id used for sending email and appearingn on irc,

  *  roomJoins: which irc rooms you have joined (or are in the process of joining),

  *  sockethubClient: the sockethub-client instance,

  *  sockethubRegistered: whether sockethub register command has been sent successfully,

  *  topic: irc room topics,

  *  attendance: irc room members



* `meute.addAccount(platform, server, x[, y, z])`, where:

  * string `platform` is 'sockethub', 'irc', or 'email'

  * string `server` is a WebSocket URL for sockethub, an irc server for irc, or an imap/stmp server for email,

  * string `x` is the secret for sockethub, the nick for irc, or the email address and imap username for email,

  * string `y` is the display name for email,

  * string `z` is the imap password for email,

  Sets the sockethub, irc, or email credentials.



* `meute.join(platform, rooms)`, where platform is 'irc' and rooms is a string or array of string room names:

  join one or more irc rooms. Example: `meute.join('irc', ['#meute', '#remotestorage']);`



* `meute.leave(platform, rooms)`, where platform is 'irc' and rooms is a string or array of string room names:

  leave one or more irc rooms. Example: `meute.leave('irc', ['#remotestorage']);`



* `meute.send(platform, target, text)` where platform is 'irc', string target is an irc nick or room name,

  * string text is the text to send:

  Sends message `text` to the irc user or the irc room `target`.



* `meute.on(event, handler)` where event is 'message' or 'debug' and handler is a function:

  Will cause handler to be called with a string argument when a debug message is available in the case of 'debug',

  or with an ActivityStreams object representing an irc message or an incoming email message in the case of 'message'



Some new proxies for remotestorage.js functionality:



* `meute.private(moduleName)` - wrapper for `remoteStorage.scope('/'+moduleName+'/')`.

* `meute.public(moduleName)` - wrapper for `remoteStorage.scope('/public/'+moduleName+'/')`.

* `meute.displayWidget()` - wrapper for `remoteStorage.displayWidget()`

* `meute.wire()` - returns `remoteStorage.remote`.



* `meute.addAccount('remotestorage', userAddress)` - set rs.js userAddress.

* `meute.addAccount('remotestorage', userAddress, token)` - same, but also sets token

* `meute.addAccount(backend, apiKey)` - set rs.js backend and apiKey.

* `meute.addAccount(backend, apiKey, token)` - same, but also sets token



Email functionality (experimental):



* `meute.email.sendEmail(recipient, subject, text, inReplyTo, preview)`, where:

  * recipient is either a string email address or an object containing one 'to' and one 'cc' field, both being single

    email addresses,

  * string subject is the email subject,

  * string text is the email body text,

  * string inReplyTo is the messageId of an email to which this email is a reply,

  * boolean preview will prevent the email from actually being sent if true,

  Will sent an email with the properties specified.



* `meute.email.fetchEmailsFromTo(from, to, includeBody)` with:

  * integer `from` the first IMAP id,

  * integer `to` the last IMAP id,

  * boolean `includeBody` set to true if you want the email bodies; false if you want just the headers,

  Fetches emails over IMAP; they will come in as 'message' events (see `meute.on`). *NB: this function is

  currently broken, use `meute.email.fetch` instead!*



* `meute.email.fetch1(arr)` with `arr` an array of integers:

  Fetch the bodies of the messages with the specified IMAP ids. Useful if you retrieved all the headers first of

  all your new email, and want to retrieve the bodies of only a few of them. *NB: this function is

  currently broken, use `meute.email.fetch` instead!*



* `fireInitial()`: load emails from disk into memory. This may take several minutes if you have more than 10,000 emails.



* `meute.email.findEmailsFrom(address)` with string `address` an email address, will return all email messages with

  that from address that have currently been loaded into memory. Make sure to call `fireInitial` first and wait for

  it to complete.



* `meute.email.findGaps(fetch)`, with `fetch` either undefined or an integer: See which email IMAP id's are in memory,

  and where there are gaps. If you specify an integer `fix` value, then the first `fix` emails of the first gap will

  be fetched. When there are no gaps (e.g. there is a solid range of IMAP id's from 0 to 12345), then it will try to

  fetch up to `fix` newer emails (with higher IMAP id's). Make sure to call `fireInitial` first and wait for it to

  complete. *NB: the `fix` parameter is currently broken, use `meute.email.fetch` instead!*



* `meute.email.fetch(pageNo, pageSize, includeBody)` where:

  * integer `pageNo` is the number of the page block to fetch,

  * integer `pageSize` is the page block size,

  * boolean `includeBody` causes bodies as well as headers to be fetched if set to true,

  Will retrieve the latest `pageSize` emails if `pageNo` is 0, the `pageSize` ones before that if `pageNo` is 1, etcetera.



* `remoteStorage.contacts.find(searchString)` where string `searchString` is a substring of the name or address of the contact:

  Returns an object full of addressbook entries that match the search (filled automatically from incoming email messages).



# Butler



* to use the butler service server-side, run `meute.getButlerConfig();` in the browser console while connected to your remoteStorage-account