next-evolve 0.1.0 → 0.3.1

package/dist/core/assign.js

@@ -15,6 +15,28 @@ function weightedPick(variants, r) {
 	return last;
 }
 /**
+* Deterministic draws for one visitor: the same `evolve_id` and experiment give
+* the same assignment on every request, so concurrent first requests (a link
+* prefetch and the click that follows) can't assign different variants.
+* FNV-1a with a murmur3 finalizer; uniform enough for traffic splits, not crypto.
+*/
+function visitorDraw(anonId) {
+	return (key) => {
+		let h = 2166136261;
+		const s = `${anonId}|${key}`;
+		for (let i = 0; i < s.length; i++) {
+			h ^= s.charCodeAt(i);
+			h = Math.imul(h, 16777619);
+		}
+		h ^= h >>> 16;
+		h = Math.imul(h, 2246822507);
+		h ^= h >>> 13;
+		h = Math.imul(h, 3266489909);
+		h ^= h >>> 16;
+		return (h >>> 0) / 4294967296;
+	};
+}
+/**
 * Assigns a visitor to the experiments on `path` (spec §6.3). Pure: no I/O.
 * Sticky: an active assignment is kept. Completed experiments render their
 * winner and aren't counted. Cookie entries for experiments no longer in the
@@ -56,7 +78,7 @@ function assign(bundle, path, cookie, rand) {
 			continue;
 		}
 		changed = true;
-		if (rand() >= e.traffic) {
+		if (rand(`${exp}:t`) >= e.traffic) {
 			assigned.set(exp, "x");
 			pairs.push({
 				exp,
@@ -65,7 +87,7 @@ function assign(bundle, path, cookie, rand) {
 			});
 			continue;
 		}
-		const v = weightedPick(e.variants, rand());
+		const v = weightedPick(e.variants, rand(`${exp}:v`));
 		assigned.set(exp, v);
 		pairs.push({
 			exp,
@@ -79,4 +101,4 @@ function assign(bundle, path, cookie, rand) {
 		changed
 	};
 }
-export { assign, weightedPick };
+export { assign, visitorDraw, weightedPick };

package/dist/db/writer.d.ts

@@ -5,6 +5,8 @@ export type ExposureRow = {
   anon_id: string;
   variant_id: string;
   path: string;
+  /** When the beacon arrived (same clock as event `ts`), not when the batch is written. */
+  first_at: Date;
 };
 export type EventRow = {
   ts: Date;

package/dist/db/writer.js

@@ -46,7 +46,7 @@ function createWriter(opts) {
 		}
 	}
 	async function write(sql, batch) {
-		for (const rows of chunks(batch.exposures)) await sql`insert into evolve.exposures ${sql(rows, "experiment_id", "anon_id", "variant_id", "path")}
+		for (const rows of chunks(batch.exposures)) await sql`insert into evolve.exposures ${sql(rows, "experiment_id", "anon_id", "variant_id", "path", "first_at")}
         on conflict do nothing`;
 		for (const rows of chunks(batch.events)) await sql`insert into evolve.events ${sql(rows.map((r) => ({
 			...r,

package/dist/instrumentation/index.d.ts

@@ -15,8 +15,9 @@ export type RegisterEvolveOptions = {
  *   }
  *
  * Registers the goals for this process and pushes the manifest to the cloud
- * (goals, routes, versions, app URL; spec §8.4), once per process. Never
- * throws. Background polling and the disk cache arrive with T7.4.
+ * (goals, routes, versions, app URL; spec §8.4), once per process. On
+ * long-running Node it also polls the bundle in the background (spec §7.5),
+ * so the disk cache stays fresh between requests. Never throws.
  */
 export declare function registerEvolve(opts: RegisterEvolveOptions): Promise<void>;
 /** Test helper. */

package/dist/instrumentation/index.js

@@ -1,8 +1,11 @@
 import { buildManifest, detectAppUrl } from "../cloud/manifest.js";
 import { pushToCloud } from "../cloud/push.js";
+import { resolveConfig } from "../config/config.js";
 import { setRuntime } from "../server/runtime.js";
+import { getBundleStore, isLongRunningNode } from "../store/runtime.js";
 // src/instrumentation/index.ts
 let registered = false;
+let poll = null;
 /**
 * Call from `instrumentation.ts` `register()`:
 *
@@ -14,8 +17,9 @@ let registered = false;
 *   }
 *
 * Registers the goals for this process and pushes the manifest to the cloud
-* (goals, routes, versions, app URL; spec §8.4), once per process. Never
-* throws. Background polling and the disk cache arrive with T7.4.
+* (goals, routes, versions, app URL; spec §8.4), once per process. On
+* long-running Node it also polls the bundle in the background (spec §7.5),
+* so the disk cache stays fresh between requests. Never throws.
 */
 async function registerEvolve(opts) {
 	if (registered) return;
@@ -25,6 +29,15 @@ async function registerEvolve(opts) {
 			config: opts.config,
 			goals: opts.goals
 		});
+		if (isLongRunningNode()) {
+			const cfg = resolveConfig(opts.config);
+			const store = getBundleStore(cfg);
+			if (store) {
+				store.refresh();
+				poll = setInterval(() => void store.refresh(), cfg.pollSeconds * 1e3);
+				poll.unref();
+			}
+		}
 		const manifest = buildManifest(opts.config, opts.goals, { appUrl: detectAppUrl() });
 		const res = await pushToCloud("/v1/manifest", manifest);
 		if (!res.ok && res.status !== "no_key") console.error(`[evolve] manifest push failed (${res.status})`);
@@ -35,5 +48,7 @@ async function registerEvolve(opts) {
 /** Test helper. */
 function resetRegisterEvolve() {
 	registered = false;
+	if (poll) clearInterval(poll);
+	poll = null;
 }
 export { registerEvolve, resetRegisterEvolve };