@inslytic/sdk-node 0.1.1

package/dist/index.d.mts

@@ -0,0 +1,41 @@
+type InslyticNodeConfig = {
+    apiKey: string;
+    endpoint?: string;
+    flushInterval?: number;
+    maxBatchSize?: number;
+    maxRetries?: number;
+};
+type NodeEventPayload = {
+    eventName: string;
+    userId?: string | null;
+    anonymousId: string;
+    sessionId?: string;
+    properties?: Record<string, string>;
+    timestamp?: string;
+    consentGiven?: boolean;
+};
+
+declare class InslyticNode {
+    private queue;
+    private timer;
+    private endpoint;
+    private apiKey;
+    private maxBatchSize;
+    private maxRetries;
+    private flushing;
+    private shutdownRequested;
+    private shutdownHandlers;
+    constructor(config: InslyticNodeConfig);
+    track(event: NodeEventPayload): void;
+    identify(userId: string, _traits?: Record<string, string>): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    get pending(): number;
+    private sendWithRetry;
+    private backoffMs;
+    private sleep;
+    private setupShutdownHandlers;
+    private removeShutdownHandlers;
+}
+
+export { InslyticNode, type InslyticNodeConfig, type NodeEventPayload };

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+type InslyticNodeConfig = {
+    apiKey: string;
+    endpoint?: string;
+    flushInterval?: number;
+    maxBatchSize?: number;
+    maxRetries?: number;
+};
+type NodeEventPayload = {
+    eventName: string;
+    userId?: string | null;
+    anonymousId: string;
+    sessionId?: string;
+    properties?: Record<string, string>;
+    timestamp?: string;
+    consentGiven?: boolean;
+};
+
+declare class InslyticNode {
+    private queue;
+    private timer;
+    private endpoint;
+    private apiKey;
+    private maxBatchSize;
+    private maxRetries;
+    private flushing;
+    private shutdownRequested;
+    private shutdownHandlers;
+    constructor(config: InslyticNodeConfig);
+    track(event: NodeEventPayload): void;
+    identify(userId: string, _traits?: Record<string, string>): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    get pending(): number;
+    private sendWithRetry;
+    private backoffMs;
+    private sleep;
+    private setupShutdownHandlers;
+    private removeShutdownHandlers;
+}
+
+export { InslyticNode, type InslyticNodeConfig, type NodeEventPayload };

package/dist/index.js

@@ -0,0 +1,156 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  InslyticNode: () => InslyticNode
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var DEFAULT_ENDPOINT = "https://api.inslytic.com";
+var DEFAULT_FLUSH_INTERVAL = 1e4;
+var DEFAULT_MAX_BATCH_SIZE = 20;
+var DEFAULT_MAX_RETRIES = 3;
+var InslyticNode = class {
+  queue = [];
+  timer = null;
+  endpoint;
+  apiKey;
+  maxBatchSize;
+  maxRetries;
+  flushing = false;
+  shutdownRequested = false;
+  shutdownHandlers = [];
+  constructor(config) {
+    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+    this.apiKey = config.apiKey;
+    this.maxBatchSize = config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+    this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const interval = config.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+    this.timer = setInterval(() => this.flush(), interval);
+    this.setupShutdownHandlers();
+  }
+  track(event) {
+    if (this.shutdownRequested) return;
+    this.queue.push({
+      eventName: event.eventName,
+      timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+      userId: event.userId ?? null,
+      anonymousId: event.anonymousId,
+      sessionId: event.sessionId ?? "",
+      consentGiven: event.consentGiven ?? true,
+      properties: event.properties ?? {},
+      pageUrl: "",
+      pageTitle: "",
+      referrer: "",
+      utmSource: null,
+      utmMedium: null,
+      utmCampaign: null
+    });
+    if (this.queue.length >= this.maxBatchSize) {
+      this.flush();
+    }
+  }
+  identify(userId, _traits) {
+    this.track({
+      eventName: "$identify",
+      userId,
+      anonymousId: userId,
+      consentGiven: true
+    });
+  }
+  async flush() {
+    if (this.queue.length === 0 || this.flushing) return;
+    this.flushing = true;
+    try {
+      while (this.queue.length > 0) {
+        const batch = this.queue.splice(0, this.maxBatchSize);
+        await this.sendWithRetry(batch);
+      }
+    } finally {
+      this.flushing = false;
+    }
+  }
+  async shutdown() {
+    this.shutdownRequested = true;
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.removeShutdownHandlers();
+    await this.flush();
+  }
+  get pending() {
+    return this.queue.length;
+  }
+  async sendWithRetry(batch) {
+    const url = `${this.endpoint}/v1/ingest`;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const response = await fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.apiKey}`
+          },
+          body: JSON.stringify({ events: batch })
+        });
+        if (response.ok || response.status < 500) {
+          return;
+        }
+        if (attempt < this.maxRetries) {
+          await this.sleep(this.backoffMs(attempt));
+        }
+      } catch {
+        if (attempt < this.maxRetries) {
+          await this.sleep(this.backoffMs(attempt));
+        }
+      }
+    }
+    this.queue.unshift(...batch);
+  }
+  backoffMs(attempt) {
+    return Math.min(1e3 * 2 ** attempt, 3e4);
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  setupShutdownHandlers() {
+    if (typeof process === "undefined") return;
+    const handler = () => {
+      this.shutdown();
+    };
+    for (const signal of ["SIGTERM", "SIGINT"]) {
+      process.on(signal, handler);
+      this.shutdownHandlers.push(() => process.removeListener(signal, handler));
+    }
+  }
+  removeShutdownHandlers() {
+    for (const remove of this.shutdownHandlers) {
+      remove();
+    }
+    this.shutdownHandlers = [];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InslyticNode
+});

package/dist/index.mjs

@@ -0,0 +1,129 @@
+// src/client.ts
+var DEFAULT_ENDPOINT = "https://api.inslytic.com";
+var DEFAULT_FLUSH_INTERVAL = 1e4;
+var DEFAULT_MAX_BATCH_SIZE = 20;
+var DEFAULT_MAX_RETRIES = 3;
+var InslyticNode = class {
+  queue = [];
+  timer = null;
+  endpoint;
+  apiKey;
+  maxBatchSize;
+  maxRetries;
+  flushing = false;
+  shutdownRequested = false;
+  shutdownHandlers = [];
+  constructor(config) {
+    this.endpoint = config.endpoint ?? DEFAULT_ENDPOINT;
+    this.apiKey = config.apiKey;
+    this.maxBatchSize = config.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+    this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const interval = config.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+    this.timer = setInterval(() => this.flush(), interval);
+    this.setupShutdownHandlers();
+  }
+  track(event) {
+    if (this.shutdownRequested) return;
+    this.queue.push({
+      eventName: event.eventName,
+      timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+      userId: event.userId ?? null,
+      anonymousId: event.anonymousId,
+      sessionId: event.sessionId ?? "",
+      consentGiven: event.consentGiven ?? true,
+      properties: event.properties ?? {},
+      pageUrl: "",
+      pageTitle: "",
+      referrer: "",
+      utmSource: null,
+      utmMedium: null,
+      utmCampaign: null
+    });
+    if (this.queue.length >= this.maxBatchSize) {
+      this.flush();
+    }
+  }
+  identify(userId, _traits) {
+    this.track({
+      eventName: "$identify",
+      userId,
+      anonymousId: userId,
+      consentGiven: true
+    });
+  }
+  async flush() {
+    if (this.queue.length === 0 || this.flushing) return;
+    this.flushing = true;
+    try {
+      while (this.queue.length > 0) {
+        const batch = this.queue.splice(0, this.maxBatchSize);
+        await this.sendWithRetry(batch);
+      }
+    } finally {
+      this.flushing = false;
+    }
+  }
+  async shutdown() {
+    this.shutdownRequested = true;
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.removeShutdownHandlers();
+    await this.flush();
+  }
+  get pending() {
+    return this.queue.length;
+  }
+  async sendWithRetry(batch) {
+    const url = `${this.endpoint}/v1/ingest`;
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const response = await fetch(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${this.apiKey}`
+          },
+          body: JSON.stringify({ events: batch })
+        });
+        if (response.ok || response.status < 500) {
+          return;
+        }
+        if (attempt < this.maxRetries) {
+          await this.sleep(this.backoffMs(attempt));
+        }
+      } catch {
+        if (attempt < this.maxRetries) {
+          await this.sleep(this.backoffMs(attempt));
+        }
+      }
+    }
+    this.queue.unshift(...batch);
+  }
+  backoffMs(attempt) {
+    return Math.min(1e3 * 2 ** attempt, 3e4);
+  }
+  sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  setupShutdownHandlers() {
+    if (typeof process === "undefined") return;
+    const handler = () => {
+      this.shutdown();
+    };
+    for (const signal of ["SIGTERM", "SIGINT"]) {
+      process.on(signal, handler);
+      this.shutdownHandlers.push(() => process.removeListener(signal, handler));
+    }
+  }
+  removeShutdownHandlers() {
+    for (const remove of this.shutdownHandlers) {
+      remove();
+    }
+    this.shutdownHandlers = [];
+  }
+};
+export {
+  InslyticNode
+};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@inslytic/sdk-node",
+  "version": "0.1.1",
+  "description": "Node.js server-side SDK for Inslytic — AI-powered product analytics",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/inslytic/inslytic",
+    "directory": "packages/sdk-node"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "product-analytics",
+    "node",
+    "server-side",
+    "inslytic"
+  ],
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo node_modules"
+  }
+}