@clickroom/sdk-node 0.1.0

package/README.md

@@ -0,0 +1,49 @@
+# @clickroom/sdk-node
+
+Server-side event capture + local feature-flag evaluation for Node 22+. No autocapture — there's no
+DOM to observe server-side, so events are explicit `capture`/`identify` calls.
+
+```ts
+import { ClickroomClient } from '@clickroom/sdk-node'
+
+const clickroom = new ClickroomClient({
+  writeKey: process.env.CLICKROOM_WRITE_KEY!,
+  readKey: process.env.CLICKROOM_READ_KEY, // optional, required for feature flags
+  host: 'https://i.clickroom.co',
+})
+
+clickroom.capture({
+  distinctId: user.id, // required — no client-side persisted identity on the server
+  event: 'checkout_completed',
+  properties: { plan: 'pro', amount: 49 },
+})
+
+clickroom.identify({ distinctId: user.id, properties: { email: user.email, plan: 'pro' } })
+
+if (clickroom.isFeatureEnabled('new-checkout', user.id, { plan: 'pro' })) {
+  // ...
+}
+```
+
+## Flags
+
+Flags are evaluated **locally**: the client polls `GET /v1/flag-definitions` (requires `readKey`) on
+`flagPollInterval` (default 30s) and evaluates in-process using the same D-05 SHA1 hash as the
+browser SDK and the Rust evaluator — guaranteed identical results for the same `distinct_id`.
+
+## Error handling
+
+`capture()`/`identify()` events are batched and POSTed to `{host}/v1/capture`. If the server
+rejects a batch outright (HTTP 4xx other than 429, e.g. a schema-invalid event under strict
+validation), the client does **not** retry — retrying a request the server will never accept
+would just waste the retry budget. The batch is dropped and the failure is surfaced via
+`console.warn`, including the response body (e.g. `{ accepted, errors }`) when the server returns
+one. Network errors, `429` (rate limiting), and `5xx` responses are unaffected — the client
+retries those with its existing bounded exponential backoff (`maxRetries`, default 5).
+
+## Shutdown
+
+The client buffers events and flushes on size (`flushAt`, default 20) or interval (`flushInterval`,
+default 10s). It registers `SIGTERM`/`SIGINT`/`beforeExit` handlers to flush on process exit. In
+short-lived scripts (e.g. serverless handlers, CLI tools), call `await clickroom.shutdown()`
+explicitly before the process exits to guarantee delivery.

package/dist/flags.d.ts

@@ -0,0 +1,13 @@
+import { type FlagResult } from '@clickroom/sdk-js/eval';
+export interface FlagPollerOptions {
+    host: string;
+    readKey: string;
+    pollInterval: number;
+}
+export interface FlagPoller {
+    getFlag(key: string, distinctId: string, personProperties?: Record<string, unknown>): FlagResult;
+    getAllFlags(distinctId: string, personProperties?: Record<string, unknown>): Record<string, FlagResult>;
+    refresh(): Promise<void>;
+    shutdown(): void;
+}
+export declare function createFlagPoller(opts: FlagPollerOptions): FlagPoller;

package/dist/flags.js

@@ -0,0 +1,45 @@
+// @clickroom/sdk-node — local flag evaluation: poll `GET /flag-definitions`, evaluate in-process
+// with the shared D-05 hash (@clickroom/sdk-js/eval) for parity with the browser SDK + Rust.
+import { evaluate } from '@clickroom/sdk-js/eval';
+export function createFlagPoller(opts) {
+    let flags = [];
+    let interval = null;
+    const url = `${opts.host.replace(/\/+$/, '')}/v1/flag-definitions`;
+    const refresh = async () => {
+        try {
+            const res = await fetch(url, {
+                headers: { authorization: `Bearer ${opts.readKey}` },
+            });
+            if (!res.ok)
+                return; // keep last-known-good defs on failure
+            const body = (await res.json());
+            flags = body.flags ?? [];
+        }
+        catch {
+            // network/parse failure — keep whatever defs we already have
+        }
+    };
+    const getFlag = (key, distinctId, personProperties = {}) => {
+        const flag = flags.find((f) => f.key === key);
+        if (!flag)
+            return { enabled: false, variant: null, payload: null };
+        return evaluate(flag, distinctId, personProperties);
+    };
+    const getAllFlags = (distinctId, personProperties = {}) => {
+        const out = {};
+        for (const flag of flags) {
+            out[flag.key] = evaluate(flag, distinctId, personProperties);
+        }
+        return out;
+    };
+    const shutdown = () => {
+        if (interval !== null) {
+            clearInterval(interval);
+            interval = null;
+        }
+    };
+    interval = setInterval(() => void refresh(), opts.pollInterval);
+    interval.unref?.();
+    return { getFlag, getAllFlags, refresh, shutdown };
+}
+//# sourceMappingURL=flags.js.map

package/dist/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../src/flags.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,6FAA6F;AAE7F,OAAO,EAAE,QAAQ,EAA8B,MAAM,wBAAwB,CAAA;AAuB7E,MAAM,UAAU,gBAAgB,CAAC,IAAuB;IACtD,IAAI,KAAK,GAAW,EAAE,CAAA;IACtB,IAAI,QAAQ,GAA0C,IAAI,CAAA;IAE1D,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAA;IAElE,MAAM,OAAO,GAAG,KAAK,IAAmB,EAAE;QACxC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,OAAO,EAAE,EAAE;aACrD,CAAC,CAAA;YACF,IAAI,CAAC,GAAG,CAAC,EAAE;gBAAE,OAAM,CAAC,uCAAuC;YAC3D,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA4B,CAAA;YAC1D,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAA;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,6DAA6D;QAC/D,CAAC;IACH,CAAC,CAAA;IAED,MAAM,OAAO,GAAG,CACd,GAAW,EACX,UAAkB,EAClB,mBAA4C,EAAE,EAClC,EAAE;QACd,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;QAC7C,IAAI,CAAC,IAAI;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAClE,OAAO,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAA;IACrD,CAAC,CAAA;IAED,MAAM,WAAW,GAAG,CAClB,UAAkB,EAClB,mBAA4C,EAAE,EAClB,EAAE;QAC9B,MAAM,GAAG,GAA+B,EAAE,CAAA;QAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC9D,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,aAAa,CAAC,QAAQ,CAAC,CAAA;YACvB,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;IAED,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,KAAK,OAAO,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;IAC/D,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAA;IAElB,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAA;AACpD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { FlagResult } from '@clickroom/sdk-js/eval';
+import type { CaptureArgs, ClickroomNodeOptions, IdentifyArgs } from './types';
+export declare class ClickroomClient {
+    private readonly transport;
+    private readonly flagPoller;
+    private shuttingDown;
+    private readonly onSignal;
+    constructor(opts: ClickroomNodeOptions);
+    capture(args: CaptureArgs): void;
+    identify(args: IdentifyArgs): void;
+    isFeatureEnabled(key: string, distinctId: string, personProperties?: Record<string, unknown>): boolean;
+    getFeatureFlag(key: string, distinctId: string, personProperties?: Record<string, unknown>): boolean | string;
+    getFeatureFlagPayload(key: string, distinctId: string, personProperties?: Record<string, unknown>): unknown;
+    getAllFlags(distinctId: string, personProperties?: Record<string, unknown>): Record<string, FlagResult>;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+    private requireFlags;
+}
+export type { FlagResult } from '@clickroom/sdk-js/eval';
+export type { CaptureArgs, ClickroomNodeOptions, IdentifyArgs } from './types';

package/dist/index.js

@@ -0,0 +1,93 @@
+// @clickroom/sdk-node — server-side event capture + local flag evaluation.
+// No autocapture (no DOM to observe server-side) — capture/identify are explicit, distinct_id
+// is required per call (no client-side persisted identity like the browser SDK).
+import { createFlagPoller } from './flags';
+import { createTransport } from './transport';
+const DEFAULT_HOST = 'https://i.clickroom.co';
+const DEFAULT_FLUSH_AT = 20;
+const DEFAULT_FLUSH_INTERVAL = 10_000;
+const DEFAULT_MAX_RETRIES = 5;
+const DEFAULT_FLAG_POLL_INTERVAL = 30_000;
+export class ClickroomClient {
+    transport;
+    flagPoller;
+    shuttingDown = false;
+    onSignal;
+    constructor(opts) {
+        const host = opts.host ?? DEFAULT_HOST;
+        this.transport = createTransport({
+            host,
+            writeKey: opts.writeKey,
+            flushAt: opts.flushAt ?? DEFAULT_FLUSH_AT,
+            flushInterval: opts.flushInterval ?? DEFAULT_FLUSH_INTERVAL,
+            maxRetries: opts.maxRetries ?? DEFAULT_MAX_RETRIES,
+        });
+        this.flagPoller = opts.readKey
+            ? createFlagPoller({
+                host,
+                readKey: opts.readKey,
+                pollInterval: opts.flagPollInterval ?? DEFAULT_FLAG_POLL_INTERVAL,
+            })
+            : null;
+        void this.flagPoller?.refresh();
+        this.onSignal = () => {
+            void this.shutdown();
+        };
+        process.once('SIGTERM', this.onSignal);
+        process.once('SIGINT', this.onSignal);
+        process.once('beforeExit', this.onSignal);
+    }
+    capture(args) {
+        this.transport.enqueue({
+            event: args.event,
+            distinct_id: args.distinctId,
+            timestamp: toIso(args.timestamp),
+            properties: args.properties,
+        });
+    }
+    identify(args) {
+        this.transport.enqueue({
+            event: '$identify',
+            distinct_id: args.distinctId,
+            properties: { $set: args.properties },
+        });
+    }
+    isFeatureEnabled(key, distinctId, personProperties) {
+        return this.requireFlags().getFlag(key, distinctId, personProperties).enabled;
+    }
+    getFeatureFlag(key, distinctId, personProperties) {
+        const result = this.requireFlags().getFlag(key, distinctId, personProperties);
+        return result.variant ?? result.enabled;
+    }
+    getFeatureFlagPayload(key, distinctId, personProperties) {
+        return this.requireFlags().getFlag(key, distinctId, personProperties).payload;
+    }
+    getAllFlags(distinctId, personProperties) {
+        return this.requireFlags().getAllFlags(distinctId, personProperties);
+    }
+    async flush() {
+        await this.transport.flush();
+    }
+    async shutdown() {
+        if (this.shuttingDown)
+            return;
+        this.shuttingDown = true;
+        process.removeListener('SIGTERM', this.onSignal);
+        process.removeListener('SIGINT', this.onSignal);
+        process.removeListener('beforeExit', this.onSignal);
+        this.flagPoller?.shutdown();
+        await this.transport.shutdown();
+    }
+    requireFlags() {
+        if (!this.flagPoller) {
+            throw new Error('@clickroom/sdk-node: flags require `readKey` in ClickroomClient options');
+        }
+        return this.flagPoller;
+    }
+}
+const toIso = (ts) => {
+    if (ts === undefined)
+        return undefined;
+    return typeof ts === 'string' ? ts : ts.toISOString();
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -0,0 +1,14 @@
+import type { EventPayload } from './types';
+export interface TransportOptions {
+    host: string;
+    writeKey: string;
+    flushAt: number;
+    flushInterval: number;
+    maxRetries: number;
+}
+export interface Transport {
+    enqueue(event: EventPayload): void;
+    flush(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export declare function createTransport(opts: TransportOptions): Transport;

package/dist/transport.js

@@ -0,0 +1,90 @@
+// @clickroom/sdk-node — batching transport (POST /capture), bounded exponential-backoff retry.
+// Mirrors packages/sdk-js/src/transport.ts semantics, minus beacon/visibility (no DOM in Node).
+const BATCH_MAX = 100; // contracts/capture-api.md: <=100 events/batch
+const RETRY_BASE_MS = 1000;
+const RETRY_CAP_MS = 30_000;
+export function createTransport(opts) {
+    let buffer = [];
+    let interval = null;
+    const url = `${opts.host.replace(/\/+$/, '')}/v1/capture`;
+    // 4xx (other than 429, which is rate-limiting and retriable) means the
+    // server will never accept this batch as-is (e.g. schema-invalid events) —
+    // retrying is pointless. Surface it via console.warn (mirroring
+    // packages/sdk-js/src/transport.ts's equivalent behavior) instead of
+    // silently dropping it.
+    const reportRejection = async (res, batch) => {
+        let detail;
+        try {
+            detail = await res.json();
+        }
+        catch {
+            // Non-JSON or empty body — surface status only.
+        }
+        console.warn(`[clickroom] capture() batch rejected by server (HTTP ${res.status}); dropping ${batch.length} event(s)`, detail);
+    };
+    const sendBatch = async (batch) => {
+        let attempt = 0;
+        for (;;) {
+            try {
+                const res = await fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'content-type': 'application/json',
+                        authorization: `Bearer ${opts.writeKey}`,
+                    },
+                    body: JSON.stringify({ batch }),
+                });
+                if (res.ok)
+                    return;
+                if (res.status === 429 || res.status >= 500) {
+                    if (attempt >= opts.maxRetries)
+                        return; // drop after exhausting retries
+                    const retryAfter = Number(res.headers.get('retry-after'));
+                    const delay = Number.isFinite(retryAfter) && retryAfter >= 0
+                        ? retryAfter * 1000
+                        : Math.min(RETRY_BASE_MS * 2 ** attempt, RETRY_CAP_MS);
+                    await new Promise((r) => setTimeout(r, delay));
+                    attempt += 1;
+                    continue;
+                }
+                // 4xx other than 429 — permanent failure, do not retry.
+                await reportRejection(res, batch);
+                return;
+            }
+            catch {
+                if (attempt >= opts.maxRetries)
+                    return;
+                const delay = Math.min(RETRY_BASE_MS * 2 ** attempt, RETRY_CAP_MS);
+                await new Promise((r) => setTimeout(r, delay));
+                attempt += 1;
+            }
+        }
+    };
+    const flush = async () => {
+        if (buffer.length === 0)
+            return;
+        const pending = buffer;
+        buffer = [];
+        const chunks = [];
+        for (let i = 0; i < pending.length; i += BATCH_MAX) {
+            chunks.push(pending.slice(i, i + BATCH_MAX));
+        }
+        await Promise.all(chunks.map(sendBatch));
+    };
+    const enqueue = (event) => {
+        buffer.push(event);
+        if (buffer.length >= opts.flushAt)
+            void flush();
+    };
+    const shutdown = async () => {
+        if (interval !== null) {
+            clearInterval(interval);
+            interval = null;
+        }
+        await flush();
+    };
+    interval = setInterval(() => void flush(), opts.flushInterval);
+    interval.unref?.();
+    return { enqueue, flush, shutdown };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,32 @@
+export interface ClickroomNodeOptions {
+    /** Project write key — required for `/capture`. */
+    writeKey: string;
+    /** Project read key — required for local flag evaluation (`GET /flag-definitions`). */
+    readKey?: string;
+    /** API host, e.g. `https://i.clickroom.co`. */
+    host?: string;
+    /** Flush the event buffer once it reaches this many events. Default 20. */
+    flushAt?: number;
+    /** Flush the event buffer on this interval (ms). Default 10_000. */
+    flushInterval?: number;
+    /** Max retry attempts per failed batch before it is dropped. Default 5. */
+    maxRetries?: number;
+    /** Poll interval (ms) for `GET /flag-definitions`. Default 30_000. */
+    flagPollInterval?: number;
+}
+export interface EventPayload {
+    event: string;
+    distinct_id: string;
+    timestamp?: string;
+    properties?: Record<string, unknown>;
+}
+export interface CaptureArgs {
+    distinctId: string;
+    event: string;
+    properties?: Record<string, unknown>;
+    timestamp?: Date | string;
+}
+export interface IdentifyArgs {
+    distinctId: string;
+    properties: Record<string, unknown>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@clickroom/sdk-node",
+  "version": "0.1.0",
+  "description": "Node.js server SDK for Clickroom — product analytics, feature flags and experiments.",
+  "license": "MIT",
+  "homepage": "https://github.com/room-co/clickroom/tree/main/packages/sdk-node#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/room-co/clickroom.git",
+    "directory": "packages/sdk-node"
+  },
+  "bugs": {
+    "url": "https://github.com/room-co/clickroom/issues"
+  },
+  "keywords": [
+    "analytics",
+    "product-analytics",
+    "feature-flags",
+    "experiments",
+    "ab-testing",
+    "clickroom",
+    "node"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clickroom/sdk-js": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.20.0",
+    "typescript": "5.7.3",
+    "vitest": "^4.1.9",
+    "@clickroom/config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist"
+  }
+}