@splithub/node 0.1.1 → 0.1.3
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/dist/index.cjs +39 -6
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +36 -5
- package/dist/index.d.ts +36 -5
- package/dist/index.js +39 -7
- package/dist/index.js.map +1 -1
- package/package.json +3 -3
package/dist/index.cjs
CHANGED
|
@@ -24,6 +24,7 @@ __export(index_exports, {
|
|
|
24
24
|
createMemoryStore: () => createMemoryStore,
|
|
25
25
|
createSplitHubHandler: () => createSplitHubHandler,
|
|
26
26
|
experimentResults: () => experimentResults,
|
|
27
|
+
factorEffects: () => factorEffects,
|
|
27
28
|
headlineFor: () => headlineFor,
|
|
28
29
|
statusTable: () => statusTable,
|
|
29
30
|
toNodeListener: () => toNodeListener,
|
|
@@ -34,6 +35,31 @@ module.exports = __toCommonJS(index_exports);
|
|
|
34
35
|
// src/results.ts
|
|
35
36
|
var import_core = require("@splithub/core");
|
|
36
37
|
var import_stats = require("@splithub/stats");
|
|
38
|
+
function factorEffects(experiment, counts) {
|
|
39
|
+
if (!experiment.factors?.length) return [];
|
|
40
|
+
return experiment.factors.map((factor) => {
|
|
41
|
+
const perLevel = factor.levels.map((level) => {
|
|
42
|
+
const combos = experiment.variants.filter((v) => v.levels?.[factor.key] === level).map((v) => v.key);
|
|
43
|
+
const rows = counts.filter((c) => combos.includes(c.variant));
|
|
44
|
+
return { variant: level, exposures: rows.reduce((s, r) => s + r.exposures, 0), conversions: rows.reduce((s, r) => s + r.conversions, 0) };
|
|
45
|
+
});
|
|
46
|
+
const comparisons = perLevel.every((l) => l.exposures > 0) ? (0, import_stats.compareVariants)(perLevel) : [];
|
|
47
|
+
const levels = perLevel.map((l, i) => {
|
|
48
|
+
const cmp = comparisons.find((c) => c.variant === l.variant);
|
|
49
|
+
return {
|
|
50
|
+
level: l.variant,
|
|
51
|
+
exposures: l.exposures,
|
|
52
|
+
conversions: l.conversions,
|
|
53
|
+
rate: l.exposures ? l.conversions / l.exposures : 0,
|
|
54
|
+
relativeLift: i === 0 ? null : cmp?.relativeLift ?? null,
|
|
55
|
+
pValue: i === 0 ? null : cmp?.pValue ?? null,
|
|
56
|
+
significant: Boolean(cmp?.significant)
|
|
57
|
+
};
|
|
58
|
+
});
|
|
59
|
+
const winners = levels.filter((l) => l.significant && (l.relativeLift ?? 0) > 0).sort((a, b) => (b.relativeLift ?? 0) - (a.relativeLift ?? 0));
|
|
60
|
+
return { key: factor.key, levels, best: winners[0]?.level ?? null };
|
|
61
|
+
});
|
|
62
|
+
}
|
|
37
63
|
async function experimentResults(config, store, key) {
|
|
38
64
|
const experiment = (0, import_core.getExperiment)(config, key);
|
|
39
65
|
if (!experiment) return null;
|
|
@@ -44,7 +70,7 @@ async function experimentResults(config, store, key) {
|
|
|
44
70
|
return { variant: v.key, exposures: row?.exposures ?? 0, conversions: row?.conversions ?? 0, revenue: row?.revenue ?? 0 };
|
|
45
71
|
});
|
|
46
72
|
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 };
|
|
73
|
+
return { experiment: key, kind: experiment.kind, status: experiment.status, goal, description: experiment.description, verdict, ...experiment.kind === "mvt" && goal ? { factors: factorEffects(experiment, counts) } : {} };
|
|
48
74
|
}
|
|
49
75
|
async function statusTable(config, store) {
|
|
50
76
|
const summaries = await store.summaries();
|
|
@@ -245,13 +271,19 @@ function createMemoryStore() {
|
|
|
245
271
|
return n;
|
|
246
272
|
},
|
|
247
273
|
async variantCounts(experiment, goal) {
|
|
248
|
-
const
|
|
274
|
+
const earliest = /* @__PURE__ */ new Map();
|
|
249
275
|
for (const e of events) {
|
|
250
276
|
if (e.type !== "exposure" || e.experiment !== experiment || !e.variant) continue;
|
|
251
|
-
const
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
277
|
+
const prev = earliest.get(e.visitorId);
|
|
278
|
+
if (prev === void 0 || e.ts < prev.ts || e.ts === prev.ts && e.variant < prev.variant) {
|
|
279
|
+
earliest.set(e.visitorId, { variant: e.variant, ts: e.ts });
|
|
280
|
+
}
|
|
281
|
+
}
|
|
282
|
+
const firstExposure = /* @__PURE__ */ new Map();
|
|
283
|
+
for (const [visitor, { variant, ts }] of earliest) {
|
|
284
|
+
const byVisitor = firstExposure.get(variant) ?? /* @__PURE__ */ new Map();
|
|
285
|
+
byVisitor.set(visitor, ts);
|
|
286
|
+
firstExposure.set(variant, byVisitor);
|
|
255
287
|
}
|
|
256
288
|
const goalsByVisitor = /* @__PURE__ */ new Map();
|
|
257
289
|
for (const e of events) {
|
|
@@ -304,6 +336,7 @@ function createMemoryStore() {
|
|
|
304
336
|
createMemoryStore,
|
|
305
337
|
createSplitHubHandler,
|
|
306
338
|
experimentResults,
|
|
339
|
+
factorEffects,
|
|
307
340
|
headlineFor,
|
|
308
341
|
statusTable,
|
|
309
342
|
toNodeListener,
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +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":[]}
|
|
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, factorEffects } from './results';\nexport type { ExperimentResults, StatusRow, FactorResult, FactorLevelResult } from './results';\nexport { validateBatch } from './validate';\n","import { getExperiment, type Experiment, type SplitHubConfig } from '@splithub/core';\nimport { compareVariants, computeVerdict, type VariantCounts, type Verdict } from '@splithub/stats';\nimport type { ExperimentSummary, Store } from './store';\n\n/** One level of a multivariate factor, summed over every combination that uses it. */\nexport interface FactorLevelResult {\n level: string;\n exposures: number;\n conversions: number;\n rate: number;\n /** Relative lift vs the factor's first level; null for that level itself. */\n relativeLift: number | null;\n pValue: number | null;\n significant: boolean;\n}\n\n/** A multivariate factor read on its own (its main effect), independent of the other factors. */\nexport interface FactorResult {\n key: string;\n levels: FactorLevelResult[];\n /** The level that beats the first one significantly with the largest lift, if any. */\n best: string | null;\n}\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 /** Multivariate experiments only: each factor's main effect. */\n factors?: FactorResult[];\n}\n\n/**\n * Main effects of a multivariate experiment: for each factor, every level's\n * visitors and conversions summed over the combinations that use it, compared\n * with the factor's first level. The same z-test as the verdict, so the\n * numbers agree with the per-combination table.\n */\nexport function factorEffects(experiment: Experiment, counts: VariantCounts[]): FactorResult[] {\n if (!experiment.factors?.length) return [];\n return experiment.factors.map((factor) => {\n const perLevel: VariantCounts[] = factor.levels.map((level) => {\n const combos = experiment.variants.filter((v) => v.levels?.[factor.key] === level).map((v) => v.key);\n const rows = counts.filter((c) => combos.includes(c.variant));\n return { variant: level, exposures: rows.reduce((s, r) => s + r.exposures, 0), conversions: rows.reduce((s, r) => s + r.conversions, 0) };\n });\n const comparisons = perLevel.every((l) => l.exposures > 0) ? compareVariants(perLevel) : [];\n const levels: FactorLevelResult[] = perLevel.map((l, i) => {\n const cmp = comparisons.find((c) => c.variant === l.variant);\n return {\n level: l.variant,\n exposures: l.exposures,\n conversions: l.conversions,\n rate: l.exposures ? l.conversions / l.exposures : 0,\n relativeLift: i === 0 ? null : (cmp?.relativeLift ?? null),\n pValue: i === 0 ? null : (cmp?.pValue ?? null),\n significant: Boolean(cmp?.significant),\n };\n });\n const winners = levels.filter((l) => l.significant && (l.relativeLift ?? 0) > 0).sort((a, b) => (b.relativeLift ?? 0) - (a.relativeLift ?? 0));\n return { key: factor.key, levels, best: winners[0]?.level ?? null };\n });\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, ...(experiment.kind === 'mvt' && goal ? { factors: factorEffects(experiment, counts) } : {}) };\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 * counts once per experiment, in the variant of their earliest exposure, and\n * converts when a goal arrived at or after that exposure.\n */\nexport interface Store {\n /** Insert events, ignoring ids already present. Returns the number inserted. */\n insertEvents(events: StoredEvent[]): Promise<number>;\n /**\n * Unique exposed and converted visitors per variant (any order). A visitor\n * belongs to the variant of their earliest exposure (same ts → smallest\n * variant key) and converts when a goal has ts >= that exposure.\n */\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 // Earliest exposure per visitor decides their variant; a tie on ts goes to\n // the smallest variant key so every store answers the same.\n const earliest = new Map<string, { variant: string; ts: number }>(); // visitor -> earliest exposure\n for (const e of events) {\n if (e.type !== 'exposure' || e.experiment !== experiment || !e.variant) continue;\n const prev = earliest.get(e.visitorId);\n if (prev === undefined || e.ts < prev.ts || (e.ts === prev.ts && e.variant < prev.variant)) {\n earliest.set(e.visitorId, { variant: e.variant, ts: e.ts });\n }\n }\n const firstExposure = new Map<string, Map<string, number>>(); // variant -> visitor -> ts\n for (const [visitor, { variant, ts }] of earliest) {\n const byVisitor = firstExposure.get(variant) ?? new Map<string, number>();\n byVisitor.set(visitor, ts);\n firstExposure.set(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/dist/index.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { SplitHubConfig } from '@splithub/core';
|
|
1
|
+
import { SplitHubConfig, Experiment } from '@splithub/core';
|
|
2
2
|
import { VariantCounts, Verdict } from '@splithub/stats';
|
|
3
3
|
import { IncomingMessage, ServerResponse } from 'node:http';
|
|
4
4
|
|
|
@@ -44,13 +44,17 @@ interface ExperimentSummary {
|
|
|
44
44
|
/**
|
|
45
45
|
* Storage adapter. Implement this against your database to keep all data in
|
|
46
46
|
* your own infrastructure. Attribution rule for `variantCounts`: a visitor
|
|
47
|
-
*
|
|
48
|
-
*
|
|
47
|
+
* counts once per experiment, in the variant of their earliest exposure, and
|
|
48
|
+
* converts when a goal arrived at or after that exposure.
|
|
49
49
|
*/
|
|
50
50
|
interface Store {
|
|
51
51
|
/** Insert events, ignoring ids already present. Returns the number inserted. */
|
|
52
52
|
insertEvents(events: StoredEvent[]): Promise<number>;
|
|
53
|
-
/**
|
|
53
|
+
/**
|
|
54
|
+
* Unique exposed and converted visitors per variant (any order). A visitor
|
|
55
|
+
* belongs to the variant of their earliest exposure (same ts → smallest
|
|
56
|
+
* variant key) and converts when a goal has ts >= that exposure.
|
|
57
|
+
*/
|
|
54
58
|
variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;
|
|
55
59
|
summaries(): Promise<ExperimentSummary[]>;
|
|
56
60
|
close?(): Promise<void> | void;
|
|
@@ -93,6 +97,24 @@ declare function createSplitHubHandler(options: HandlerOptions): FetchHandler;
|
|
|
93
97
|
*/
|
|
94
98
|
declare function toNodeListener(handler: FetchHandler): (req: IncomingMessage, res: ServerResponse) => void;
|
|
95
99
|
|
|
100
|
+
/** One level of a multivariate factor, summed over every combination that uses it. */
|
|
101
|
+
interface FactorLevelResult {
|
|
102
|
+
level: string;
|
|
103
|
+
exposures: number;
|
|
104
|
+
conversions: number;
|
|
105
|
+
rate: number;
|
|
106
|
+
/** Relative lift vs the factor's first level; null for that level itself. */
|
|
107
|
+
relativeLift: number | null;
|
|
108
|
+
pValue: number | null;
|
|
109
|
+
significant: boolean;
|
|
110
|
+
}
|
|
111
|
+
/** A multivariate factor read on its own (its main effect), independent of the other factors. */
|
|
112
|
+
interface FactorResult {
|
|
113
|
+
key: string;
|
|
114
|
+
levels: FactorLevelResult[];
|
|
115
|
+
/** The level that beats the first one significantly with the largest lift, if any. */
|
|
116
|
+
best: string | null;
|
|
117
|
+
}
|
|
96
118
|
interface ExperimentResults {
|
|
97
119
|
experiment: string;
|
|
98
120
|
kind: string;
|
|
@@ -100,7 +122,16 @@ interface ExperimentResults {
|
|
|
100
122
|
goal: string | null;
|
|
101
123
|
description: string | null;
|
|
102
124
|
verdict: Verdict;
|
|
125
|
+
/** Multivariate experiments only: each factor's main effect. */
|
|
126
|
+
factors?: FactorResult[];
|
|
103
127
|
}
|
|
128
|
+
/**
|
|
129
|
+
* Main effects of a multivariate experiment: for each factor, every level's
|
|
130
|
+
* visitors and conversions summed over the combinations that use it, compared
|
|
131
|
+
* with the factor's first level. The same z-test as the verdict, so the
|
|
132
|
+
* numbers agree with the per-combination table.
|
|
133
|
+
*/
|
|
134
|
+
declare function factorEffects(experiment: Experiment, counts: VariantCounts[]): FactorResult[];
|
|
104
135
|
interface StatusRow {
|
|
105
136
|
experiment: string;
|
|
106
137
|
kind: string;
|
|
@@ -136,4 +167,4 @@ type ValidationResult = {
|
|
|
136
167
|
/** `expectedProject` null skips the name check (the caller already identified the project, e.g. by public key). */
|
|
137
168
|
declare function validateBatch(body: unknown, expectedProject: string | null, now?: number): ValidationResult;
|
|
138
169
|
|
|
139
|
-
export { type ExperimentResults, type ExperimentSummary, type FetchHandler, type HandlerOptions, type StatusRow, type Store, type StoredEvent, bestOf, createMemoryStore, createSplitHubHandler, experimentResults, headlineFor, statusTable, toNodeListener, validateBatch };
|
|
170
|
+
export { type ExperimentResults, type ExperimentSummary, type FactorLevelResult, type FactorResult, type FetchHandler, type HandlerOptions, type StatusRow, type Store, type StoredEvent, bestOf, createMemoryStore, createSplitHubHandler, experimentResults, factorEffects, headlineFor, statusTable, toNodeListener, validateBatch };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { SplitHubConfig } from '@splithub/core';
|
|
1
|
+
import { SplitHubConfig, Experiment } from '@splithub/core';
|
|
2
2
|
import { VariantCounts, Verdict } from '@splithub/stats';
|
|
3
3
|
import { IncomingMessage, ServerResponse } from 'node:http';
|
|
4
4
|
|
|
@@ -44,13 +44,17 @@ interface ExperimentSummary {
|
|
|
44
44
|
/**
|
|
45
45
|
* Storage adapter. Implement this against your database to keep all data in
|
|
46
46
|
* your own infrastructure. Attribution rule for `variantCounts`: a visitor
|
|
47
|
-
*
|
|
48
|
-
*
|
|
47
|
+
* counts once per experiment, in the variant of their earliest exposure, and
|
|
48
|
+
* converts when a goal arrived at or after that exposure.
|
|
49
49
|
*/
|
|
50
50
|
interface Store {
|
|
51
51
|
/** Insert events, ignoring ids already present. Returns the number inserted. */
|
|
52
52
|
insertEvents(events: StoredEvent[]): Promise<number>;
|
|
53
|
-
/**
|
|
53
|
+
/**
|
|
54
|
+
* Unique exposed and converted visitors per variant (any order). A visitor
|
|
55
|
+
* belongs to the variant of their earliest exposure (same ts → smallest
|
|
56
|
+
* variant key) and converts when a goal has ts >= that exposure.
|
|
57
|
+
*/
|
|
54
58
|
variantCounts(experiment: string, goal: string): Promise<VariantCounts[]>;
|
|
55
59
|
summaries(): Promise<ExperimentSummary[]>;
|
|
56
60
|
close?(): Promise<void> | void;
|
|
@@ -93,6 +97,24 @@ declare function createSplitHubHandler(options: HandlerOptions): FetchHandler;
|
|
|
93
97
|
*/
|
|
94
98
|
declare function toNodeListener(handler: FetchHandler): (req: IncomingMessage, res: ServerResponse) => void;
|
|
95
99
|
|
|
100
|
+
/** One level of a multivariate factor, summed over every combination that uses it. */
|
|
101
|
+
interface FactorLevelResult {
|
|
102
|
+
level: string;
|
|
103
|
+
exposures: number;
|
|
104
|
+
conversions: number;
|
|
105
|
+
rate: number;
|
|
106
|
+
/** Relative lift vs the factor's first level; null for that level itself. */
|
|
107
|
+
relativeLift: number | null;
|
|
108
|
+
pValue: number | null;
|
|
109
|
+
significant: boolean;
|
|
110
|
+
}
|
|
111
|
+
/** A multivariate factor read on its own (its main effect), independent of the other factors. */
|
|
112
|
+
interface FactorResult {
|
|
113
|
+
key: string;
|
|
114
|
+
levels: FactorLevelResult[];
|
|
115
|
+
/** The level that beats the first one significantly with the largest lift, if any. */
|
|
116
|
+
best: string | null;
|
|
117
|
+
}
|
|
96
118
|
interface ExperimentResults {
|
|
97
119
|
experiment: string;
|
|
98
120
|
kind: string;
|
|
@@ -100,7 +122,16 @@ interface ExperimentResults {
|
|
|
100
122
|
goal: string | null;
|
|
101
123
|
description: string | null;
|
|
102
124
|
verdict: Verdict;
|
|
125
|
+
/** Multivariate experiments only: each factor's main effect. */
|
|
126
|
+
factors?: FactorResult[];
|
|
103
127
|
}
|
|
128
|
+
/**
|
|
129
|
+
* Main effects of a multivariate experiment: for each factor, every level's
|
|
130
|
+
* visitors and conversions summed over the combinations that use it, compared
|
|
131
|
+
* with the factor's first level. The same z-test as the verdict, so the
|
|
132
|
+
* numbers agree with the per-combination table.
|
|
133
|
+
*/
|
|
134
|
+
declare function factorEffects(experiment: Experiment, counts: VariantCounts[]): FactorResult[];
|
|
104
135
|
interface StatusRow {
|
|
105
136
|
experiment: string;
|
|
106
137
|
kind: string;
|
|
@@ -136,4 +167,4 @@ type ValidationResult = {
|
|
|
136
167
|
/** `expectedProject` null skips the name check (the caller already identified the project, e.g. by public key). */
|
|
137
168
|
declare function validateBatch(body: unknown, expectedProject: string | null, now?: number): ValidationResult;
|
|
138
169
|
|
|
139
|
-
export { type ExperimentResults, type ExperimentSummary, type FetchHandler, type HandlerOptions, type StatusRow, type Store, type StoredEvent, bestOf, createMemoryStore, createSplitHubHandler, experimentResults, headlineFor, statusTable, toNodeListener, validateBatch };
|
|
170
|
+
export { type ExperimentResults, type ExperimentSummary, type FactorLevelResult, type FactorResult, type FetchHandler, type HandlerOptions, type StatusRow, type Store, type StoredEvent, bestOf, createMemoryStore, createSplitHubHandler, experimentResults, factorEffects, headlineFor, statusTable, toNodeListener, validateBatch };
|
package/dist/index.js
CHANGED
|
@@ -1,6 +1,31 @@
|
|
|
1
1
|
// src/results.ts
|
|
2
2
|
import { getExperiment } from "@splithub/core";
|
|
3
|
-
import { computeVerdict } from "@splithub/stats";
|
|
3
|
+
import { compareVariants, computeVerdict } from "@splithub/stats";
|
|
4
|
+
function factorEffects(experiment, counts) {
|
|
5
|
+
if (!experiment.factors?.length) return [];
|
|
6
|
+
return experiment.factors.map((factor) => {
|
|
7
|
+
const perLevel = factor.levels.map((level) => {
|
|
8
|
+
const combos = experiment.variants.filter((v) => v.levels?.[factor.key] === level).map((v) => v.key);
|
|
9
|
+
const rows = counts.filter((c) => combos.includes(c.variant));
|
|
10
|
+
return { variant: level, exposures: rows.reduce((s, r) => s + r.exposures, 0), conversions: rows.reduce((s, r) => s + r.conversions, 0) };
|
|
11
|
+
});
|
|
12
|
+
const comparisons = perLevel.every((l) => l.exposures > 0) ? compareVariants(perLevel) : [];
|
|
13
|
+
const levels = perLevel.map((l, i) => {
|
|
14
|
+
const cmp = comparisons.find((c) => c.variant === l.variant);
|
|
15
|
+
return {
|
|
16
|
+
level: l.variant,
|
|
17
|
+
exposures: l.exposures,
|
|
18
|
+
conversions: l.conversions,
|
|
19
|
+
rate: l.exposures ? l.conversions / l.exposures : 0,
|
|
20
|
+
relativeLift: i === 0 ? null : cmp?.relativeLift ?? null,
|
|
21
|
+
pValue: i === 0 ? null : cmp?.pValue ?? null,
|
|
22
|
+
significant: Boolean(cmp?.significant)
|
|
23
|
+
};
|
|
24
|
+
});
|
|
25
|
+
const winners = levels.filter((l) => l.significant && (l.relativeLift ?? 0) > 0).sort((a, b) => (b.relativeLift ?? 0) - (a.relativeLift ?? 0));
|
|
26
|
+
return { key: factor.key, levels, best: winners[0]?.level ?? null };
|
|
27
|
+
});
|
|
28
|
+
}
|
|
4
29
|
async function experimentResults(config, store, key) {
|
|
5
30
|
const experiment = getExperiment(config, key);
|
|
6
31
|
if (!experiment) return null;
|
|
@@ -11,7 +36,7 @@ async function experimentResults(config, store, key) {
|
|
|
11
36
|
return { variant: v.key, exposures: row?.exposures ?? 0, conversions: row?.conversions ?? 0, revenue: row?.revenue ?? 0 };
|
|
12
37
|
});
|
|
13
38
|
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 };
|
|
39
|
+
return { experiment: key, kind: experiment.kind, status: experiment.status, goal, description: experiment.description, verdict, ...experiment.kind === "mvt" && goal ? { factors: factorEffects(experiment, counts) } : {} };
|
|
15
40
|
}
|
|
16
41
|
async function statusTable(config, store) {
|
|
17
42
|
const summaries = await store.summaries();
|
|
@@ -212,13 +237,19 @@ function createMemoryStore() {
|
|
|
212
237
|
return n;
|
|
213
238
|
},
|
|
214
239
|
async variantCounts(experiment, goal) {
|
|
215
|
-
const
|
|
240
|
+
const earliest = /* @__PURE__ */ new Map();
|
|
216
241
|
for (const e of events) {
|
|
217
242
|
if (e.type !== "exposure" || e.experiment !== experiment || !e.variant) continue;
|
|
218
|
-
const
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
243
|
+
const prev = earliest.get(e.visitorId);
|
|
244
|
+
if (prev === void 0 || e.ts < prev.ts || e.ts === prev.ts && e.variant < prev.variant) {
|
|
245
|
+
earliest.set(e.visitorId, { variant: e.variant, ts: e.ts });
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
const firstExposure = /* @__PURE__ */ new Map();
|
|
249
|
+
for (const [visitor, { variant, ts }] of earliest) {
|
|
250
|
+
const byVisitor = firstExposure.get(variant) ?? /* @__PURE__ */ new Map();
|
|
251
|
+
byVisitor.set(visitor, ts);
|
|
252
|
+
firstExposure.set(variant, byVisitor);
|
|
222
253
|
}
|
|
223
254
|
const goalsByVisitor = /* @__PURE__ */ new Map();
|
|
224
255
|
for (const e of events) {
|
|
@@ -270,6 +301,7 @@ export {
|
|
|
270
301
|
createMemoryStore,
|
|
271
302
|
createSplitHubHandler,
|
|
272
303
|
experimentResults,
|
|
304
|
+
factorEffects,
|
|
273
305
|
headlineFor,
|
|
274
306
|
statusTable,
|
|
275
307
|
toNodeListener,
|
package/dist/index.js.map
CHANGED
|
@@ -1 +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":[]}
|
|
1
|
+
{"version":3,"sources":["../src/results.ts","../src/validate.ts","../src/handler.ts","../src/nodeAdapter.ts","../src/store.ts"],"sourcesContent":["import { getExperiment, type Experiment, type SplitHubConfig } from '@splithub/core';\nimport { compareVariants, computeVerdict, type VariantCounts, type Verdict } from '@splithub/stats';\nimport type { ExperimentSummary, Store } from './store';\n\n/** One level of a multivariate factor, summed over every combination that uses it. */\nexport interface FactorLevelResult {\n level: string;\n exposures: number;\n conversions: number;\n rate: number;\n /** Relative lift vs the factor's first level; null for that level itself. */\n relativeLift: number | null;\n pValue: number | null;\n significant: boolean;\n}\n\n/** A multivariate factor read on its own (its main effect), independent of the other factors. */\nexport interface FactorResult {\n key: string;\n levels: FactorLevelResult[];\n /** The level that beats the first one significantly with the largest lift, if any. */\n best: string | null;\n}\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 /** Multivariate experiments only: each factor's main effect. */\n factors?: FactorResult[];\n}\n\n/**\n * Main effects of a multivariate experiment: for each factor, every level's\n * visitors and conversions summed over the combinations that use it, compared\n * with the factor's first level. The same z-test as the verdict, so the\n * numbers agree with the per-combination table.\n */\nexport function factorEffects(experiment: Experiment, counts: VariantCounts[]): FactorResult[] {\n if (!experiment.factors?.length) return [];\n return experiment.factors.map((factor) => {\n const perLevel: VariantCounts[] = factor.levels.map((level) => {\n const combos = experiment.variants.filter((v) => v.levels?.[factor.key] === level).map((v) => v.key);\n const rows = counts.filter((c) => combos.includes(c.variant));\n return { variant: level, exposures: rows.reduce((s, r) => s + r.exposures, 0), conversions: rows.reduce((s, r) => s + r.conversions, 0) };\n });\n const comparisons = perLevel.every((l) => l.exposures > 0) ? compareVariants(perLevel) : [];\n const levels: FactorLevelResult[] = perLevel.map((l, i) => {\n const cmp = comparisons.find((c) => c.variant === l.variant);\n return {\n level: l.variant,\n exposures: l.exposures,\n conversions: l.conversions,\n rate: l.exposures ? l.conversions / l.exposures : 0,\n relativeLift: i === 0 ? null : (cmp?.relativeLift ?? null),\n pValue: i === 0 ? null : (cmp?.pValue ?? null),\n significant: Boolean(cmp?.significant),\n };\n });\n const winners = levels.filter((l) => l.significant && (l.relativeLift ?? 0) > 0).sort((a, b) => (b.relativeLift ?? 0) - (a.relativeLift ?? 0));\n return { key: factor.key, levels, best: winners[0]?.level ?? null };\n });\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, ...(experiment.kind === 'mvt' && goal ? { factors: factorEffects(experiment, counts) } : {}) };\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 * counts once per experiment, in the variant of their earliest exposure, and\n * converts when a goal arrived at or after that exposure.\n */\nexport interface Store {\n /** Insert events, ignoring ids already present. Returns the number inserted. */\n insertEvents(events: StoredEvent[]): Promise<number>;\n /**\n * Unique exposed and converted visitors per variant (any order). A visitor\n * belongs to the variant of their earliest exposure (same ts → smallest\n * variant key) and converts when a goal has ts >= that exposure.\n */\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 // Earliest exposure per visitor decides their variant; a tie on ts goes to\n // the smallest variant key so every store answers the same.\n const earliest = new Map<string, { variant: string; ts: number }>(); // visitor -> earliest exposure\n for (const e of events) {\n if (e.type !== 'exposure' || e.experiment !== experiment || !e.variant) continue;\n const prev = earliest.get(e.visitorId);\n if (prev === undefined || e.ts < prev.ts || (e.ts === prev.ts && e.variant < prev.variant)) {\n earliest.set(e.visitorId, { variant: e.variant, ts: e.ts });\n }\n }\n const firstExposure = new Map<string, Map<string, number>>(); // variant -> visitor -> ts\n for (const [visitor, { variant, ts }] of earliest) {\n const byVisitor = firstExposure.get(variant) ?? new Map<string, number>();\n byVisitor.set(visitor, ts);\n firstExposure.set(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,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@splithub/node",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "Run SplitHub on your own server: one handler for events and results, your database behind a small Store interface.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -19,8 +19,8 @@
|
|
|
19
19
|
"README.md"
|
|
20
20
|
],
|
|
21
21
|
"dependencies": {
|
|
22
|
-
"@splithub/stats": "0.1.
|
|
23
|
-
"@splithub/core": "0.1.
|
|
22
|
+
"@splithub/stats": "0.1.3",
|
|
23
|
+
"@splithub/core": "0.1.3"
|
|
24
24
|
},
|
|
25
25
|
"devDependencies": {
|
|
26
26
|
"@types/node": "^22.9.0",
|