@lightsparkdev/lightspark-sdk 0.3.0 → 0.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lightsparkdev/lightspark-sdk",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Lightspark JS SDK",
   "author": "Lightspark Inc.",
   "keywords": [
@@ -63,12 +63,12 @@
     "format": "npx prettier --write ./src",
     "lint": "npx prettier --check ./src",
     "postversion": "yarn build",
-    "test": "tsc --noEmit --project tsconfig-test.json && jest --no-cache --runInBand --bail",
+    "test": "jest --no-cache --runInBand --bail",
     "type-check": "tsc --noEmit"
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@lightsparkdev/core": "0.3.0",
+    "@lightsparkdev/core": "0.3.1",
     "auto-bind": "^5.0.1",
     "crypto": "^1.0.1",
     "crypto-browserify": "^3.12.0",
@@ -81,11 +81,12 @@
   },
   "devDependencies": {
     "@types/crypto-js": "^4.1.1",
+    "@types/jest": "^29.5.2",
     "@types/ws": "^8.5.4",
-    "jest": "^29.4.1",
+    "jest": "^29.5.0",
     "prettier": "^2.8.4",
     "prettier-plugin-organize-imports": "^3.2.2",
-    "ts-jest": "^29.0.5",
+    "ts-jest": "^29.1.0",
     "ts-node": "^10.9.1",
     "tsconfig": "*",
     "typescript": "^4.9.5"

package/src/__tests__/webhooks.test.ts

@@ -0,0 +1,26 @@
+import WebhookEventType from "../objects/WebhookEventType.js";
+import { verify_and_parse_webhook } from "../webhooks.js";
+
+describe("Webhooks", () => {
+  test("should verify and parse webhook data", async () => {
+    const eventType = WebhookEventType.NODE_STATUS;
+    const eventId = "1615c8be5aa44e429eba700db2ed8ca5";
+    const entityId = "lightning_node:01882c25-157a-f96b-0000-362d42b64397";
+    const timeStamp = new Date("2023-05-17T23:56:47.874449+00:00");
+    const data = `{"event_type": "NODE_STATUS", "event_id": "1615c8be5aa44e429eba700db2ed8ca5", "timestamp": "2023-05-17T23:56:47.874449+00:00", "entity_id": "lightning_node:01882c25-157a-f96b-0000-362d42b64397"}`;
+    const hexdigest =
+      "62a8829aeb48b4142533520b1f7f86cdb1ee7d718bf3ea15bc1c662d4c453b74";
+    const webhookSecret = "3gZ5oQQUASYmqQNuEk0KambNMVkOADDItIJjzUlAWjX";
+
+    const webhook = await verify_and_parse_webhook(
+      new TextEncoder().encode(data),
+      hexdigest,
+      webhookSecret
+    );
+
+    expect(webhook.entity_id).toBe(entityId);
+    expect(webhook.event_id).toBe(eventId);
+    expect(webhook.event_type).toBe(eventType);
+    expect(webhook.timestamp).toEqual(timeStamp);
+  });
+});

package/src/index.ts

@@ -3,3 +3,4 @@
 export * from "./auth/index.js";
 export { default as LightsparkClient } from "./client.js";
 export * from "./objects/index.js";
+export * from "./webhooks.js";

package/src/webhooks.ts

@@ -0,0 +1,42 @@
+import { createHmac } from "crypto";
+import { WebhookEventType } from "./objects/WebhookEventType.js";
+
+export const WEBHOOKS_SIGNATURE_HEADER = "lightspark-signature";
+
+export interface WebhookEvent {
+  event_type: WebhookEventType;
+  event_id: string;
+  timestamp: Date;
+  entity_id: string;
+}
+
+export const verify_and_parse_webhook = (
+  data: Uint8Array,
+  hexdigest: string,
+  webhook_secret: string
+): Promise<WebhookEvent> => {
+  const sig = createHmac("sha256", webhook_secret).update(data).digest("hex");
+
+  if (sig.toLowerCase() !== hexdigest.toLowerCase()) {
+    throw new Error("Webhook message hash does not match signature");
+  }
+
+  return parse_webhook(data);
+};
+
+export const parse_webhook = async (
+  data: Uint8Array
+): Promise<WebhookEvent> => {
+  if (typeof TextDecoder === "undefined") {
+    const TextDecoder = (await import("text-encoding")).TextDecoder;
+  }
+  const dataStr = new TextDecoder().decode(data);
+  const event = JSON.parse(dataStr);
+
+  return {
+    event_type: WebhookEventType[event.event_type],
+    event_id: event.event_id,
+    timestamp: new Date(event.timestamp),
+    entity_id: event.entity_id,
+  };
+};