kohi-node

Node.js SDK for Kohi.

Install

npm install kohi-node

Quick Start

import kohi from "kohi-node";

const { expressMiddleware } = kohi.init({
  projectKey: process.env.KOHI_PROJECT_KEY!,
  secretKey: process.env.KOHI_SECRET_KEY!,
});

app.use(expressMiddleware());

For Next.js route handlers or the App Router bootstrap:

import kohi from "kohi-node";

kohi.init({
  projectKey: process.env.KOHI_PROJECT_KEY!,
  secretKey: process.env.KOHI_SECRET_KEY!,
}).instrumentNextJs();

Behavior

• Batches events in memory, default batchSize=100, flushIntervalMs=5000
• Retries retryable 408, 429, and 5xx responses up to 3 times with backoff
• Caps the in-memory queue at 5000 events and drops new events when full
• Redacts common secret fields and masks email addresses before sending
• Adds X-Project-Key and HMAC-SHA256 X-Signature over the gzipped payload