next-evolve 0.0.0-stage → 0.3.1

package/dist/store/runtime.js

@@ -0,0 +1,101 @@
+import { trustedKeys } from "../core/keys.js";
+import { defaultDiskDir, diskPath, readDisk, writeDisk } from "./disk.js";
+import { fetchBundle } from "./fetch.js";
+import { GLOBAL_CONFIG_TTL_MS, createGlobalConfigFetcher, defaultReader, globalConfigSettings } from "./global-config.js";
+import { createMemoryStore } from "./memory.js";
+import { parseSecretKey } from "@next-evolve/protocol";
+// src/store/runtime.ts
+/** True off serverless hosts: a process that lives across requests (next start, Docker). */
+function isLongRunningNode(env = process.env) {
+	return !env.VERCEL && !env.AWS_LAMBDA_FUNCTION_NAME && !env.NETLIFY;
+}
+/** Default cloud URL (decision D29). Override with EVOLVE_CLOUD_URL. */
+const DEFAULT_CLOUD_URL = "https://api.evolveab.com";
+const REGISTRY = Symbol.for("next-evolve.stores");
+const registry = () => {
+	const g = globalThis;
+	g[REGISTRY] ??= /* @__PURE__ */ new Map();
+	return g[REGISTRY];
+};
+/**
+* The process-wide bundle store for this site, shared by the proxy and the
+* render path when they run in the same process. Null when the app has no
+* valid secret key (then everything serves control).
+*/
+function getBundleStore(config, opts = {}) {
+	if (opts.store) return opts.store;
+	const env = opts.env ?? process.env;
+	const secretKey = env.EVOLVE_SECRET_KEY;
+	const site = secretKey ? parseSecretKey(secretKey)?.siteId : void 0;
+	if (!secretKey || !site) return null;
+	const reg = registry();
+	const existing = reg.get(site);
+	if (existing) {
+		if (opts.buildBundle && !existing.token()) existing.load(opts.buildBundle);
+		return existing;
+	}
+	const cloudUrl = env.EVOLVE_CLOUD_URL ?? "https://api.evolveab.com";
+	const disk = isLongRunningNode(env) ? diskPath(opts.diskDir ?? env.EVOLVE_CACHE_DIR ?? defaultDiskDir(), site) : null;
+	const pollMs = (config.pollSeconds ?? (env.NODE_ENV === "production" ? 60 : 5)) * 1e3;
+	const cloud = cloudUrl ? (etag) => fetchBundle({
+		cloudUrl,
+		secretKey,
+		etag
+	}) : void 0;
+	const gc = globalConfigSettings(config.store, env);
+	const store = createMemoryStore({
+		site,
+		keys: trustedKeys(env),
+		pollMs: gc ? Math.min(pollMs, GLOBAL_CONFIG_TTL_MS) : pollMs,
+		initialToken: opts.buildBundle ?? null,
+		fetcher: gc ? createGlobalConfigFetcher({
+			site,
+			read: opts.globalConfigReader ?? defaultReader(gc.connectionString),
+			cloud,
+			cloudEveryMs: pollMs
+		}) : cloud,
+		...disk ? { onAccept: (token) => writeDisk(disk, token) } : {}
+	});
+	if (disk) {
+		const cached = readDisk(disk);
+		if (cached && cached !== store.token()) store.load(cached);
+	}
+	reg.set(site, store);
+	if (gc) coldReads.set(store, true);
+	return store;
+}
+const coldReads = /* @__PURE__ */ new WeakMap();
+/**
+* Global Config hosts, first request of an instance: a promise that resolves
+* after one Global Config read or {@link COLD_READ_CAP_MS}, whichever comes
+* first (spec §7.8). Null when there's nothing to wait for.
+*/
+function coldStart(store) {
+	if (!coldReads.get(store)) return null;
+	coldReads.delete(store);
+	return Promise.race([store.refresh(), new Promise((r) => setTimeout(r, 20))]);
+}
+const identities = /* @__PURE__ */ new Map();
+/** This app's site id (from EVOLVE_SECRET_KEY) and trusted public keys. Cached; null without a valid key. */
+function getSiteIdentity(opts = {}) {
+	const env = opts.env ?? process.env;
+	const cacheKey = [
+		env.EVOLVE_SECRET_KEY,
+		env.EVOLVE_UNSAFE_TEST_PUBLIC_KEY,
+		env.EVOLVE_UNSAFE_ALLOW_TEST_KEY,
+		env.NODE_ENV
+	].join("|");
+	if (identities.has(cacheKey)) return identities.get(cacheKey);
+	const site = env.EVOLVE_SECRET_KEY ? parseSecretKey(env.EVOLVE_SECRET_KEY)?.siteId : void 0;
+	const id = site ? {
+		site,
+		keys: trustedKeys(env)
+	} : null;
+	identities.set(cacheKey, id);
+	return id;
+}
+/** Test helper: forget all stores. */
+function resetBundleStores() {
+	registry().clear();
+}
+export { DEFAULT_CLOUD_URL, coldStart, getBundleStore, getSiteIdentity, isLongRunningNode, resetBundleStores };

package/migrations/0001_init.sql

@@ -0,0 +1,56 @@
+-- next-evolve customer schema (spec §8.3). Raw events stay in this database.
+-- Applied by `npx next-evolve migrate`; the migrator creates `evolve.migrations`.
+
+-- One row per unit per experiment (first exposure).
+create table evolve.exposures (
+  experiment_id text not null,
+  anon_id text not null,
+  variant_id text not null,
+  first_at timestamptz not null default now(),
+  path text not null,
+  segment text, -- null = main; Phase 3: UTM rule id
+  primary key (experiment_id, anon_id)
+);
+create index exposures_exp_first on evolve.exposures (experiment_id, first_at);
+
+create table evolve.events (
+  id bigint generated always as identity primary key,
+  ts timestamptz not null,
+  received_at timestamptz not null default now(),
+  name text not null,
+  anon_id text,
+  user_id text,
+  value double precision,
+  goal_values jsonb,
+  props jsonb,
+  source text not null,
+  path text,
+  dedupe_key text
+);
+create index events_name_ts on evolve.events (name, ts);
+create index events_anon_name on evolve.events (anon_id, name, ts) where anon_id is not null;
+create index events_user_name on evolve.events (user_id, name, ts) where user_id is not null;
+create unique index events_dedupe on evolve.events (dedupe_key) where dedupe_key is not null;
+
+create table evolve.identities (
+  anon_id text primary key,
+  user_id text not null,
+  linked_at timestamptz not null default now()
+);
+create index identities_user on evolve.identities (user_id);
+
+create table evolve.usage_daily (
+  day date primary key,
+  tested_pageviews bigint not null default 0
+);
+
+-- Idempotency cache + audit of what aggregate requests returned (kept 24 h).
+create table evolve.aggregate_runs (
+  request_id text primary key,
+  received_at timestamptz not null,
+  mode text not null,
+  status text not null,
+  duration_ms int,
+  response_hash text,
+  response jsonb
+);

package/package.json

@@ -1,6 +1,76 @@
 {
   "name": "next-evolve",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.3.1",
+  "description": "Self-improving Next.js sites: server-side variants with no flicker, measured in your own Postgres.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "migrations"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./proxy": {
+      "types": "./dist/proxy/index.d.ts",
+      "import": "./dist/proxy/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./instrumentation": {
+      "types": "./dist/instrumentation/index.d.ts",
+      "import": "./dist/instrumentation/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@vercel/global-config": "1.5.1",
+    "isbot": "5.2.2",
+    "postgres": "3.4.9",
+    "server-only": "^0.0.1",
+    "@next-evolve/protocol": "0.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=15.5.0",
+    "react": "^19.0.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.3.0",
+    "fast-check": "^4.10.2",
+    "next": "16.4.3",
+    "react": "19.3.1",
+    "react-dom": "19.3.1",
+    "zod": "^4.6.7",
+    "@next-evolve/fake-cloud": "0.0.0"
+  },
+  "engines": {
+    "node": ">=22.12"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "next-evolve": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsdown && node scripts/check-dist.mjs && node scripts/check-proxy-imports.mjs && node scripts/check-size.mjs",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --project unit",
+    "test:int": "vitest run --project integration"
+  }
 }