Node.js

In Node.js, you can integrate the SDK using @hackler/javascript-sdk.

If you are using @hackler/hackle-sdk, you need to migrate to @hackler/javascript-sdk.

Add SDK Dependency

npm

npm install --save @hackler/javascript-sdk

yarn

yarn add @hackler/javascript-sdk

SDK Initialization

hackleClient is the class that provides methods for using SDK features.

To use the SDK, you need to initialize hackleClient.

Instantiation

Instantiate hackleClient by passing the SDK Key. hackleClient periodically synchronizes with the Hackle server as a background task to obtain the necessary information.

• You can find the SDK Key in SDK Integration Info located inside the Hackle Service Dashboard.

const Hackle = require("@hackler/javascript-sdk");

// YOUR_SERVER_SDK_KEY 자리에 SDK 키를 넣습니다.
const hackleClient = Hackle.createInstance("YOUR_SERVER_SDK_KEY");

Initialization Complete

When the SDK is initialized, it fetches the necessary information from the Hackle server.

Initialization is performed asynchronously and you can receive the initialization completion callback via onReady.

If a user request arrives before the SDK is ready, data may be lost.

hackleClient.onReady(() => {
  // SDK ready to use
  http.createServer((req, res) => {

  }).listen(3000)
});

Shutdown

You must call the close() method when the application shuts down. This releases resources in use and sends any remaining events.

If the application shuts down without calling close(), events may be lost.

process.on('SIGINT', function() {
  // kill signal
  hackleClient.close();
});