A node.js library to communicate with your Sector Alarm sites. Library supports checking the current status, the history and also acting upon the alarm and its connected devices.

In version v2.0.0, some minor changes to how to use the library has been changed, which would be considered breaking changes to previous versions. In v2.0.0+ status has been split into two methods, info and status. Some of the response messages has also changed slightly. Should you upgrade to v2.0.0 and beyond, please make sure your solution still works. See new changelog at the bottom for additions and changes. Thank you.

• Multi-site support for sites connected to the same customer account
• Checking current status of alarm, annex and connected door locks
• History of arming/disarming the alarm
• Temperature readings from connected sensors
• Acting on your alarm. Support for arming, disarming and partial arming
• Acting on your annex alarm. Support for Arming and disarming.
• Lock and unlock your connected door locks

If you use this library in a country listed above as not verified, please drop me a note. You can visit Sector Alarm Group http://www.sectoralarm.com

npm install sectoralarm

const sectoralarm = require('sectoralarm');

const email = '<Your account email>',
      password = '<Your account password>',
      siteId = '<Your Panel/Site ID>',
      code = '<Code to use for arming/disarming>',
      lockId = '<The ID of one of your locks>',
      sensorId = '<The ID of one of your sensors>';

var settings = sectoralarm.createSettings();

settings.jsonOutput = false;

sectoralarm.connect(email,password,siteId, settings)
    .then(async (site) => {
        await site.info()
            .then(console.log);

        await site.status()
            .then(console.log);

        await site.history()
            .then(console.log);

        await site.temperatures()
            .then(console.log);

        await site.temperatures(sensorId)
            .then(console.log);

        await site.locks()
            .then(console.log);

        await site.locks(lockId)
            .then(console.log);

        await site.partialArm(code)
            .then(console.log);

        await site.disarm(code)
            .then(console.log);

        await site.arm(code)
            .then(console.log);

        await site.annexArm(code)
            .then(console.log);

        await site.annexDisarm(code)
            .then(console.log);

        await site.lock(lockId, code)
            .then(console.log);

        await site.unlock(lockId, code)
            .then(console.log);

    })
    .catch(error => {
        console.log(error.message);
        console.log(error.code);
    });

sectoralarm.connect(email,password,siteId)
    .then(site => {
        return site.status();
    })
    .then(console.log)
    .catch(error => {
        console.log(error.message);
        console.log(error.code);
    })

Example output from calling status

{ "siteId": "38728342",
  "name": "Home",
  "armedStatus": "disarmed",
  "partialArmingAvailable": true,
  "annexArmingAvailable": false,
  "annexArmedStatus": "unknown",
  "lastInteractionBy": "Code",
  "lastInteractionTime": "2018-11-30 06:20:35",
  "locksAvailable":false,
  "locks":[]}

NOTE: armedStatus can either be armed, partialArmed or disarmed and user can either be the user name, be empty or state Code (if a code was used to arm/disarm).

Example output from calling history

[ { "time": "2018-01-23 07:48:19", "action": "armed", "user": "Code" },
  { "time": "2018-01-22 16:45:52", "action": "disarmed", "user": "Code" },
  { "time": "2018-01-22 07:46:23", "action": "armed", "user": "Code" },
  { "time": "2018-01-20 15:14:18", "action": "disarmed", "user": "Code" },
  { "time": "2018-01-19 15:51:05", "action": "armed", "user": "" },
  { "time": "2018-01-19 15:50:46", "action": "disarmed", "user": "Code" },
  { "time": "2018-01-19 15:50:11", "action": "partialArmed", "user": "" },
  { "time": "2018-01-19 15:49:30", "action": "disarmed", "user": "Code" },
  { "time": "2018-01-13 11:45:57", "action": "armed", "user": "Code" },
  { "time": "2018-01-13 11:44:53", "action": "disarmed", "user": "Code" } ]

Example output from calling arm, partialArm, disarm, annexArm or annexDisarm

{ "status": "success", "name": "Home", "armedStatus": "disarmed" }

Example output from calling temperatures

{ "sensorId": "123", "name": "livingRoom", "temperature": "26" }

Thank you for those of you who have contributed to this project, put time and effort into adding features through pull requests or in other ways helped out during development.

• Fredrik (https://github.com/frli4797) - Temperature sensors and annex arming development
• Frank (https://github.com/frankis78) - Door Lock testing during development

I am currently looking for someone with cameras and smartplugs connected to a sector alarm site that want to help out with testing and/or development. Check the issue page and reply there.

• Security updates of underlying packages

• Version is now auto-detected during 'login', and will use that version until application is restarted, or another 'login' request is made.
• 'status', 'info' and 'temperatures' will now throw a ERR_INVALID_VERSION to indicate that sector alarm has updated their API. Other functions does not use version as of now.

• Fixed api version missmatch. Sector Alarm updated their API.
• Finland is now also a verified country for this library.

• Updated third-party libraries to pass npm security audit

• Breaking change in sector alarms api for info, status and temperatures has been resolved
• Resolved a bug that would throw a parser error for sites without any locks connected to it

• New 'info' method to get general information about he site, and all the connected devices.
• New 'locks' method gets the status of all locks connected to the alarm.
• New 'locks' method optionally allows to filter for a specific lock.
• Optional settings can now be supplied when connecting to a site.
• Setting to control the output format (json or javascript Object). Default is Json.
• Added 'createSettings' method to easily create the correct setting object.
• Added Skeleton methods 'cameras' and 'smartPlugs' added for future development, currently not supported.

• Calling 'status' no longer includes general information, use 'info' instead.
• Calling 'status' no longer includes lock status information, use 'locks' instead.
• Breaking change in 'temperatures' method as the output has changed some names.
• Calling 'temperatures' now optionally allows to filter for a specific sensor.

• Support for door locks. 'lock' and 'unlock' can be called with a code to act on the lock.
• Added notify support for change in annex alarm status.

• Support for temperature sensors connected to the alarm.

• Minor bug fixing.

• Support for arming/disarming the annex.

• Output is now proper json.

• Custom error, which can include the original error.

• Minor bug fixes.
• Resolved some errors in the test suite.