deltachat-node

Email-based instant messaging for Node.js.

Showing:

Popularity

Downloads/wk

262

GitHub Stars

44

Maintenance

Last Commit

7d ago

Contributors

20

Package

Dependencies

6

License

GPL-3.0-or-later

Type Definitions

Built-In

Tree-Shakeable

No?

Categories

Readme

deltachat-node

node.js bindings for deltachat-core-rust

npm Node version Coverage Status dependencies JavaScript Style Guide

If you are upgrading: please see UPGRADING.md.

deltachat-node primarily aims to offer two things:

  • A high level JavaScript api with syntactic sugar
  • A low level c binding api around deltachat-core-rust

Table of Contents

Click to expand

Install

By default the installation will build try to use the bundled prebuilds in the npm package. If this fails it falls back to compile the bundled deltachat-core-rust from the submodule using scripts/rebuild-core.js. To install from npm use:

npm install deltchat-node

Dependencies

  • Nodejs >= v14.0.0
  • rustup (optional if you can't use the prebuilds)

Build from source

If you want to build from source, make sure that you have rustup installed. You can either use npm install deltachat-node --build-from-source to force building from source or clone this repository and follow this steps:

  1. git clone https://github.com/deltachat/deltachat-node.git
  2. cd deltachat-node
  3. npm i

Usage

const DeltaChat = require('deltachat-node').default
const dc = new DeltaChat()

const opts = {
  addr: '[email]',
  mail_pw: '[password]'
}

const contact = '[email]'

async function main() {
  const dc = new DeltaChat()

  dc.on('ALL', console.log.bind(null, 'core |'))
  await dc.open('./')
  
  try {
    await dc.configure(opts)
  } catch (err) {
    console.error("Failed to configure because of: ", err)
    dc.close()
    return
  }

  dc.startIO()
  console.log('fully configured')


  const contactId = dc.createContact('Test', contact)
  const chatId = dc.createChatByContactId(contactId)
  dc.sendMessage(chatId, 'Hi!')

  console.log('sent message')

  dc.once('DC_EVENT_SMTP_MESSAGE_SENT', async () => {
    console.log('Message sent, shutting down...')
    dc.stopIO()
    console.log('stopped io')
    dc.close()
  })
}

main()

Generating Docs

We are curently migrating to automaticaly generated documentation. You can find the old documentation at old_docs.

to generate the documentation, run:

npx typedoc

The resulting documentation can be found in the docs/ folder. An online version can be found under js.delta.chat.

Developing

Tests and Coverage

Running npm test ends with showing a code coverage report, which is produced by nyc.

test output

The coverage report from nyc in the console is rather limited. To get a more detailed coverage report you can run npm run coverage-html-report. This will produce a html report from the nyc data and display it in a browser on your local machine.

To run the integration tests you need to set the DCC_NEW_TMP_EMAIL environment variables. E.g.:

$ export DCC_NEW_TMP_EMAIL=https://testrun.org/new_email?t=[token]
$ npm run test

Scripts

We have the following scripts for building, testing and coverage:

  • npm run coverage Creates a coverage report and passes it to coveralls. Only done by Travis.
  • npm run coverage-html-report Generates a html report from the coverage data and opens it in a browser on the local machine.
  • npm run generate-constants Generates constants.js and events.js based on the deltachat-core-rust/deltachat-ffi/deltachat.h header file.
  • npm install After dependencies are installed, runs node-gyp-build to see if the native code needs to be rebuilt.
  • npm run build Rebuilds all code.
  • npm run build:core Rebuilds code in deltachat-core-rust.
  • npm run build:bindings Rebuilds the bindings and links with deltachat-core-rust.
  • ǹpm run clean Removes all built code
  • npm run prebuildify Builds prebuilt binary to prebuilds/$PLATFORM-$ARCH. Copies deltachat.dll from deltachat-core-rust for windows.
  • npm run download-prebuilds Downloads all prebuilt binaries from github before npm publish.
  • npm run submodule Updates the deltachat-core-rust submodule.
  • npm test Runs standard and then the tests in test/index.js.
  • npm run test-integration Runs the integration tests.
  • npm run hallmark Runs hallmark on all markdown files.

Releases

The following steps are needed to make a release:

  1. Update CHANGELOG.md (and run npm run hallmark to adjust markdown)
  • Add release changelog in top section
  • Also adjust links to github prepare links at the end of the file
  1. Bump version number in package.json
  2. Commit the changed files, commit message should be similiar to Prepare for v1.0.0-foo.number
  3. Tag the release with git tag -a v1.0.0-foo.number
  4. Push to github with git push origin master --tags
  5. Wait until Make Package github action is completed
  6. Download deltachat-node.tgz from the github release and run npm publish deltachat-node.tgz to publish it to npm. You probably need write rights to npm.

License

Licensed under GPL-3.0-or-later, see LICENSE file for details.

Copyright © 2018 DeltaChat contributors.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial