@splithub/node 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,45 @@
1
- # Temporary Holding Version
1
+ # @splithub/node
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Self-hosted ingest and results for SplitHub. One fetch-style handler that
4
+ works in Next.js route handlers, Remix, Hono, Bun, Deno and plain Node.
5
+
6
+ ```ts
7
+ import { createSplitHubHandler, toNodeListener } from '@splithub/node';
8
+ import { sqliteStore } from '@splithub/adapter-sqlite';
9
+ import config from './splithub.config';
10
+
11
+ const handler = createSplitHubHandler({
12
+ config,
13
+ store: sqliteStore({ file: './splithub.db' }),
14
+ adminToken: process.env.SPLITHUB_ADMIN_TOKEN, // protects GET endpoints
15
+ });
16
+
17
+ // Next.js app router: export const POST = handler; export const GET = handler;
18
+ // Express / Vite / http: app.use('/api/splithub', toNodeListener(handler));
19
+ ```
20
+
21
+ Routes relative to the mount path:
22
+
23
+ | Method | Path | Purpose |
24
+ |---|---|---|
25
+ | POST | `/` | Ingest an event batch from the SDK |
26
+ | GET | `/status` | All experiments with counts and a verdict headline |
27
+ | GET | `/results/:id` | Full verdict for one experiment |
28
+ | GET | `/health` | Liveness |
29
+
30
+ ## Bring your own database
31
+
32
+ Implement the `Store` interface (three methods) against Postgres, Supabase,
33
+ Prisma, Mongo, anything:
34
+
35
+ ```ts
36
+ interface Store {
37
+ insertEvents(events: StoredEvent[]): Promise<number>; // ignore duplicate ids
38
+ variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;
39
+ summaries(): Promise<ExperimentSummary[]>;
40
+ }
41
+ ```
42
+
43
+ Attribution rule for `variantCounts`: a visitor converts for a variant when
44
+ they sent the goal at or after their first exposure to that variant. Unit is
45
+ the unique visitor. `createMemoryStore()` is a reference implementation.
package/dist/index.cjs ADDED
@@ -0,0 +1,312 @@
1
+ "use strict";
2
+ var __defProp = Object.defineProperty;
3
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
+ var __getOwnPropNames = Object.getOwnPropertyNames;
5
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
6
+ var __export = (target, all) => {
7
+ for (var name in all)
8
+ __defProp(target, name, { get: all[name], enumerable: true });
9
+ };
10
+ var __copyProps = (to, from, except, desc) => {
11
+ if (from && typeof from === "object" || typeof from === "function") {
12
+ for (let key of __getOwnPropNames(from))
13
+ if (!__hasOwnProp.call(to, key) && key !== except)
14
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
+ }
16
+ return to;
17
+ };
18
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
+
20
+ // src/index.ts
21
+ var index_exports = {};
22
+ __export(index_exports, {
23
+ bestOf: () => bestOf,
24
+ createMemoryStore: () => createMemoryStore,
25
+ createSplitHubHandler: () => createSplitHubHandler,
26
+ experimentResults: () => experimentResults,
27
+ headlineFor: () => headlineFor,
28
+ statusTable: () => statusTable,
29
+ toNodeListener: () => toNodeListener,
30
+ validateBatch: () => validateBatch
31
+ });
32
+ module.exports = __toCommonJS(index_exports);
33
+
34
+ // src/results.ts
35
+ var import_core = require("@splithub/core");
36
+ var import_stats = require("@splithub/stats");
37
+ async function experimentResults(config, store, key) {
38
+ const experiment = (0, import_core.getExperiment)(config, key);
39
+ if (!experiment) return null;
40
+ const goal = experiment.goal;
41
+ const observed = goal ? await store.variantCounts(key, goal) : [];
42
+ const counts = experiment.variants.map((v) => {
43
+ const row = observed.find((o) => o.variant === v.key);
44
+ return { variant: v.key, exposures: row?.exposures ?? 0, conversions: row?.conversions ?? 0, revenue: row?.revenue ?? 0 };
45
+ });
46
+ const verdict = goal ? (0, import_stats.computeVerdict)(key, counts, { expectedWeights: experiment.variants.map((v) => v.weight) }) : { ...(0, import_stats.computeVerdict)(key, [], {}), message: "No goal configured for this experiment; add `goal` in splithub.config.ts." };
47
+ return { experiment: key, kind: experiment.kind, status: experiment.status, goal, description: experiment.description, verdict };
48
+ }
49
+ async function statusTable(config, store) {
50
+ const summaries = await store.summaries();
51
+ const byKey = new Map(summaries.map((s) => [s.experiment, s]));
52
+ const rows = [];
53
+ for (const exp of config.experiments) {
54
+ const s = byKey.get(exp.key);
55
+ const days = s?.firstExposureAt && s.lastExposureAt ? Math.max(1, Math.ceil((s.lastExposureAt - s.firstExposureAt) / 864e5)) : 0;
56
+ let verdict = null;
57
+ let headline = null;
58
+ let best = null;
59
+ if (exp.goal && s) {
60
+ const r = await experimentResults(config, store, exp.key);
61
+ verdict = r?.verdict.status ?? null;
62
+ headline = r ? headlineFor(r.verdict) : null;
63
+ best = r ? bestOf(r.verdict) : null;
64
+ }
65
+ rows.push({ experiment: exp.key, kind: exp.kind, status: exp.status, goal: exp.goal, description: exp.description ?? null, exposures: s?.exposures ?? 0, visitors: s?.visitors ?? 0, days, verdict, headline, best });
66
+ }
67
+ return rows;
68
+ }
69
+ function bestOf(v) {
70
+ const best = v.comparisons.slice().sort((a, b) => b.absoluteLift - a.absoluteLift)[0];
71
+ const name = v.winner ?? best?.variant;
72
+ if (!name) return null;
73
+ const cmp = best && best.variant === name ? best : v.comparisons.find((c) => c.variant === name);
74
+ return { variant: name, index: v.sample.variants.findIndex((x) => x.variant === name) + 1, lift: cmp?.relativeLift ?? null };
75
+ }
76
+ function headlineFor(v) {
77
+ const best = bestOf(v);
78
+ const lift = best?.lift != null ? `${best.lift >= 0 ? "+" : ""}${(best.lift * 100).toFixed(1)}%` : "";
79
+ switch (v.status) {
80
+ case "winner_found":
81
+ return `#${best?.index ?? "?"} wins ${lift}`.trim();
82
+ case "insufficient_sample":
83
+ return best ? `#${best.index} ${lift} (too early)` : "too early";
84
+ case "srm_detected":
85
+ return "SRM! check setup";
86
+ case "no_significant_difference":
87
+ return "no difference";
88
+ default:
89
+ return "no data";
90
+ }
91
+ }
92
+
93
+ // src/validate.ts
94
+ var ID = /^[a-z0-9_-]{8,64}$/i;
95
+ var KEY = /^[a-z0-9][a-z0-9_-]{0,63}$/;
96
+ var MAX_EVENTS = 500;
97
+ var MAX_PROPS_BYTES = 4096;
98
+ var MAX_SKEW_MS = 7 * 24 * 60 * 60 * 1e3;
99
+ function validateBatch(body, expectedProject, now = Date.now()) {
100
+ if (!body || typeof body !== "object") return { ok: false, error: "body must be a JSON object" };
101
+ const batch = body;
102
+ if (typeof batch.project !== "string") return { ok: false, error: '"project" must be a string' };
103
+ if (expectedProject !== null && batch.project !== expectedProject) return { ok: false, error: `unknown project "${batch.project}"` };
104
+ if (!Array.isArray(batch.events)) return { ok: false, error: '"events" must be an array' };
105
+ if (batch.events.length === 0) return { ok: true, events: [] };
106
+ if (batch.events.length > MAX_EVENTS) return { ok: false, error: `too many events (max ${MAX_EVENTS})` };
107
+ const out = [];
108
+ for (const raw of batch.events) {
109
+ const e = normalize(raw, now);
110
+ if (typeof e === "string") return { ok: false, error: e };
111
+ out.push(e);
112
+ }
113
+ return { ok: true, events: out };
114
+ }
115
+ function normalize(e, now) {
116
+ if (!e || typeof e !== "object") return "event must be an object";
117
+ if (typeof e.id !== "string" || !ID.test(e.id)) return "event.id is invalid";
118
+ if (typeof e.vid !== "string" || e.vid.length === 0 || e.vid.length > 64) return "event.vid is invalid";
119
+ if (typeof e.sid !== "string" || e.sid.length === 0 || e.sid.length > 64) return "event.sid is invalid";
120
+ if (typeof e.ts !== "number" || !Number.isFinite(e.ts)) return "event.ts must be a number";
121
+ const ts = Math.abs(e.ts - now) > MAX_SKEW_MS ? now : Math.round(e.ts);
122
+ const url = typeof e.url === "string" ? e.url.slice(0, 512) : null;
123
+ if (e.type === "exposure") {
124
+ if (typeof e.exp !== "string" || !KEY.test(e.exp)) return "exposure.exp is invalid";
125
+ if (typeof e.var !== "string" || !KEY.test(e.var)) return "exposure.var is invalid";
126
+ return { id: e.id, type: "exposure", experiment: e.exp, variant: e.var, goal: null, visitorId: e.vid, sessionId: e.sid, ts, url, props: null, receivedAt: now };
127
+ }
128
+ if (e.type === "goal") {
129
+ if (typeof e.goal !== "string" || !KEY.test(e.goal)) return "goal.goal is invalid";
130
+ let props = null;
131
+ if (e.props !== void 0) {
132
+ if (!e.props || typeof e.props !== "object" || Array.isArray(e.props)) return "goal.props must be an object";
133
+ if (JSON.stringify(e.props).length > MAX_PROPS_BYTES) return "goal.props too large";
134
+ props = e.props;
135
+ }
136
+ return { id: e.id, type: "goal", experiment: null, variant: null, goal: e.goal, visitorId: e.vid, sessionId: e.sid, ts, url, props, receivedAt: now };
137
+ }
138
+ return `unknown event type "${String(e.type)}"`;
139
+ }
140
+
141
+ // src/handler.ts
142
+ function createSplitHubHandler(options) {
143
+ const { config, store } = options;
144
+ const corsHeaders = (request) => {
145
+ if (!options.cors) return {};
146
+ const origin = request.headers.get("origin") ?? "";
147
+ const allowed = options.cors === "*" ? "*" : options.cors.includes(origin) ? origin : "";
148
+ if (!allowed) return {};
149
+ return {
150
+ "access-control-allow-origin": allowed,
151
+ "access-control-allow-methods": "GET, POST, OPTIONS",
152
+ "access-control-allow-headers": "content-type, authorization",
153
+ "access-control-max-age": "86400"
154
+ };
155
+ };
156
+ const json = (request, body, status = 200) => new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json", ...corsHeaders(request) } });
157
+ const authorized = (request) => {
158
+ if (!options.adminToken) return true;
159
+ const header = request.headers.get("authorization") ?? "";
160
+ return header === `Bearer ${options.adminToken}`;
161
+ };
162
+ return async (request) => {
163
+ const url = new URL(request.url);
164
+ const path = url.pathname.replace(/\/+$/, "");
165
+ const tail = path.split("/").slice(-2);
166
+ if (request.method === "OPTIONS") return new Response(null, { status: 204, headers: corsHeaders(request) });
167
+ if (request.method === "POST") {
168
+ let body;
169
+ try {
170
+ body = await request.json();
171
+ } catch {
172
+ return json(request, { error: "invalid JSON" }, 400);
173
+ }
174
+ const result = validateBatch(body, config.project);
175
+ if (!result.ok) return json(request, { error: result.error }, 400);
176
+ const inserted = await store.insertEvents(result.events);
177
+ return json(request, { ok: true, received: result.events.length, inserted }, 202);
178
+ }
179
+ if (request.method === "GET") {
180
+ if (tail[1] === "health") return json(request, { ok: true, project: config.project });
181
+ if (!authorized(request)) return json(request, { error: "unauthorized" }, 401);
182
+ if (tail[1] === "status") return json(request, { project: config.project, experiments: await statusTable(config, store) });
183
+ if (tail[0] === "results" && tail[1]) {
184
+ const r = await experimentResults(config, store, tail[1]);
185
+ return r ? json(request, r) : json(request, { error: `unknown experiment "${tail[1]}"` }, 404);
186
+ }
187
+ }
188
+ return json(request, { error: "not found" }, 404);
189
+ };
190
+ }
191
+
192
+ // src/nodeAdapter.ts
193
+ function toNodeListener(handler) {
194
+ return (req, res) => {
195
+ void (async () => {
196
+ try {
197
+ const request = await toRequest(req);
198
+ const response = await handler(request);
199
+ res.statusCode = response.status;
200
+ response.headers.forEach((value, key) => res.setHeader(key, value));
201
+ const body = response.body ? Buffer.from(await response.arrayBuffer()) : null;
202
+ res.end(body);
203
+ } catch (error) {
204
+ res.statusCode = 500;
205
+ res.setHeader("content-type", "application/json");
206
+ res.end(JSON.stringify({ error: error instanceof Error ? error.message : "internal error" }));
207
+ }
208
+ })();
209
+ };
210
+ }
211
+ async function toRequest(req) {
212
+ const host = req.headers.host ?? "localhost";
213
+ const proto = req.headers["x-forwarded-proto"] ?? "http";
214
+ const rawUrl = req.originalUrl ?? req.url ?? "/";
215
+ const url = new URL(rawUrl, `${proto}://${host}`);
216
+ const headers = new Headers();
217
+ for (const [key, value] of Object.entries(req.headers)) {
218
+ if (Array.isArray(value)) value.forEach((v) => headers.append(key, v));
219
+ else if (typeof value === "string") headers.set(key, value);
220
+ }
221
+ const method = req.method ?? "GET";
222
+ let body;
223
+ if (method !== "GET" && method !== "HEAD") {
224
+ const chunks = [];
225
+ for await (const chunk of req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
226
+ body = Buffer.concat(chunks);
227
+ }
228
+ return new Request(url, { method, headers, body });
229
+ }
230
+
231
+ // src/store.ts
232
+ function createMemoryStore() {
233
+ const events = [];
234
+ const ids = /* @__PURE__ */ new Set();
235
+ return {
236
+ events,
237
+ async insertEvents(batch) {
238
+ let n = 0;
239
+ for (const e of batch) {
240
+ if (ids.has(e.id)) continue;
241
+ ids.add(e.id);
242
+ events.push(e);
243
+ n++;
244
+ }
245
+ return n;
246
+ },
247
+ async variantCounts(experiment, goal) {
248
+ const firstExposure = /* @__PURE__ */ new Map();
249
+ for (const e of events) {
250
+ if (e.type !== "exposure" || e.experiment !== experiment || !e.variant) continue;
251
+ const byVisitor = firstExposure.get(e.variant) ?? /* @__PURE__ */ new Map();
252
+ const prev = byVisitor.get(e.visitorId);
253
+ if (prev === void 0 || e.ts < prev) byVisitor.set(e.visitorId, e.ts);
254
+ firstExposure.set(e.variant, byVisitor);
255
+ }
256
+ const goalsByVisitor = /* @__PURE__ */ new Map();
257
+ for (const e of events) {
258
+ if (e.type !== "goal" || e.goal !== goal) continue;
259
+ const list = goalsByVisitor.get(e.visitorId) ?? [];
260
+ const revenue = typeof e.props?.revenue === "number" ? e.props.revenue : 0;
261
+ list.push({ ts: e.ts, revenue });
262
+ goalsByVisitor.set(e.visitorId, list);
263
+ }
264
+ const out = [];
265
+ for (const [variant, byVisitor] of firstExposure) {
266
+ let conversions = 0;
267
+ let revenue = 0;
268
+ for (const [visitor, first] of byVisitor) {
269
+ const goals = (goalsByVisitor.get(visitor) ?? []).filter((g) => g.ts >= first);
270
+ if (goals.length > 0) {
271
+ conversions++;
272
+ revenue += goals.reduce((s, g) => s + g.revenue, 0);
273
+ }
274
+ }
275
+ out.push({ variant, exposures: byVisitor.size, conversions, revenue });
276
+ }
277
+ return out;
278
+ },
279
+ async summaries() {
280
+ const map = /* @__PURE__ */ new Map();
281
+ for (const e of events) {
282
+ if (e.type !== "exposure" || !e.experiment) continue;
283
+ const s = map.get(e.experiment) ?? {
284
+ experiment: e.experiment,
285
+ exposures: 0,
286
+ visitors: 0,
287
+ firstExposureAt: null,
288
+ lastExposureAt: null,
289
+ visitorSet: /* @__PURE__ */ new Set()
290
+ };
291
+ s.exposures++;
292
+ s.visitorSet.add(e.visitorId);
293
+ s.firstExposureAt = s.firstExposureAt === null ? e.ts : Math.min(s.firstExposureAt, e.ts);
294
+ s.lastExposureAt = s.lastExposureAt === null ? e.ts : Math.max(s.lastExposureAt, e.ts);
295
+ map.set(e.experiment, s);
296
+ }
297
+ return [...map.values()].map(({ visitorSet, ...s }) => ({ ...s, visitors: visitorSet.size }));
298
+ }
299
+ };
300
+ }
301
+ // Annotate the CommonJS export names for ESM import in node:
302
+ 0 && (module.exports = {
303
+ bestOf,
304
+ createMemoryStore,
305
+ createSplitHubHandler,
306
+ experimentResults,
307
+ headlineFor,
308
+ statusTable,
309
+ toNodeListener,
310
+ validateBatch
311
+ });
312
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/index.ts","../src/results.ts","../src/validate.ts","../src/handler.ts","../src/nodeAdapter.ts","../src/store.ts"],"sourcesContent":["export { createSplitHubHandler } from './handler';\nexport type { HandlerOptions, FetchHandler } from './handler';\nexport { toNodeListener } from './nodeAdapter';\nexport { createMemoryStore } from './store';\nexport type { Store, StoredEvent, ExperimentSummary } from './store';\nexport { experimentResults, statusTable, headlineFor, bestOf } from './results';\nexport type { ExperimentResults, StatusRow } from './results';\nexport { validateBatch } from './validate';\n","import { getExperiment, type SplitHubConfig } from '@splithub/core';\nimport { computeVerdict, type VariantCounts, type Verdict } from '@splithub/stats';\nimport type { ExperimentSummary, Store } from './store';\n\nexport interface ExperimentResults {\n experiment: string;\n kind: string;\n status: string;\n goal: string | null;\n description: string | null;\n verdict: Verdict;\n}\n\nexport interface StatusRow {\n experiment: string;\n kind: string;\n status: string;\n goal: string | null;\n description: string | null;\n exposures: number;\n visitors: number;\n days: number;\n verdict: Verdict['status'] | null;\n /** Short text for tables: \"#2 wins +15.9%\", \"#2 +3.1% (too early)\", \"no difference\", \"SRM! check setup\", \"no data\". Ordinals, not names: variant names can be long. */\n headline: string | null;\n /** Leading variant: its name, its ordinal in the declared order (#1 is the control) and the relative lift. */\n best: { variant: string; index: number; lift: number | null } | null;\n}\n\nexport async function experimentResults(config: SplitHubConfig, store: Store, key: string): Promise<ExperimentResults | null> {\n const experiment = getExperiment(config, key);\n if (!experiment) return null;\n const goal = experiment.goal;\n const observed = goal ? await store.variantCounts(key, goal) : [];\n // Align to config order so the control is first and silent variants show as 0.\n const counts: VariantCounts[] = experiment.variants.map((v) => {\n const row = observed.find((o) => o.variant === v.key);\n return { variant: v.key, exposures: row?.exposures ?? 0, conversions: row?.conversions ?? 0, revenue: row?.revenue ?? 0 };\n });\n const verdict = goal\n ? computeVerdict(key, counts, { expectedWeights: experiment.variants.map((v) => v.weight) })\n : { ...computeVerdict(key, [], {}), message: 'No goal configured for this experiment; add `goal` in splithub.config.ts.' };\n return { experiment: key, kind: experiment.kind, status: experiment.status, goal, description: experiment.description, verdict };\n}\n\nexport async function statusTable(config: SplitHubConfig, store: Store): Promise<StatusRow[]> {\n const summaries = await store.summaries();\n const byKey = new Map<string, ExperimentSummary>(summaries.map((s) => [s.experiment, s]));\n const rows: StatusRow[] = [];\n for (const exp of config.experiments) {\n const s = byKey.get(exp.key);\n const days = s?.firstExposureAt && s.lastExposureAt ? Math.max(1, Math.ceil((s.lastExposureAt - s.firstExposureAt) / 86_400_000)) : 0;\n let verdict: Verdict['status'] | null = null;\n let headline: string | null = null;\n let best: StatusRow['best'] = null;\n if (exp.goal && s) {\n const r = await experimentResults(config, store, exp.key);\n verdict = r?.verdict.status ?? null;\n headline = r ? headlineFor(r.verdict) : null;\n best = r ? bestOf(r.verdict) : null;\n }\n rows.push({ experiment: exp.key, kind: exp.kind, status: exp.status, goal: exp.goal, description: exp.description ?? null, exposures: s?.exposures ?? 0, visitors: s?.visitors ?? 0, days, verdict, headline, best });\n }\n return rows;\n}\n\n/** The leading variant of a verdict with its ordinal (#1 is the control, in declared order). */\nexport function bestOf(v: Verdict): StatusRow['best'] {\n const best = v.comparisons.slice().sort((a, b) => b.absoluteLift - a.absoluteLift)[0];\n const name = v.winner ?? best?.variant;\n if (!name) return null;\n const cmp = best && best.variant === name ? best : v.comparisons.find((c) => c.variant === name);\n return { variant: name, index: v.sample.variants.findIndex((x) => x.variant === name) + 1, lift: cmp?.relativeLift ?? null };\n}\n\nexport function headlineFor(v: Verdict): string {\n const best = bestOf(v);\n const lift = best?.lift != null ? `${best.lift >= 0 ? '+' : ''}${(best.lift * 100).toFixed(1)}%` : '';\n switch (v.status) {\n case 'winner_found':\n return `#${best?.index ?? '?'} wins ${lift}`.trim();\n case 'insufficient_sample':\n return best ? `#${best.index} ${lift} (too early)` : 'too early';\n case 'srm_detected':\n return 'SRM! check setup';\n case 'no_significant_difference':\n return 'no difference';\n default:\n return 'no data';\n }\n}\n","import type { EventBatch, SplitHubEvent } from '@splithub/core';\nimport type { StoredEvent } from './store';\n\nconst ID = /^[a-z0-9_-]{8,64}$/i;\nconst KEY = /^[a-z0-9][a-z0-9_-]{0,63}$/;\nconst MAX_EVENTS = 500;\nconst MAX_PROPS_BYTES = 4096;\n/** Reject client timestamps more than this far from the server clock. */\nconst MAX_SKEW_MS = 7 * 24 * 60 * 60 * 1000;\n\nexport type ValidationResult = { ok: true; events: StoredEvent[] } | { ok: false; error: string };\n\n/** `expectedProject` null skips the name check (the caller already identified the project, e.g. by public key). */\nexport function validateBatch(body: unknown, expectedProject: string | null, now = Date.now()): ValidationResult {\n if (!body || typeof body !== 'object') return { ok: false, error: 'body must be a JSON object' };\n const batch = body as Partial<EventBatch>;\n if (typeof batch.project !== 'string') return { ok: false, error: '\"project\" must be a string' };\n if (expectedProject !== null && batch.project !== expectedProject) return { ok: false, error: `unknown project \"${batch.project}\"` };\n if (!Array.isArray(batch.events)) return { ok: false, error: '\"events\" must be an array' };\n if (batch.events.length === 0) return { ok: true, events: [] };\n if (batch.events.length > MAX_EVENTS) return { ok: false, error: `too many events (max ${MAX_EVENTS})` };\n\n const out: StoredEvent[] = [];\n for (const raw of batch.events as Partial<SplitHubEvent>[]) {\n const e = normalize(raw, now);\n if (typeof e === 'string') return { ok: false, error: e };\n out.push(e);\n }\n return { ok: true, events: out };\n}\n\nfunction normalize(e: Partial<SplitHubEvent>, now: number): StoredEvent | string {\n if (!e || typeof e !== 'object') return 'event must be an object';\n if (typeof e.id !== 'string' || !ID.test(e.id)) return 'event.id is invalid';\n if (typeof e.vid !== 'string' || e.vid.length === 0 || e.vid.length > 64) return 'event.vid is invalid';\n if (typeof e.sid !== 'string' || e.sid.length === 0 || e.sid.length > 64) return 'event.sid is invalid';\n if (typeof e.ts !== 'number' || !Number.isFinite(e.ts)) return 'event.ts must be a number';\n const ts = Math.abs(e.ts - now) > MAX_SKEW_MS ? now : Math.round(e.ts);\n const url = typeof e.url === 'string' ? e.url.slice(0, 512) : null;\n\n if (e.type === 'exposure') {\n if (typeof e.exp !== 'string' || !KEY.test(e.exp)) return 'exposure.exp is invalid';\n if (typeof e.var !== 'string' || !KEY.test(e.var)) return 'exposure.var is invalid';\n return { id: e.id, type: 'exposure', experiment: e.exp, variant: e.var, goal: null, visitorId: e.vid, sessionId: e.sid, ts, url, props: null, receivedAt: now };\n }\n if (e.type === 'goal') {\n if (typeof e.goal !== 'string' || !KEY.test(e.goal)) return 'goal.goal is invalid';\n let props: Record<string, unknown> | null = null;\n if (e.props !== undefined) {\n if (!e.props || typeof e.props !== 'object' || Array.isArray(e.props)) return 'goal.props must be an object';\n if (JSON.stringify(e.props).length > MAX_PROPS_BYTES) return 'goal.props too large';\n props = e.props;\n }\n return { id: e.id, type: 'goal', experiment: null, variant: null, goal: e.goal, visitorId: e.vid, sessionId: e.sid, ts, url, props, receivedAt: now };\n }\n return `unknown event type \"${String((e as { type?: unknown }).type)}\"`;\n}\n","import type { SplitHubConfig } from '@splithub/core';\nimport { experimentResults, statusTable } from './results';\nimport type { Store } from './store';\nimport { validateBatch } from './validate';\n\nexport interface HandlerOptions {\n config: SplitHubConfig;\n store: Store;\n /**\n * Protects the read endpoints (`/status`, `/results/:id`). When unset, they\n * are open, which is fine for local development only.\n */\n adminToken?: string;\n /** Allowed origins for CORS. Defaults to same-origin only (no CORS headers). */\n cors?: string[] | '*';\n}\n\nexport type FetchHandler = (request: Request) => Promise<Response>;\n\n/**\n * One handler for ingest and results, mountable at any path:\n *\n * POST {base} → ingest an event batch\n * GET {base}/status → all experiments with counts and verdict headline\n * GET {base}/results/:id → full verdict for one experiment\n * GET {base}/health → { ok: true }\n *\n * Works in Next.js route handlers, Remix, Hono, Bun, Deno and Node (via `toNodeListener`).\n */\nexport function createSplitHubHandler(options: HandlerOptions): FetchHandler {\n const { config, store } = options;\n\n const corsHeaders = (request: Request): Record<string, string> => {\n if (!options.cors) return {};\n const origin = request.headers.get('origin') ?? '';\n const allowed = options.cors === '*' ? '*' : options.cors.includes(origin) ? origin : '';\n if (!allowed) return {};\n return {\n 'access-control-allow-origin': allowed,\n 'access-control-allow-methods': 'GET, POST, OPTIONS',\n 'access-control-allow-headers': 'content-type, authorization',\n 'access-control-max-age': '86400',\n };\n };\n\n const json = (request: Request, body: unknown, status = 200): Response =>\n new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json', ...corsHeaders(request) } });\n\n const authorized = (request: Request): boolean => {\n if (!options.adminToken) return true;\n const header = request.headers.get('authorization') ?? '';\n return header === `Bearer ${options.adminToken}`;\n };\n\n return async (request) => {\n const url = new URL(request.url);\n const path = url.pathname.replace(/\\/+$/, '');\n const tail = path.split('/').slice(-2);\n\n if (request.method === 'OPTIONS') return new Response(null, { status: 204, headers: corsHeaders(request) });\n\n if (request.method === 'POST') {\n let body: unknown;\n try {\n body = await request.json();\n } catch {\n return json(request, { error: 'invalid JSON' }, 400);\n }\n const result = validateBatch(body, config.project);\n if (!result.ok) return json(request, { error: result.error }, 400);\n const inserted = await store.insertEvents(result.events);\n return json(request, { ok: true, received: result.events.length, inserted }, 202);\n }\n\n if (request.method === 'GET') {\n if (tail[1] === 'health') return json(request, { ok: true, project: config.project });\n if (!authorized(request)) return json(request, { error: 'unauthorized' }, 401);\n if (tail[1] === 'status') return json(request, { project: config.project, experiments: await statusTable(config, store) });\n if (tail[0] === 'results' && tail[1]) {\n const r = await experimentResults(config, store, tail[1]);\n return r ? json(request, r) : json(request, { error: `unknown experiment \"${tail[1]}\"` }, 404);\n }\n }\n\n return json(request, { error: 'not found' }, 404);\n };\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { FetchHandler } from './handler';\n\n/**\n * Adapt a fetch-style handler to Node's `http` / Express / Vite / Connect.\n *\n * http.createServer(toNodeListener(handler))\n * app.use('/api/splithub', toNodeListener(handler))\n * viteServer.middlewares.use('/api/splithub', toNodeListener(handler))\n */\nexport function toNodeListener(handler: FetchHandler): (req: IncomingMessage, res: ServerResponse) => void {\n return (req, res) => {\n void (async () => {\n try {\n const request = await toRequest(req);\n const response = await handler(request);\n res.statusCode = response.status;\n response.headers.forEach((value, key) => res.setHeader(key, value));\n const body = response.body ? Buffer.from(await response.arrayBuffer()) : null;\n res.end(body);\n } catch (error) {\n res.statusCode = 500;\n res.setHeader('content-type', 'application/json');\n res.end(JSON.stringify({ error: error instanceof Error ? error.message : 'internal error' }));\n }\n })();\n };\n}\n\nasync function toRequest(req: IncomingMessage): Promise<Request> {\n const host = req.headers.host ?? 'localhost';\n const proto = (req.headers['x-forwarded-proto'] as string | undefined) ?? 'http';\n // Connect-style mounts strip the prefix into req.url; prefer originalUrl when present.\n const rawUrl = (req as IncomingMessage & { originalUrl?: string }).originalUrl ?? req.url ?? '/';\n const url = new URL(rawUrl, `${proto}://${host}`);\n const headers = new Headers();\n for (const [key, value] of Object.entries(req.headers)) {\n if (Array.isArray(value)) value.forEach((v) => headers.append(key, v));\n else if (typeof value === 'string') headers.set(key, value);\n }\n const method = req.method ?? 'GET';\n let body: Buffer | undefined;\n if (method !== 'GET' && method !== 'HEAD') {\n const chunks: Buffer[] = [];\n for await (const chunk of req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n body = Buffer.concat(chunks);\n }\n return new Request(url, { method, headers, body });\n}\n","import type { VariantCounts } from '@splithub/stats';\n\n/** One row in the events table, whatever the backing database. */\nexport interface StoredEvent {\n id: string;\n type: 'exposure' | 'goal';\n experiment: string | null;\n variant: string | null;\n goal: string | null;\n visitorId: string;\n sessionId: string;\n /** Unix ms, as reported by the client. */\n ts: number;\n url: string | null;\n props: Record<string, unknown> | null;\n /** Unix ms, server clock. */\n receivedAt: number;\n /** Request metadata filled by the ingest endpoint (origin host, GeoIP country, UA device/browser). */\n host?: string | null;\n country?: string | null;\n device?: string | null;\n browser?: string | null;\n /** Extra dimensions (SplitHub Cloud, `d1Store({ meta: 'extended' })`): OS, language, geo, referrer, UTM. */\n os?: string | null;\n language?: string | null;\n city?: string | null;\n region?: string | null;\n referrer?: string | null;\n utm_source?: string | null;\n utm_medium?: string | null;\n utm_campaign?: string | null;\n utm_term?: string | null;\n utm_content?: string | null;\n}\n\nexport interface ExperimentSummary {\n experiment: string;\n exposures: number;\n visitors: number;\n firstExposureAt: number | null;\n lastExposureAt: number | null;\n}\n\n/**\n * Storage adapter. Implement this against your database to keep all data in\n * your own infrastructure. Attribution rule for `variantCounts`: a visitor\n * converts for a variant when they sent the goal at or after their first\n * exposure to that variant.\n */\nexport interface Store {\n /** Insert events, ignoring ids already present. Returns the number inserted. */\n insertEvents(events: StoredEvent[]): Promise<number>;\n /** Unique exposed and converted visitors per variant (any order). */\n variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;\n summaries(): Promise<ExperimentSummary[]>;\n close?(): Promise<void> | void;\n}\n\n/** In-memory store for tests and quick local runs. Not persistent. */\nexport function createMemoryStore(): Store & { events: StoredEvent[] } {\n const events: StoredEvent[] = [];\n const ids = new Set<string>();\n return {\n events,\n async insertEvents(batch) {\n let n = 0;\n for (const e of batch) {\n if (ids.has(e.id)) continue;\n ids.add(e.id);\n events.push(e);\n n++;\n }\n return n;\n },\n async variantCounts(experiment, goal) {\n const firstExposure = new Map<string, Map<string, number>>(); // variant -> visitor -> ts\n for (const e of events) {\n if (e.type !== 'exposure' || e.experiment !== experiment || !e.variant) continue;\n const byVisitor = firstExposure.get(e.variant) ?? new Map<string, number>();\n const prev = byVisitor.get(e.visitorId);\n if (prev === undefined || e.ts < prev) byVisitor.set(e.visitorId, e.ts);\n firstExposure.set(e.variant, byVisitor);\n }\n const goalsByVisitor = new Map<string, { ts: number; revenue: number }[]>();\n for (const e of events) {\n if (e.type !== 'goal' || e.goal !== goal) continue;\n const list = goalsByVisitor.get(e.visitorId) ?? [];\n const revenue = typeof e.props?.revenue === 'number' ? e.props.revenue : 0;\n list.push({ ts: e.ts, revenue });\n goalsByVisitor.set(e.visitorId, list);\n }\n const out: VariantCounts[] = [];\n for (const [variant, byVisitor] of firstExposure) {\n let conversions = 0;\n let revenue = 0;\n for (const [visitor, first] of byVisitor) {\n const goals = (goalsByVisitor.get(visitor) ?? []).filter((g) => g.ts >= first);\n if (goals.length > 0) {\n conversions++;\n revenue += goals.reduce((s, g) => s + g.revenue, 0);\n }\n }\n out.push({ variant, exposures: byVisitor.size, conversions, revenue });\n }\n return out;\n },\n async summaries() {\n const map = new Map<string, ExperimentSummary & { visitorSet: Set<string> }>();\n for (const e of events) {\n if (e.type !== 'exposure' || !e.experiment) continue;\n const s = map.get(e.experiment) ?? {\n experiment: e.experiment,\n exposures: 0,\n visitors: 0,\n firstExposureAt: null,\n lastExposureAt: null,\n visitorSet: new Set<string>(),\n };\n s.exposures++;\n s.visitorSet.add(e.visitorId);\n s.firstExposureAt = s.firstExposureAt === null ? e.ts : Math.min(s.firstExposureAt, e.ts);\n s.lastExposureAt = s.lastExposureAt === null ? e.ts : Math.max(s.lastExposureAt, e.ts);\n map.set(e.experiment, s);\n }\n return [...map.values()].map(({ visitorSet, ...s }) => ({ ...s, visitors: visitorSet.size }));\n },\n };\n}\n"],"mappings":"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","names":[]}
@@ -0,0 +1,139 @@
1
+ import { SplitHubConfig } from '@splithub/core';
2
+ import { VariantCounts, Verdict } from '@splithub/stats';
3
+ import { IncomingMessage, ServerResponse } from 'node:http';
4
+
5
+ /** One row in the events table, whatever the backing database. */
6
+ interface StoredEvent {
7
+ id: string;
8
+ type: 'exposure' | 'goal';
9
+ experiment: string | null;
10
+ variant: string | null;
11
+ goal: string | null;
12
+ visitorId: string;
13
+ sessionId: string;
14
+ /** Unix ms, as reported by the client. */
15
+ ts: number;
16
+ url: string | null;
17
+ props: Record<string, unknown> | null;
18
+ /** Unix ms, server clock. */
19
+ receivedAt: number;
20
+ /** Request metadata filled by the ingest endpoint (origin host, GeoIP country, UA device/browser). */
21
+ host?: string | null;
22
+ country?: string | null;
23
+ device?: string | null;
24
+ browser?: string | null;
25
+ /** Extra dimensions (SplitHub Cloud, `d1Store({ meta: 'extended' })`): OS, language, geo, referrer, UTM. */
26
+ os?: string | null;
27
+ language?: string | null;
28
+ city?: string | null;
29
+ region?: string | null;
30
+ referrer?: string | null;
31
+ utm_source?: string | null;
32
+ utm_medium?: string | null;
33
+ utm_campaign?: string | null;
34
+ utm_term?: string | null;
35
+ utm_content?: string | null;
36
+ }
37
+ interface ExperimentSummary {
38
+ experiment: string;
39
+ exposures: number;
40
+ visitors: number;
41
+ firstExposureAt: number | null;
42
+ lastExposureAt: number | null;
43
+ }
44
+ /**
45
+ * Storage adapter. Implement this against your database to keep all data in
46
+ * your own infrastructure. Attribution rule for `variantCounts`: a visitor
47
+ * converts for a variant when they sent the goal at or after their first
48
+ * exposure to that variant.
49
+ */
50
+ interface Store {
51
+ /** Insert events, ignoring ids already present. Returns the number inserted. */
52
+ insertEvents(events: StoredEvent[]): Promise<number>;
53
+ /** Unique exposed and converted visitors per variant (any order). */
54
+ variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;
55
+ summaries(): Promise<ExperimentSummary[]>;
56
+ close?(): Promise<void> | void;
57
+ }
58
+ /** In-memory store for tests and quick local runs. Not persistent. */
59
+ declare function createMemoryStore(): Store & {
60
+ events: StoredEvent[];
61
+ };
62
+
63
+ interface HandlerOptions {
64
+ config: SplitHubConfig;
65
+ store: Store;
66
+ /**
67
+ * Protects the read endpoints (`/status`, `/results/:id`). When unset, they
68
+ * are open, which is fine for local development only.
69
+ */
70
+ adminToken?: string;
71
+ /** Allowed origins for CORS. Defaults to same-origin only (no CORS headers). */
72
+ cors?: string[] | '*';
73
+ }
74
+ type FetchHandler = (request: Request) => Promise<Response>;
75
+ /**
76
+ * One handler for ingest and results, mountable at any path:
77
+ *
78
+ * POST {base} → ingest an event batch
79
+ * GET {base}/status → all experiments with counts and verdict headline
80
+ * GET {base}/results/:id → full verdict for one experiment
81
+ * GET {base}/health → { ok: true }
82
+ *
83
+ * Works in Next.js route handlers, Remix, Hono, Bun, Deno and Node (via `toNodeListener`).
84
+ */
85
+ declare function createSplitHubHandler(options: HandlerOptions): FetchHandler;
86
+
87
+ /**
88
+ * Adapt a fetch-style handler to Node's `http` / Express / Vite / Connect.
89
+ *
90
+ * http.createServer(toNodeListener(handler))
91
+ * app.use('/api/splithub', toNodeListener(handler))
92
+ * viteServer.middlewares.use('/api/splithub', toNodeListener(handler))
93
+ */
94
+ declare function toNodeListener(handler: FetchHandler): (req: IncomingMessage, res: ServerResponse) => void;
95
+
96
+ interface ExperimentResults {
97
+ experiment: string;
98
+ kind: string;
99
+ status: string;
100
+ goal: string | null;
101
+ description: string | null;
102
+ verdict: Verdict;
103
+ }
104
+ interface StatusRow {
105
+ experiment: string;
106
+ kind: string;
107
+ status: string;
108
+ goal: string | null;
109
+ description: string | null;
110
+ exposures: number;
111
+ visitors: number;
112
+ days: number;
113
+ verdict: Verdict['status'] | null;
114
+ /** Short text for tables: "#2 wins +15.9%", "#2 +3.1% (too early)", "no difference", "SRM! check setup", "no data". Ordinals, not names: variant names can be long. */
115
+ headline: string | null;
116
+ /** Leading variant: its name, its ordinal in the declared order (#1 is the control) and the relative lift. */
117
+ best: {
118
+ variant: string;
119
+ index: number;
120
+ lift: number | null;
121
+ } | null;
122
+ }
123
+ declare function experimentResults(config: SplitHubConfig, store: Store, key: string): Promise<ExperimentResults | null>;
124
+ declare function statusTable(config: SplitHubConfig, store: Store): Promise<StatusRow[]>;
125
+ /** The leading variant of a verdict with its ordinal (#1 is the control, in declared order). */
126
+ declare function bestOf(v: Verdict): StatusRow['best'];
127
+ declare function headlineFor(v: Verdict): string;
128
+
129
+ type ValidationResult = {
130
+ ok: true;
131
+ events: StoredEvent[];
132
+ } | {
133
+ ok: false;
134
+ error: string;
135
+ };
136
+ /** `expectedProject` null skips the name check (the caller already identified the project, e.g. by public key). */
137
+ declare function validateBatch(body: unknown, expectedProject: string | null, now?: number): ValidationResult;
138
+
139
+ export { type ExperimentResults, type ExperimentSummary, type FetchHandler, type HandlerOptions, type StatusRow, type Store, type StoredEvent, bestOf, createMemoryStore, createSplitHubHandler, experimentResults, headlineFor, statusTable, toNodeListener, validateBatch };
@@ -0,0 +1,139 @@
1
+ import { SplitHubConfig } from '@splithub/core';
2
+ import { VariantCounts, Verdict } from '@splithub/stats';
3
+ import { IncomingMessage, ServerResponse } from 'node:http';
4
+
5
+ /** One row in the events table, whatever the backing database. */
6
+ interface StoredEvent {
7
+ id: string;
8
+ type: 'exposure' | 'goal';
9
+ experiment: string | null;
10
+ variant: string | null;
11
+ goal: string | null;
12
+ visitorId: string;
13
+ sessionId: string;
14
+ /** Unix ms, as reported by the client. */
15
+ ts: number;
16
+ url: string | null;
17
+ props: Record<string, unknown> | null;
18
+ /** Unix ms, server clock. */
19
+ receivedAt: number;
20
+ /** Request metadata filled by the ingest endpoint (origin host, GeoIP country, UA device/browser). */
21
+ host?: string | null;
22
+ country?: string | null;
23
+ device?: string | null;
24
+ browser?: string | null;
25
+ /** Extra dimensions (SplitHub Cloud, `d1Store({ meta: 'extended' })`): OS, language, geo, referrer, UTM. */
26
+ os?: string | null;
27
+ language?: string | null;
28
+ city?: string | null;
29
+ region?: string | null;
30
+ referrer?: string | null;
31
+ utm_source?: string | null;
32
+ utm_medium?: string | null;
33
+ utm_campaign?: string | null;
34
+ utm_term?: string | null;
35
+ utm_content?: string | null;
36
+ }
37
+ interface ExperimentSummary {
38
+ experiment: string;
39
+ exposures: number;
40
+ visitors: number;
41
+ firstExposureAt: number | null;
42
+ lastExposureAt: number | null;
43
+ }
44
+ /**
45
+ * Storage adapter. Implement this against your database to keep all data in
46
+ * your own infrastructure. Attribution rule for `variantCounts`: a visitor
47
+ * converts for a variant when they sent the goal at or after their first
48
+ * exposure to that variant.
49
+ */
50
+ interface Store {
51
+ /** Insert events, ignoring ids already present. Returns the number inserted. */
52
+ insertEvents(events: StoredEvent[]): Promise<number>;
53
+ /** Unique exposed and converted visitors per variant (any order). */
54
+ variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;
55
+ summaries(): Promise<ExperimentSummary[]>;
56
+ close?(): Promise<void> | void;
57
+ }
58
+ /** In-memory store for tests and quick local runs. Not persistent. */
59
+ declare function createMemoryStore(): Store & {
60
+ events: StoredEvent[];
61
+ };
62
+
63
+ interface HandlerOptions {
64
+ config: SplitHubConfig;
65
+ store: Store;
66
+ /**
67
+ * Protects the read endpoints (`/status`, `/results/:id`). When unset, they
68
+ * are open, which is fine for local development only.
69
+ */
70
+ adminToken?: string;
71
+ /** Allowed origins for CORS. Defaults to same-origin only (no CORS headers). */
72
+ cors?: string[] | '*';
73
+ }
74
+ type FetchHandler = (request: Request) => Promise<Response>;
75
+ /**
76
+ * One handler for ingest and results, mountable at any path:
77
+ *
78
+ * POST {base} → ingest an event batch
79
+ * GET {base}/status → all experiments with counts and verdict headline
80
+ * GET {base}/results/:id → full verdict for one experiment
81
+ * GET {base}/health → { ok: true }
82
+ *
83
+ * Works in Next.js route handlers, Remix, Hono, Bun, Deno and Node (via `toNodeListener`).
84
+ */
85
+ declare function createSplitHubHandler(options: HandlerOptions): FetchHandler;
86
+
87
+ /**
88
+ * Adapt a fetch-style handler to Node's `http` / Express / Vite / Connect.
89
+ *
90
+ * http.createServer(toNodeListener(handler))
91
+ * app.use('/api/splithub', toNodeListener(handler))
92
+ * viteServer.middlewares.use('/api/splithub', toNodeListener(handler))
93
+ */
94
+ declare function toNodeListener(handler: FetchHandler): (req: IncomingMessage, res: ServerResponse) => void;
95
+
96
+ interface ExperimentResults {
97
+ experiment: string;
98
+ kind: string;
99
+ status: string;
100
+ goal: string | null;
101
+ description: string | null;
102
+ verdict: Verdict;
103
+ }
104
+ interface StatusRow {
105
+ experiment: string;
106
+ kind: string;
107
+ status: string;
108
+ goal: string | null;
109
+ description: string | null;
110
+ exposures: number;
111
+ visitors: number;
112
+ days: number;
113
+ verdict: Verdict['status'] | null;
114
+ /** Short text for tables: "#2 wins +15.9%", "#2 +3.1% (too early)", "no difference", "SRM! check setup", "no data". Ordinals, not names: variant names can be long. */
115
+ headline: string | null;
116
+ /** Leading variant: its name, its ordinal in the declared order (#1 is the control) and the relative lift. */
117
+ best: {
118
+ variant: string;
119
+ index: number;
120
+ lift: number | null;
121
+ } | null;
122
+ }
123
+ declare function experimentResults(config: SplitHubConfig, store: Store, key: string): Promise<ExperimentResults | null>;
124
+ declare function statusTable(config: SplitHubConfig, store: Store): Promise<StatusRow[]>;
125
+ /** The leading variant of a verdict with its ordinal (#1 is the control, in declared order). */
126
+ declare function bestOf(v: Verdict): StatusRow['best'];
127
+ declare function headlineFor(v: Verdict): string;
128
+
129
+ type ValidationResult = {
130
+ ok: true;
131
+ events: StoredEvent[];
132
+ } | {
133
+ ok: false;
134
+ error: string;
135
+ };
136
+ /** `expectedProject` null skips the name check (the caller already identified the project, e.g. by public key). */
137
+ declare function validateBatch(body: unknown, expectedProject: string | null, now?: number): ValidationResult;
138
+
139
+ export { type ExperimentResults, type ExperimentSummary, type FetchHandler, type HandlerOptions, type StatusRow, type Store, type StoredEvent, bestOf, createMemoryStore, createSplitHubHandler, experimentResults, headlineFor, statusTable, toNodeListener, validateBatch };
package/dist/index.js ADDED
@@ -0,0 +1,278 @@
1
+ // src/results.ts
2
+ import { getExperiment } from "@splithub/core";
3
+ import { computeVerdict } from "@splithub/stats";
4
+ async function experimentResults(config, store, key) {
5
+ const experiment = getExperiment(config, key);
6
+ if (!experiment) return null;
7
+ const goal = experiment.goal;
8
+ const observed = goal ? await store.variantCounts(key, goal) : [];
9
+ const counts = experiment.variants.map((v) => {
10
+ const row = observed.find((o) => o.variant === v.key);
11
+ return { variant: v.key, exposures: row?.exposures ?? 0, conversions: row?.conversions ?? 0, revenue: row?.revenue ?? 0 };
12
+ });
13
+ const verdict = goal ? computeVerdict(key, counts, { expectedWeights: experiment.variants.map((v) => v.weight) }) : { ...computeVerdict(key, [], {}), message: "No goal configured for this experiment; add `goal` in splithub.config.ts." };
14
+ return { experiment: key, kind: experiment.kind, status: experiment.status, goal, description: experiment.description, verdict };
15
+ }
16
+ async function statusTable(config, store) {
17
+ const summaries = await store.summaries();
18
+ const byKey = new Map(summaries.map((s) => [s.experiment, s]));
19
+ const rows = [];
20
+ for (const exp of config.experiments) {
21
+ const s = byKey.get(exp.key);
22
+ const days = s?.firstExposureAt && s.lastExposureAt ? Math.max(1, Math.ceil((s.lastExposureAt - s.firstExposureAt) / 864e5)) : 0;
23
+ let verdict = null;
24
+ let headline = null;
25
+ let best = null;
26
+ if (exp.goal && s) {
27
+ const r = await experimentResults(config, store, exp.key);
28
+ verdict = r?.verdict.status ?? null;
29
+ headline = r ? headlineFor(r.verdict) : null;
30
+ best = r ? bestOf(r.verdict) : null;
31
+ }
32
+ rows.push({ experiment: exp.key, kind: exp.kind, status: exp.status, goal: exp.goal, description: exp.description ?? null, exposures: s?.exposures ?? 0, visitors: s?.visitors ?? 0, days, verdict, headline, best });
33
+ }
34
+ return rows;
35
+ }
36
+ function bestOf(v) {
37
+ const best = v.comparisons.slice().sort((a, b) => b.absoluteLift - a.absoluteLift)[0];
38
+ const name = v.winner ?? best?.variant;
39
+ if (!name) return null;
40
+ const cmp = best && best.variant === name ? best : v.comparisons.find((c) => c.variant === name);
41
+ return { variant: name, index: v.sample.variants.findIndex((x) => x.variant === name) + 1, lift: cmp?.relativeLift ?? null };
42
+ }
43
+ function headlineFor(v) {
44
+ const best = bestOf(v);
45
+ const lift = best?.lift != null ? `${best.lift >= 0 ? "+" : ""}${(best.lift * 100).toFixed(1)}%` : "";
46
+ switch (v.status) {
47
+ case "winner_found":
48
+ return `#${best?.index ?? "?"} wins ${lift}`.trim();
49
+ case "insufficient_sample":
50
+ return best ? `#${best.index} ${lift} (too early)` : "too early";
51
+ case "srm_detected":
52
+ return "SRM! check setup";
53
+ case "no_significant_difference":
54
+ return "no difference";
55
+ default:
56
+ return "no data";
57
+ }
58
+ }
59
+
60
+ // src/validate.ts
61
+ var ID = /^[a-z0-9_-]{8,64}$/i;
62
+ var KEY = /^[a-z0-9][a-z0-9_-]{0,63}$/;
63
+ var MAX_EVENTS = 500;
64
+ var MAX_PROPS_BYTES = 4096;
65
+ var MAX_SKEW_MS = 7 * 24 * 60 * 60 * 1e3;
66
+ function validateBatch(body, expectedProject, now = Date.now()) {
67
+ if (!body || typeof body !== "object") return { ok: false, error: "body must be a JSON object" };
68
+ const batch = body;
69
+ if (typeof batch.project !== "string") return { ok: false, error: '"project" must be a string' };
70
+ if (expectedProject !== null && batch.project !== expectedProject) return { ok: false, error: `unknown project "${batch.project}"` };
71
+ if (!Array.isArray(batch.events)) return { ok: false, error: '"events" must be an array' };
72
+ if (batch.events.length === 0) return { ok: true, events: [] };
73
+ if (batch.events.length > MAX_EVENTS) return { ok: false, error: `too many events (max ${MAX_EVENTS})` };
74
+ const out = [];
75
+ for (const raw of batch.events) {
76
+ const e = normalize(raw, now);
77
+ if (typeof e === "string") return { ok: false, error: e };
78
+ out.push(e);
79
+ }
80
+ return { ok: true, events: out };
81
+ }
82
+ function normalize(e, now) {
83
+ if (!e || typeof e !== "object") return "event must be an object";
84
+ if (typeof e.id !== "string" || !ID.test(e.id)) return "event.id is invalid";
85
+ if (typeof e.vid !== "string" || e.vid.length === 0 || e.vid.length > 64) return "event.vid is invalid";
86
+ if (typeof e.sid !== "string" || e.sid.length === 0 || e.sid.length > 64) return "event.sid is invalid";
87
+ if (typeof e.ts !== "number" || !Number.isFinite(e.ts)) return "event.ts must be a number";
88
+ const ts = Math.abs(e.ts - now) > MAX_SKEW_MS ? now : Math.round(e.ts);
89
+ const url = typeof e.url === "string" ? e.url.slice(0, 512) : null;
90
+ if (e.type === "exposure") {
91
+ if (typeof e.exp !== "string" || !KEY.test(e.exp)) return "exposure.exp is invalid";
92
+ if (typeof e.var !== "string" || !KEY.test(e.var)) return "exposure.var is invalid";
93
+ return { id: e.id, type: "exposure", experiment: e.exp, variant: e.var, goal: null, visitorId: e.vid, sessionId: e.sid, ts, url, props: null, receivedAt: now };
94
+ }
95
+ if (e.type === "goal") {
96
+ if (typeof e.goal !== "string" || !KEY.test(e.goal)) return "goal.goal is invalid";
97
+ let props = null;
98
+ if (e.props !== void 0) {
99
+ if (!e.props || typeof e.props !== "object" || Array.isArray(e.props)) return "goal.props must be an object";
100
+ if (JSON.stringify(e.props).length > MAX_PROPS_BYTES) return "goal.props too large";
101
+ props = e.props;
102
+ }
103
+ return { id: e.id, type: "goal", experiment: null, variant: null, goal: e.goal, visitorId: e.vid, sessionId: e.sid, ts, url, props, receivedAt: now };
104
+ }
105
+ return `unknown event type "${String(e.type)}"`;
106
+ }
107
+
108
+ // src/handler.ts
109
+ function createSplitHubHandler(options) {
110
+ const { config, store } = options;
111
+ const corsHeaders = (request) => {
112
+ if (!options.cors) return {};
113
+ const origin = request.headers.get("origin") ?? "";
114
+ const allowed = options.cors === "*" ? "*" : options.cors.includes(origin) ? origin : "";
115
+ if (!allowed) return {};
116
+ return {
117
+ "access-control-allow-origin": allowed,
118
+ "access-control-allow-methods": "GET, POST, OPTIONS",
119
+ "access-control-allow-headers": "content-type, authorization",
120
+ "access-control-max-age": "86400"
121
+ };
122
+ };
123
+ const json = (request, body, status = 200) => new Response(JSON.stringify(body), { status, headers: { "content-type": "application/json", ...corsHeaders(request) } });
124
+ const authorized = (request) => {
125
+ if (!options.adminToken) return true;
126
+ const header = request.headers.get("authorization") ?? "";
127
+ return header === `Bearer ${options.adminToken}`;
128
+ };
129
+ return async (request) => {
130
+ const url = new URL(request.url);
131
+ const path = url.pathname.replace(/\/+$/, "");
132
+ const tail = path.split("/").slice(-2);
133
+ if (request.method === "OPTIONS") return new Response(null, { status: 204, headers: corsHeaders(request) });
134
+ if (request.method === "POST") {
135
+ let body;
136
+ try {
137
+ body = await request.json();
138
+ } catch {
139
+ return json(request, { error: "invalid JSON" }, 400);
140
+ }
141
+ const result = validateBatch(body, config.project);
142
+ if (!result.ok) return json(request, { error: result.error }, 400);
143
+ const inserted = await store.insertEvents(result.events);
144
+ return json(request, { ok: true, received: result.events.length, inserted }, 202);
145
+ }
146
+ if (request.method === "GET") {
147
+ if (tail[1] === "health") return json(request, { ok: true, project: config.project });
148
+ if (!authorized(request)) return json(request, { error: "unauthorized" }, 401);
149
+ if (tail[1] === "status") return json(request, { project: config.project, experiments: await statusTable(config, store) });
150
+ if (tail[0] === "results" && tail[1]) {
151
+ const r = await experimentResults(config, store, tail[1]);
152
+ return r ? json(request, r) : json(request, { error: `unknown experiment "${tail[1]}"` }, 404);
153
+ }
154
+ }
155
+ return json(request, { error: "not found" }, 404);
156
+ };
157
+ }
158
+
159
+ // src/nodeAdapter.ts
160
+ function toNodeListener(handler) {
161
+ return (req, res) => {
162
+ void (async () => {
163
+ try {
164
+ const request = await toRequest(req);
165
+ const response = await handler(request);
166
+ res.statusCode = response.status;
167
+ response.headers.forEach((value, key) => res.setHeader(key, value));
168
+ const body = response.body ? Buffer.from(await response.arrayBuffer()) : null;
169
+ res.end(body);
170
+ } catch (error) {
171
+ res.statusCode = 500;
172
+ res.setHeader("content-type", "application/json");
173
+ res.end(JSON.stringify({ error: error instanceof Error ? error.message : "internal error" }));
174
+ }
175
+ })();
176
+ };
177
+ }
178
+ async function toRequest(req) {
179
+ const host = req.headers.host ?? "localhost";
180
+ const proto = req.headers["x-forwarded-proto"] ?? "http";
181
+ const rawUrl = req.originalUrl ?? req.url ?? "/";
182
+ const url = new URL(rawUrl, `${proto}://${host}`);
183
+ const headers = new Headers();
184
+ for (const [key, value] of Object.entries(req.headers)) {
185
+ if (Array.isArray(value)) value.forEach((v) => headers.append(key, v));
186
+ else if (typeof value === "string") headers.set(key, value);
187
+ }
188
+ const method = req.method ?? "GET";
189
+ let body;
190
+ if (method !== "GET" && method !== "HEAD") {
191
+ const chunks = [];
192
+ for await (const chunk of req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
193
+ body = Buffer.concat(chunks);
194
+ }
195
+ return new Request(url, { method, headers, body });
196
+ }
197
+
198
+ // src/store.ts
199
+ function createMemoryStore() {
200
+ const events = [];
201
+ const ids = /* @__PURE__ */ new Set();
202
+ return {
203
+ events,
204
+ async insertEvents(batch) {
205
+ let n = 0;
206
+ for (const e of batch) {
207
+ if (ids.has(e.id)) continue;
208
+ ids.add(e.id);
209
+ events.push(e);
210
+ n++;
211
+ }
212
+ return n;
213
+ },
214
+ async variantCounts(experiment, goal) {
215
+ const firstExposure = /* @__PURE__ */ new Map();
216
+ for (const e of events) {
217
+ if (e.type !== "exposure" || e.experiment !== experiment || !e.variant) continue;
218
+ const byVisitor = firstExposure.get(e.variant) ?? /* @__PURE__ */ new Map();
219
+ const prev = byVisitor.get(e.visitorId);
220
+ if (prev === void 0 || e.ts < prev) byVisitor.set(e.visitorId, e.ts);
221
+ firstExposure.set(e.variant, byVisitor);
222
+ }
223
+ const goalsByVisitor = /* @__PURE__ */ new Map();
224
+ for (const e of events) {
225
+ if (e.type !== "goal" || e.goal !== goal) continue;
226
+ const list = goalsByVisitor.get(e.visitorId) ?? [];
227
+ const revenue = typeof e.props?.revenue === "number" ? e.props.revenue : 0;
228
+ list.push({ ts: e.ts, revenue });
229
+ goalsByVisitor.set(e.visitorId, list);
230
+ }
231
+ const out = [];
232
+ for (const [variant, byVisitor] of firstExposure) {
233
+ let conversions = 0;
234
+ let revenue = 0;
235
+ for (const [visitor, first] of byVisitor) {
236
+ const goals = (goalsByVisitor.get(visitor) ?? []).filter((g) => g.ts >= first);
237
+ if (goals.length > 0) {
238
+ conversions++;
239
+ revenue += goals.reduce((s, g) => s + g.revenue, 0);
240
+ }
241
+ }
242
+ out.push({ variant, exposures: byVisitor.size, conversions, revenue });
243
+ }
244
+ return out;
245
+ },
246
+ async summaries() {
247
+ const map = /* @__PURE__ */ new Map();
248
+ for (const e of events) {
249
+ if (e.type !== "exposure" || !e.experiment) continue;
250
+ const s = map.get(e.experiment) ?? {
251
+ experiment: e.experiment,
252
+ exposures: 0,
253
+ visitors: 0,
254
+ firstExposureAt: null,
255
+ lastExposureAt: null,
256
+ visitorSet: /* @__PURE__ */ new Set()
257
+ };
258
+ s.exposures++;
259
+ s.visitorSet.add(e.visitorId);
260
+ s.firstExposureAt = s.firstExposureAt === null ? e.ts : Math.min(s.firstExposureAt, e.ts);
261
+ s.lastExposureAt = s.lastExposureAt === null ? e.ts : Math.max(s.lastExposureAt, e.ts);
262
+ map.set(e.experiment, s);
263
+ }
264
+ return [...map.values()].map(({ visitorSet, ...s }) => ({ ...s, visitors: visitorSet.size }));
265
+ }
266
+ };
267
+ }
268
+ export {
269
+ bestOf,
270
+ createMemoryStore,
271
+ createSplitHubHandler,
272
+ experimentResults,
273
+ headlineFor,
274
+ statusTable,
275
+ toNodeListener,
276
+ validateBatch
277
+ };
278
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/results.ts","../src/validate.ts","../src/handler.ts","../src/nodeAdapter.ts","../src/store.ts"],"sourcesContent":["import { getExperiment, type SplitHubConfig } from '@splithub/core';\nimport { computeVerdict, type VariantCounts, type Verdict } from '@splithub/stats';\nimport type { ExperimentSummary, Store } from './store';\n\nexport interface ExperimentResults {\n experiment: string;\n kind: string;\n status: string;\n goal: string | null;\n description: string | null;\n verdict: Verdict;\n}\n\nexport interface StatusRow {\n experiment: string;\n kind: string;\n status: string;\n goal: string | null;\n description: string | null;\n exposures: number;\n visitors: number;\n days: number;\n verdict: Verdict['status'] | null;\n /** Short text for tables: \"#2 wins +15.9%\", \"#2 +3.1% (too early)\", \"no difference\", \"SRM! check setup\", \"no data\". Ordinals, not names: variant names can be long. */\n headline: string | null;\n /** Leading variant: its name, its ordinal in the declared order (#1 is the control) and the relative lift. */\n best: { variant: string; index: number; lift: number | null } | null;\n}\n\nexport async function experimentResults(config: SplitHubConfig, store: Store, key: string): Promise<ExperimentResults | null> {\n const experiment = getExperiment(config, key);\n if (!experiment) return null;\n const goal = experiment.goal;\n const observed = goal ? await store.variantCounts(key, goal) : [];\n // Align to config order so the control is first and silent variants show as 0.\n const counts: VariantCounts[] = experiment.variants.map((v) => {\n const row = observed.find((o) => o.variant === v.key);\n return { variant: v.key, exposures: row?.exposures ?? 0, conversions: row?.conversions ?? 0, revenue: row?.revenue ?? 0 };\n });\n const verdict = goal\n ? computeVerdict(key, counts, { expectedWeights: experiment.variants.map((v) => v.weight) })\n : { ...computeVerdict(key, [], {}), message: 'No goal configured for this experiment; add `goal` in splithub.config.ts.' };\n return { experiment: key, kind: experiment.kind, status: experiment.status, goal, description: experiment.description, verdict };\n}\n\nexport async function statusTable(config: SplitHubConfig, store: Store): Promise<StatusRow[]> {\n const summaries = await store.summaries();\n const byKey = new Map<string, ExperimentSummary>(summaries.map((s) => [s.experiment, s]));\n const rows: StatusRow[] = [];\n for (const exp of config.experiments) {\n const s = byKey.get(exp.key);\n const days = s?.firstExposureAt && s.lastExposureAt ? Math.max(1, Math.ceil((s.lastExposureAt - s.firstExposureAt) / 86_400_000)) : 0;\n let verdict: Verdict['status'] | null = null;\n let headline: string | null = null;\n let best: StatusRow['best'] = null;\n if (exp.goal && s) {\n const r = await experimentResults(config, store, exp.key);\n verdict = r?.verdict.status ?? null;\n headline = r ? headlineFor(r.verdict) : null;\n best = r ? bestOf(r.verdict) : null;\n }\n rows.push({ experiment: exp.key, kind: exp.kind, status: exp.status, goal: exp.goal, description: exp.description ?? null, exposures: s?.exposures ?? 0, visitors: s?.visitors ?? 0, days, verdict, headline, best });\n }\n return rows;\n}\n\n/** The leading variant of a verdict with its ordinal (#1 is the control, in declared order). */\nexport function bestOf(v: Verdict): StatusRow['best'] {\n const best = v.comparisons.slice().sort((a, b) => b.absoluteLift - a.absoluteLift)[0];\n const name = v.winner ?? best?.variant;\n if (!name) return null;\n const cmp = best && best.variant === name ? best : v.comparisons.find((c) => c.variant === name);\n return { variant: name, index: v.sample.variants.findIndex((x) => x.variant === name) + 1, lift: cmp?.relativeLift ?? null };\n}\n\nexport function headlineFor(v: Verdict): string {\n const best = bestOf(v);\n const lift = best?.lift != null ? `${best.lift >= 0 ? '+' : ''}${(best.lift * 100).toFixed(1)}%` : '';\n switch (v.status) {\n case 'winner_found':\n return `#${best?.index ?? '?'} wins ${lift}`.trim();\n case 'insufficient_sample':\n return best ? `#${best.index} ${lift} (too early)` : 'too early';\n case 'srm_detected':\n return 'SRM! check setup';\n case 'no_significant_difference':\n return 'no difference';\n default:\n return 'no data';\n }\n}\n","import type { EventBatch, SplitHubEvent } from '@splithub/core';\nimport type { StoredEvent } from './store';\n\nconst ID = /^[a-z0-9_-]{8,64}$/i;\nconst KEY = /^[a-z0-9][a-z0-9_-]{0,63}$/;\nconst MAX_EVENTS = 500;\nconst MAX_PROPS_BYTES = 4096;\n/** Reject client timestamps more than this far from the server clock. */\nconst MAX_SKEW_MS = 7 * 24 * 60 * 60 * 1000;\n\nexport type ValidationResult = { ok: true; events: StoredEvent[] } | { ok: false; error: string };\n\n/** `expectedProject` null skips the name check (the caller already identified the project, e.g. by public key). */\nexport function validateBatch(body: unknown, expectedProject: string | null, now = Date.now()): ValidationResult {\n if (!body || typeof body !== 'object') return { ok: false, error: 'body must be a JSON object' };\n const batch = body as Partial<EventBatch>;\n if (typeof batch.project !== 'string') return { ok: false, error: '\"project\" must be a string' };\n if (expectedProject !== null && batch.project !== expectedProject) return { ok: false, error: `unknown project \"${batch.project}\"` };\n if (!Array.isArray(batch.events)) return { ok: false, error: '\"events\" must be an array' };\n if (batch.events.length === 0) return { ok: true, events: [] };\n if (batch.events.length > MAX_EVENTS) return { ok: false, error: `too many events (max ${MAX_EVENTS})` };\n\n const out: StoredEvent[] = [];\n for (const raw of batch.events as Partial<SplitHubEvent>[]) {\n const e = normalize(raw, now);\n if (typeof e === 'string') return { ok: false, error: e };\n out.push(e);\n }\n return { ok: true, events: out };\n}\n\nfunction normalize(e: Partial<SplitHubEvent>, now: number): StoredEvent | string {\n if (!e || typeof e !== 'object') return 'event must be an object';\n if (typeof e.id !== 'string' || !ID.test(e.id)) return 'event.id is invalid';\n if (typeof e.vid !== 'string' || e.vid.length === 0 || e.vid.length > 64) return 'event.vid is invalid';\n if (typeof e.sid !== 'string' || e.sid.length === 0 || e.sid.length > 64) return 'event.sid is invalid';\n if (typeof e.ts !== 'number' || !Number.isFinite(e.ts)) return 'event.ts must be a number';\n const ts = Math.abs(e.ts - now) > MAX_SKEW_MS ? now : Math.round(e.ts);\n const url = typeof e.url === 'string' ? e.url.slice(0, 512) : null;\n\n if (e.type === 'exposure') {\n if (typeof e.exp !== 'string' || !KEY.test(e.exp)) return 'exposure.exp is invalid';\n if (typeof e.var !== 'string' || !KEY.test(e.var)) return 'exposure.var is invalid';\n return { id: e.id, type: 'exposure', experiment: e.exp, variant: e.var, goal: null, visitorId: e.vid, sessionId: e.sid, ts, url, props: null, receivedAt: now };\n }\n if (e.type === 'goal') {\n if (typeof e.goal !== 'string' || !KEY.test(e.goal)) return 'goal.goal is invalid';\n let props: Record<string, unknown> | null = null;\n if (e.props !== undefined) {\n if (!e.props || typeof e.props !== 'object' || Array.isArray(e.props)) return 'goal.props must be an object';\n if (JSON.stringify(e.props).length > MAX_PROPS_BYTES) return 'goal.props too large';\n props = e.props;\n }\n return { id: e.id, type: 'goal', experiment: null, variant: null, goal: e.goal, visitorId: e.vid, sessionId: e.sid, ts, url, props, receivedAt: now };\n }\n return `unknown event type \"${String((e as { type?: unknown }).type)}\"`;\n}\n","import type { SplitHubConfig } from '@splithub/core';\nimport { experimentResults, statusTable } from './results';\nimport type { Store } from './store';\nimport { validateBatch } from './validate';\n\nexport interface HandlerOptions {\n config: SplitHubConfig;\n store: Store;\n /**\n * Protects the read endpoints (`/status`, `/results/:id`). When unset, they\n * are open, which is fine for local development only.\n */\n adminToken?: string;\n /** Allowed origins for CORS. Defaults to same-origin only (no CORS headers). */\n cors?: string[] | '*';\n}\n\nexport type FetchHandler = (request: Request) => Promise<Response>;\n\n/**\n * One handler for ingest and results, mountable at any path:\n *\n * POST {base} → ingest an event batch\n * GET {base}/status → all experiments with counts and verdict headline\n * GET {base}/results/:id → full verdict for one experiment\n * GET {base}/health → { ok: true }\n *\n * Works in Next.js route handlers, Remix, Hono, Bun, Deno and Node (via `toNodeListener`).\n */\nexport function createSplitHubHandler(options: HandlerOptions): FetchHandler {\n const { config, store } = options;\n\n const corsHeaders = (request: Request): Record<string, string> => {\n if (!options.cors) return {};\n const origin = request.headers.get('origin') ?? '';\n const allowed = options.cors === '*' ? '*' : options.cors.includes(origin) ? origin : '';\n if (!allowed) return {};\n return {\n 'access-control-allow-origin': allowed,\n 'access-control-allow-methods': 'GET, POST, OPTIONS',\n 'access-control-allow-headers': 'content-type, authorization',\n 'access-control-max-age': '86400',\n };\n };\n\n const json = (request: Request, body: unknown, status = 200): Response =>\n new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json', ...corsHeaders(request) } });\n\n const authorized = (request: Request): boolean => {\n if (!options.adminToken) return true;\n const header = request.headers.get('authorization') ?? '';\n return header === `Bearer ${options.adminToken}`;\n };\n\n return async (request) => {\n const url = new URL(request.url);\n const path = url.pathname.replace(/\\/+$/, '');\n const tail = path.split('/').slice(-2);\n\n if (request.method === 'OPTIONS') return new Response(null, { status: 204, headers: corsHeaders(request) });\n\n if (request.method === 'POST') {\n let body: unknown;\n try {\n body = await request.json();\n } catch {\n return json(request, { error: 'invalid JSON' }, 400);\n }\n const result = validateBatch(body, config.project);\n if (!result.ok) return json(request, { error: result.error }, 400);\n const inserted = await store.insertEvents(result.events);\n return json(request, { ok: true, received: result.events.length, inserted }, 202);\n }\n\n if (request.method === 'GET') {\n if (tail[1] === 'health') return json(request, { ok: true, project: config.project });\n if (!authorized(request)) return json(request, { error: 'unauthorized' }, 401);\n if (tail[1] === 'status') return json(request, { project: config.project, experiments: await statusTable(config, store) });\n if (tail[0] === 'results' && tail[1]) {\n const r = await experimentResults(config, store, tail[1]);\n return r ? json(request, r) : json(request, { error: `unknown experiment \"${tail[1]}\"` }, 404);\n }\n }\n\n return json(request, { error: 'not found' }, 404);\n };\n}\n","import type { IncomingMessage, ServerResponse } from 'node:http';\nimport type { FetchHandler } from './handler';\n\n/**\n * Adapt a fetch-style handler to Node's `http` / Express / Vite / Connect.\n *\n * http.createServer(toNodeListener(handler))\n * app.use('/api/splithub', toNodeListener(handler))\n * viteServer.middlewares.use('/api/splithub', toNodeListener(handler))\n */\nexport function toNodeListener(handler: FetchHandler): (req: IncomingMessage, res: ServerResponse) => void {\n return (req, res) => {\n void (async () => {\n try {\n const request = await toRequest(req);\n const response = await handler(request);\n res.statusCode = response.status;\n response.headers.forEach((value, key) => res.setHeader(key, value));\n const body = response.body ? Buffer.from(await response.arrayBuffer()) : null;\n res.end(body);\n } catch (error) {\n res.statusCode = 500;\n res.setHeader('content-type', 'application/json');\n res.end(JSON.stringify({ error: error instanceof Error ? error.message : 'internal error' }));\n }\n })();\n };\n}\n\nasync function toRequest(req: IncomingMessage): Promise<Request> {\n const host = req.headers.host ?? 'localhost';\n const proto = (req.headers['x-forwarded-proto'] as string | undefined) ?? 'http';\n // Connect-style mounts strip the prefix into req.url; prefer originalUrl when present.\n const rawUrl = (req as IncomingMessage & { originalUrl?: string }).originalUrl ?? req.url ?? '/';\n const url = new URL(rawUrl, `${proto}://${host}`);\n const headers = new Headers();\n for (const [key, value] of Object.entries(req.headers)) {\n if (Array.isArray(value)) value.forEach((v) => headers.append(key, v));\n else if (typeof value === 'string') headers.set(key, value);\n }\n const method = req.method ?? 'GET';\n let body: Buffer | undefined;\n if (method !== 'GET' && method !== 'HEAD') {\n const chunks: Buffer[] = [];\n for await (const chunk of req) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));\n body = Buffer.concat(chunks);\n }\n return new Request(url, { method, headers, body });\n}\n","import type { VariantCounts } from '@splithub/stats';\n\n/** One row in the events table, whatever the backing database. */\nexport interface StoredEvent {\n id: string;\n type: 'exposure' | 'goal';\n experiment: string | null;\n variant: string | null;\n goal: string | null;\n visitorId: string;\n sessionId: string;\n /** Unix ms, as reported by the client. */\n ts: number;\n url: string | null;\n props: Record<string, unknown> | null;\n /** Unix ms, server clock. */\n receivedAt: number;\n /** Request metadata filled by the ingest endpoint (origin host, GeoIP country, UA device/browser). */\n host?: string | null;\n country?: string | null;\n device?: string | null;\n browser?: string | null;\n /** Extra dimensions (SplitHub Cloud, `d1Store({ meta: 'extended' })`): OS, language, geo, referrer, UTM. */\n os?: string | null;\n language?: string | null;\n city?: string | null;\n region?: string | null;\n referrer?: string | null;\n utm_source?: string | null;\n utm_medium?: string | null;\n utm_campaign?: string | null;\n utm_term?: string | null;\n utm_content?: string | null;\n}\n\nexport interface ExperimentSummary {\n experiment: string;\n exposures: number;\n visitors: number;\n firstExposureAt: number | null;\n lastExposureAt: number | null;\n}\n\n/**\n * Storage adapter. Implement this against your database to keep all data in\n * your own infrastructure. Attribution rule for `variantCounts`: a visitor\n * converts for a variant when they sent the goal at or after their first\n * exposure to that variant.\n */\nexport interface Store {\n /** Insert events, ignoring ids already present. Returns the number inserted. */\n insertEvents(events: StoredEvent[]): Promise<number>;\n /** Unique exposed and converted visitors per variant (any order). */\n variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;\n summaries(): Promise<ExperimentSummary[]>;\n close?(): Promise<void> | void;\n}\n\n/** In-memory store for tests and quick local runs. Not persistent. */\nexport function createMemoryStore(): Store & { events: StoredEvent[] } {\n const events: StoredEvent[] = [];\n const ids = new Set<string>();\n return {\n events,\n async insertEvents(batch) {\n let n = 0;\n for (const e of batch) {\n if (ids.has(e.id)) continue;\n ids.add(e.id);\n events.push(e);\n n++;\n }\n return n;\n },\n async variantCounts(experiment, goal) {\n const firstExposure = new Map<string, Map<string, number>>(); // variant -> visitor -> ts\n for (const e of events) {\n if (e.type !== 'exposure' || e.experiment !== experiment || !e.variant) continue;\n const byVisitor = firstExposure.get(e.variant) ?? new Map<string, number>();\n const prev = byVisitor.get(e.visitorId);\n if (prev === undefined || e.ts < prev) byVisitor.set(e.visitorId, e.ts);\n firstExposure.set(e.variant, byVisitor);\n }\n const goalsByVisitor = new Map<string, { ts: number; revenue: number }[]>();\n for (const e of events) {\n if (e.type !== 'goal' || e.goal !== goal) continue;\n const list = goalsByVisitor.get(e.visitorId) ?? [];\n const revenue = typeof e.props?.revenue === 'number' ? e.props.revenue : 0;\n list.push({ ts: e.ts, revenue });\n goalsByVisitor.set(e.visitorId, list);\n }\n const out: VariantCounts[] = [];\n for (const [variant, byVisitor] of firstExposure) {\n let conversions = 0;\n let revenue = 0;\n for (const [visitor, first] of byVisitor) {\n const goals = (goalsByVisitor.get(visitor) ?? []).filter((g) => g.ts >= first);\n if (goals.length > 0) {\n conversions++;\n revenue += goals.reduce((s, g) => s + g.revenue, 0);\n }\n }\n out.push({ variant, exposures: byVisitor.size, conversions, revenue });\n }\n return out;\n },\n async summaries() {\n const map = new Map<string, ExperimentSummary & { visitorSet: Set<string> }>();\n for (const e of events) {\n if (e.type !== 'exposure' || !e.experiment) continue;\n const s = map.get(e.experiment) ?? {\n experiment: e.experiment,\n exposures: 0,\n visitors: 0,\n firstExposureAt: null,\n lastExposureAt: null,\n visitorSet: new Set<string>(),\n };\n s.exposures++;\n s.visitorSet.add(e.visitorId);\n s.firstExposureAt = s.firstExposureAt === null ? e.ts : Math.min(s.firstExposureAt, e.ts);\n s.lastExposureAt = s.lastExposureAt === null ? e.ts : Math.max(s.lastExposureAt, e.ts);\n map.set(e.experiment, s);\n }\n return [...map.values()].map(({ visitorSet, ...s }) => ({ ...s, visitors: visitorSet.size }));\n },\n };\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,45 @@
1
1
  {
2
2
  "name": "@splithub/node",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "0.1.0",
4
+ "description": "Self-hosted SplitHub ingest and results for Node, Next.js route handlers and any fetch-style server. Bring your own database via a Store adapter.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "main": "./dist/index.cjs",
8
+ "module": "./dist/index.js",
9
+ "types": "./dist/index.d.ts",
10
+ "exports": {
11
+ ".": {
12
+ "types": "./dist/index.d.ts",
13
+ "import": "./dist/index.js",
14
+ "require": "./dist/index.cjs"
15
+ }
16
+ },
17
+ "files": [
18
+ "dist",
19
+ "README.md"
20
+ ],
21
+ "dependencies": {
22
+ "@splithub/core": "0.1.0",
23
+ "@splithub/stats": "0.1.0"
24
+ },
25
+ "devDependencies": {
26
+ "@types/node": "^22.9.0",
27
+ "tsup": "^8.3.5",
28
+ "typescript": "^5.6.3",
29
+ "vitest": "^4.1.11"
30
+ },
31
+ "publishConfig": {
32
+ "access": "public"
33
+ },
34
+ "repository": {
35
+ "type": "git",
36
+ "url": "https://github.com/andreybo/splithub-ab-testing-platform.git",
37
+ "directory": "packages/node"
38
+ },
39
+ "homepage": "https://splithub.io",
40
+ "scripts": {
41
+ "build": "tsup",
42
+ "test": "vitest run",
43
+ "typecheck": "tsc --noEmit"
44
+ }
6
45
  }