NeXTSTEP Programming Mastermind
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »


    npm version CircleCI Coverage Status

    Javascript SDK for Kii Thing Interaction Framework.


    Build SDK

    Install NPM packages

    $ npm install

    Install typings

    $ npm install typings -g
    $ typings install

    Build SDK

    thing-if SDK is built as UMD(Universal Module Definition) library. So your code can load it either with CommonJS style, AMD style or script tag.

    Normal build

    Built with gulp command

    $ npm run build-src

    If succeeded, library file named thing-if.js is available under ./dist/ folder.

    Use thing-if in browser app

    Note: thing-if SDK uses global Promise, so if the browser doesn't support Promise( like Mircrosoft IE11), it needs to polyfill promise to the browser app.

    Basic operations of thing-if SDK are tested and passed on the following browsers: Mozilla Firefox 49.0.1, Safari 9.1.3, Chrome 53.0, and Microsoft Edge 38.

    1. Clone this repository
    $ git clone
    1. Bundle library using browserify.

    browserify bundles all the dependencies into a single file.

    $ cd thing-if-JSSDK
    $ npm install
    $ npm install browserify -g
    $ browserify . -s ThingIF > thing-if.js
    1. Include the bundle file in your browser app
    <!-- if the browser does not support promise, need to download polyfill promise library(i.e. and import like the following script -->
    <script src="path/to/promise.js"></script>
    <script src="path/to/thing-if.js"></script>


    Configure TestApp

    You need to configure TestApp as env variable for testing, the format is [app-id]:[app-key]:[JP|CN3|US|EU|SG]:[client-id]:[client-secret]

    $ export TestApp=[app-id]:[app-key]:[JP|CN3|US|EU|SG]:[client-id]:[client-secret]

    Run npm test

    $ npm test

    Use cases in nodejs

    Integrate with kii-cloud-sdk

    You usally need to get user id and token from kii-cloud-sdk, you can simply integrate it with thing-if SDK.

    mkdir MyApp
    cd MyApp
    npm install kii-cloud-sdk

    Copy thing-if.js in MyApp direcotry and create file named Onboarding.js in MyApp directory.

    "use strict"
    var kiicloud = require("kii-cloud-sdk").create();
    var thingIF = require('./thing-if.js');
    var appid = "****",
        appkey = "****",
        site = kiicloud.KiiSite.JP;
    kiicloud.Kii.initializeWithSite(appid, appkey, site);
    // an already registered kii user
    var username = "user-name";
    var pass = "pass";
    kiicloud.KiiUser.authenticate(username, pass).then(function (authedUser) {
        var token = authedUser.getAccessToken();
        var ownerId = authedUser.getID();
        var apiAuthor = new thingIF.APIAuthor(
            new thingIF.App(
        let onboardRequest = new thingIF.OnboardWithVendorThingIDRequest("vendorthing-id", "password", "USER:" + ownerId);
        return apiAuthor.onboardWithVendorThingID(onboardRequest);
    }).then(function (res) {
    }).catch(function (err) {

    Execute with node.

    node Onboarding.js

    onboard and send command to a thing

    Create file named Command.js in YourApp directory.

    var thingIF = require('./thing-if.js');
    // <Replace those values>
    var appID = "appID";
    var appKey = "appKey";
    var appSite = thingIF.Site.JP;
    var ownerToken = "owner-token";
    var ownerID = "owner-id";
    var vendorThingID = "th.myTest";
    var thingPassword = "password";
    // <Replace those values/>
    var app = new thingIF.App(appID, appKey, appSite);
    var apiAuthor = new thingIF.APIAuthor(ownerToken ,app);
    var onboardOptions = new thingIF.OnboardWithVendorThingIDRequest(vendorThingID, thingPassword, ownerID);
    // using promise
        var thingID = res.thingID;
        var commandOptions = new thingIF.PostCommandRequest(
            {turnPower:{power: true}},
            "issuer-id", // user id of issuer for this command
            "command-target-id" // thingID of thing to send this command
        return apiAuthor.postNewCommand(thingID, commandOptions);
        console.log("command created:"+command.commandID);
    // using callbacks
        function(err, res){
            if (err == null || err == undefined) {
                cosnole.log("onboard failed:" + err);
                // handling err
            var thingID = res.thingID;
            var commandOptions = new thingIF.PostCommandRequest(
                {turnPower:{power: true}},
                "issuer-id", // user id of issuer for this command
                "command-target-id" // thingID of thing to send this command
            apiAuthor.postNewCommand(thingID, commandOptions,
                function(err, command){
                    if (err == null || err == undefined) {
                        cosnole.log("post command failed:" + err);
                        // handling err
                    console.log("command created:"+command.commandID);

    Execute with node.

    node Command.js

    Use in Typescript Project

    • install thing-if SDK with npm
    npm install thing-if --save
    • install typings
    typings install npm:thing-if --save
    • add reference to your code
    /// <reference path="./typings/modules/thing-if/index.d.ts" />
    import * as ThingIFSDK from 'thing-if'


    thing-if-JSSDK is released under the Apache 2.0 license. See LICENSE for details.


    npm i thing-if

    Downloadsweekly downloads






    last publish


    • avatar