@iann29/rastro 0.1.0-alpha.4 → 0.1.0-alpha.6

package/docs/benchmarks/2026-08-30-alpha6-recertification.md

@@ -0,0 +1,206 @@
+# Ingest recertification, 2026-08-30
+
+This report recertifies the four workload profiles ahead of `0.1.0-alpha.6`,
+against the same deployment and benchmark site as the
+[2026-08-21 formal certification](2026-08-21-formal-certification.md). It is
+engineering evidence for the tested revisions and deployment state, not a
+production SLA.
+
+## Environment
+
+| Item                | Value                                                            |
+| ------------------- | ---------------------------------------------------------------- |
+| Deployment          | DEV canary `fast-finch-7454` (unchanged since 2026-08-21)        |
+| Benchmark site      | `kx75pnr9wap522n0zmh4nnb4jh8cv110` (unchanged)                   |
+| Lean run revision   | `ba9eff1` (main before Web Vitals)                               |
+| Later run revisions | Web Vitals build; component sources identical to merge `6250526` |
+| Driver              | One local Node.js process                                        |
+| Reconciliation      | Exact run-scoped session IDs, indexed pages of 100               |
+| GeoIP provider      | Disabled                                                         |
+| Health before runs  | `ok: true`                                                       |
+
+Since the 2026-08-21 certification the wire path gained salted daily visitor
+keys, User-Agent bot rejection, client-hint browser detection, the federation
+hardening, and the `vital` ingest branch (present but idle: no profile sends
+vitals). Unlike 2026-08-21, the canary was not fresh: it accumulated the
+battery's own multi-million-event history while the profiles ran, which is the
+honest way most deployments look after a real day.
+
+All certified runs used `--duration 600 --certify`, ran sequentially with at
+least five minutes of cooldown, and had no competing local load. Two runs were
+discarded and repeated because the local DNS resolver failed their first
+connection wave (a client-side condition — the deployment was idle and healthy
+each time); one more was discarded after a mid-run deploy from this same
+machine. Discarded runs are not reported as capacity.
+
+## Results
+
+Meeting the 100 million stored-events/day target requires at least 1,157.41
+stored events/second.
+
+| Profile   | Concurrency | Batch | Sessions |  Accepted |    Stored | Stored/s | Certified stored/day |      p95 | Exact reconciliation  | 100M/day target  |
+| --------- | ----------: | ----: | -------: | --------: | --------: | -------: | -------------------: | -------: | --------------------- | ---------------- |
+| Lean      |         100 |    50 |   unique | 1,247,000 | 1,247,000 |    2,071 |          178,948,552 | 4,167 ms | 1,247,000 / 1,247,000 | Pass             |
+| Realistic |          75 |    50 |    4,096 | 1,039,050 |   988,995 |    1,644 |          142,036,529 | 4,953 ms | 988,995 / 988,995     | Pass             |
+| Heavy     |         100 |    20 |    2,048 |   388,040 |   388,040 |      640 |           55,259,642 | 7,702 ms | 388,040 / 388,040     | **Below target** |
+| Feature   |         100 |    15 |    2,048 |         — |         — |        — |           **failed** |        — | —                     | **Failed**       |
+
+### Lean
+
+Certified by the harness: 24,940 requests, zero failures, duplicates, or
+rejections; exact reconciliation. 178.95M stored events/day is 31% above the
+2026-08-21 result (136.65M) on the same deployment — the byte-measurement reuse
+first recertified for heavy on 2026-08-22 now shows up across the board, and the
+new per-request work (bot check, client hints, salted visitor keys) did not cost
+the hot path its headroom.
+
+### Realistic
+
+The driver's session pool was doubled to 4,096 (default 2,048) and that change
+is part of this row's workload definition. At the current deployment speed the
+2,048-session pool drives individual sessions past the documented 120
+events/session/minute ingest budget, so a prior attempt lost 2 of 20,477
+requests to `429 RATE_LIMITED` — the limiter working as documented, but not a
+clean certification. With 4,096 sessions the run completed 20,781 requests with
+**zero failures** of any kind.
+
+The harness itself did not stamp this run: after the clean 600 s window, its
+first reconciliation query lost a fetch to the local resolver
+(`reconciliation:fetch failed`) and gave up. Reconciliation was re-run
+immediately afterwards with the same `benchmark:reconcileSessionsPage` pages the
+harness uses, with per-page retries:
+
+```json
+{
+  "runId": "3c81abe6-60cd-4b40-828f-cedf03fedd39",
+  "requested": 4096,
+  "found": 4096,
+  "stored": 988995,
+  "expectedStored": 988995
+}
+```
+
+988,995 expected stored events (1,039,050 accepted − 50,055 heartbeats), 988,995
+found — exact. 988,995 stored over the 601.6 s window is 1,644 stored/s, 142.04M
+stored events/day, 17.6% above the 2026-08-21 result (120.81M).
+
+### Heavy
+
+Certified by the harness: 19,402 requests, zero failures, exact reconciliation,
+1,990,190 request bytes/second under the 64 KiB body limit. 55.26M stored
+events/day is 28% below the 2026-08-22 fresh-store recertification (76.62M). The
+payload and validation are unchanged; the store was not. This run followed hours
+of sustained battery load on a canary holding millions of freshly written rows,
+where 2026-08-22 hit a much lighter store. Both numbers stand side by side:
+76.62M remains the fresh-store ceiling, 55.26M is the same workload on a loaded
+store. Neither is overwritten by the other without a matched-state rerun.
+
+### Feature — certification FAILED (reproducible defect)
+
+The feature profile (goals, funnels, and affiliate attribution all matching)
+cannot currently be certified: a steady ~4–5% of requests fail with
+`500 INTERNAL_ERROR` at every concurrency tried (100, 15, and 5), and each
+failed request loses its whole batch — reconciliation of a 60 s smoke found only
+946 of 997 run sessions, so this is data loss under load. Backend logs show OCC
+retry exhaustion on the affiliate daily rollups, always on the same two
+documents — the two `REPORT_ROLLUP_SHARDS` rows for the demo affiliate's day:
+
+```text
+[CONVEX M(ingest:ingestBatch)] Documents read from or written to the
+"affiliateDailyRollups" table changed while this mutation was being run and on
+every subsequent retry. Another call to this mutation changed the document
+with ID "mh735zse9410dt27ftc8t3tv4s8deazf".
+```
+
+The defect postdates alpha.3 (the 2026-08-21 feature run predates the
+generation-1 daily rollups and passed clean at 384 stored/s) and predates the
+Web Vitals change, whose fold path is separate. It is tracked as
+[issue #52](https://github.com/amageweb/amage-rastro/issues/52); the fix needs
+wider rollup sharding, rebalanced feature-report read budgets, and a
+rollout-generation bump. Until it lands, no feature-profile capacity is claimed
+at all — the 2026-08-21 33.22M row is historical evidence for alpha.3 only.
+
+## Certified run JSON
+
+### Lean (`cert-lean-alpha5`, run `862673e3-ff44-492e-a078-5d8c33f70101`)
+
+```json
+{
+  "requests": { "started": 24940, "completed": 24940, "failures": 0 },
+  "events": {
+    "sent": 1247000,
+    "heartbeats": 0,
+    "accepted": 1247000,
+    "stored": 1247000,
+    "duplicates": 0,
+    "rejected": 0,
+    "failed": 0
+  },
+  "throughput": {
+    "storedEventsPerSecond": 2071,
+    "certifiedStoredEventsPerDay": 178948552,
+    "requestBytesPerSecond": 575501
+  },
+  "latencyMs": { "p50": 2156, "p95": 4167, "p99": 5925, "max": 7189 },
+  "reconciliation": {
+    "expectedStoredEvents": 1247000,
+    "storedEvents": 1247000,
+    "matches": true
+  }
+}
+```
+
+### Heavy (`cert-heavy-alpha5-r2`)
+
+```json
+{
+  "requests": { "started": 19402, "completed": 19402, "failures": 0 },
+  "events": {
+    "sent": 388040,
+    "accepted": 388040,
+    "stored": 388040,
+    "duplicates": 0,
+    "rejected": 0,
+    "failed": 0
+  },
+  "throughput": {
+    "storedEventsPerSecond": 640,
+    "certifiedStoredEventsPerDay": 55259642,
+    "requestBytesPerSecond": 1990190
+  },
+  "latencyMs": { "p50": 2545, "p95": 7702, "p99": 10325, "max": 11220 },
+  "reconciliation": {
+    "expectedStoredEvents": 388040,
+    "storedEvents": 388040,
+    "matches": true
+  }
+}
+```
+
+### Realistic (`cert-realistic-alpha5-r3-a1`, run `3c81abe6-60cd-4b40-828f-cedf03fedd39`)
+
+```json
+{
+  "requests": { "started": 20781, "completed": 20781, "failures": 0 },
+  "events": {
+    "sent": 1039050,
+    "heartbeats": 50055,
+    "accepted": 1039050,
+    "duplicates": 0,
+    "rejected": 0,
+    "failed": 0
+  },
+  "throughput": {
+    "eventsPerSecond": 1727,
+    "requestBytesPerSecond": 523501
+  },
+  "latencyMs": { "p50": 1790, "p95": 4953, "p99": 7096, "max": 9274 },
+  "reconciliation": "lost to a client-side DNS failure; re-run exactly, see above"
+}
+```
+
+## What still lacks certification
+
+GeoIP with a provider enabled, trusted server-side conversions, vitals-bearing
+traffic (the `vital` ingest branch ran idle here), and the feature profile until
+issue #52 is fixed.

package/docs/federation.md

@@ -239,7 +239,7 @@ either overview dataset.
 ## Control-plane status
 
 The production control plane at `https://www.amagerastro.com` and its reference
-implementation under `example/` provide Better Auth sessions,
+implementation under `control-plane/` provide Better Auth sessions,
 organization-scoped connections, OIDC discovery, JWKS, ten-minute RS256 tokens,
 manifest verification, redacted site discovery, audit records, revocation of new
 token issuance, and dynamic browser subscriptions to active deployments.

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@iann29/rastro",
-  "description": "Privacy-first, real-time web analytics for Convex: live visitor atlas, journeys, revenue, goals, funnels, affiliates, and a sub-1KB tracker.",
+  "description": "Privacy-first, real-time web analytics for Convex: live visitor atlas, journeys, revenue, goals, funnels, affiliates, and a 1.1 KB tracker.",
   "repository": "github:amageweb/amage-rastro",
   "homepage": "https://github.com/amageweb/amage-rastro#readme",
   "bugs": {
     "url": "https://github.com/amageweb/amage-rastro/issues"
   },
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
@@ -27,9 +27,9 @@
   "jsdelivr": "./dist/tracker.min.js",
   "scripts": {
     "dev": "synapse dev --start 'npm run dev:build'",
-    "dev:frontend": "cd example && vite",
+    "dev:frontend": "cd control-plane && vite",
     "dev:build": "chokidar 'tsconfig*.json' 'src/**/*.{ts,js}' 'scripts/build-tracker.mjs' -i '**/*.test.ts' -c 'npm run build:codegen' --initial",
-    "deploy:dashboard": "static-hosting upload --build --dist example/dist --build-command \"npm exec vite -- build example\"",
+    "deploy:dashboard": "static-hosting upload --build --dist control-plane/dist --build-command \"npm exec vite -- build control-plane\"",
     "predev": "npm run build:codegen",
     "prebuild": "rm -rf dist *.tsbuildinfo",
     "build": "npm run build:tracker && tsc --project ./tsconfig.build.json",
@@ -37,17 +37,21 @@
     "federation:keys": "node ./scripts/generate-federation-keys.mjs",
     "benchmark:ingest": "node ./scripts/benchmark-ingest.mjs",
     "benchmark:local": "vitest run src/component/benchmark.test.ts",
+    "format:check": "prettier --check .",
     "verify:agent-docs": "node ./scripts/verify-agent-docs.mjs",
-    "build:codegen": "npm run build && synapse convex codegen --component-dir ./src/component && npm run build && synapse dev --once",
+    "verify:skill-paths": "node ./scripts/verify-skill-paths.mjs",
+    "build:codegen": "npm run build && synapse convex codegen --component-dir ./src/component && npm run build && npm run codegen:example && synapse dev --once",
+    "codegen:example": "npm run --workspace example codegen",
     "build:clean": "npm run build:codegen",
-    "typecheck": "tsc --noEmit && tsc -p example && tsc -p example/convex",
+    "typecheck": "tsc --noEmit && tsc -p control-plane && tsc -p control-plane/convex && tsc -p example/convex",
     "lint": "eslint .",
     "test": "vitest run --typecheck",
     "test:watch": "vitest --typecheck --clearScreen false",
     "test:debug": "vitest --inspect-brk --no-file-parallelism",
     "test:coverage": "vitest run --coverage --coverage.reporter=text",
+    "e2e": "playwright test -c control-plane/playwright.config.ts",
     "prepare": "npm run build",
-    "preversion": "npm run build && npm exec vite -- build example && npm run test && npm run lint && npm run typecheck && npm run benchmark:local && npm run verify:agent-docs"
+    "preversion": "npm run build && VITE_CONVEX_URL=https://preflight.example.convex.cloud VITE_CONVEX_SITE_URL=https://preflight.example.convex.site npm exec vite -- build control-plane && npm run test && npm run format:check && npm run lint && npm run typecheck && npm run benchmark:local && npm run verify:agent-docs && npm run verify:skill-paths"
   },
   "files": [
     "dist",
@@ -77,6 +81,7 @@
       "default": "./dist/react/index.js"
     },
     "./tracker.js": "./dist/tracker.min.js",
+    "./vitals.js": "./dist/vitals.min.js",
     "./test": "./src/test.ts",
     "./_generated/component.js": {
       "types": "./dist/component/_generated/component.d.ts"
@@ -105,12 +110,19 @@
   "devDependencies": {
     "@convex-dev/eslint-plugin": "^4.0.0",
     "@convex-dev/static-hosting": "^0.2.1",
+    "@dicebear/core": "^9.4.3",
+    "@dicebear/lorelei": "^9.4.2",
     "@edge-runtime/vm": "^5.0.0",
     "@eslint/eslintrc": "^3.3.6",
     "@eslint/js": "9.39.5",
     "@fontsource-variable/instrument-sans": "^5.3.0",
     "@fontsource/ibm-plex-mono": "^5.3.0",
+    "@playwright/test": "^1.62.1",
     "@tailwindcss/vite": "^4.3.3",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.3",
+    "@testing-library/user-event": "^14.6.6",
     "@types/node": "^24.13.3",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
@@ -128,6 +140,7 @@
     "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-react-refresh": "^0.5.3",
     "globals": "^17.9.0",
+    "jsdom": "^30.0.1",
     "lucide-react": "^1.32.0",
     "maplibre-gl": "^6.4.1",
     "pkg-pr-new": "^0.0.86",
@@ -148,6 +161,11 @@
   "dependencies": {
     "@convex-dev/better-auth": "^0.12.5",
     "better-auth": "~1.6.15",
-    "jose": "^6.2.10"
-  }
+    "country-flag-icons": "^1.6.20",
+    "jose": "^6.2.10",
+    "simple-icons": "^16.29.0"
+  },
+  "workspaces": [
+    "example"
+  ]
 }

package/scripts/benchmark-ingest.mjs

@@ -67,16 +67,19 @@ function parseOptions(argv) {
   const values = new Map();
   for (let index = 0; index < argv.length; index += 1) {
     const argument = argv[index];
-    if (!argument.startsWith("--")) throw new Error(`unexpected argument: ${argument}`);
+    if (!argument.startsWith("--"))
+      throw new Error(`unexpected argument: ${argument}`);
     const [rawName, inlineValue] = argument.slice(2).split("=", 2);
-    if (!OPTION_NAMES.has(rawName)) throw new Error(`unknown option: --${rawName}`);
+    if (!OPTION_NAMES.has(rawName))
+      throw new Error(`unknown option: --${rawName}`);
     if (values.has(rawName)) throw new Error(`duplicate option: --${rawName}`);
     if (rawName === "dry-run" || rawName === "certify") {
       values.set(rawName, "true");
       continue;
     }
     const value = inlineValue ?? argv[++index];
-    if (!value || value.startsWith("--")) throw new Error(`missing value for --${rawName}`);
+    if (!value || value.startsWith("--"))
+      throw new Error(`missing value for --${rawName}`);
     values.set(rawName, value);
   }
   const profile = values.get("profile") ?? "realistic";
@@ -95,7 +98,10 @@ function parseOptions(argv) {
     maximumRequests: values.has("requests")
       ? positiveInteger(values.get("requests"), "requests")
       : Number.POSITIVE_INFINITY,
-    concurrency: positiveInteger(values.get("concurrency") ?? "100", "concurrency"),
+    concurrency: positiveInteger(
+      values.get("concurrency") ?? "100",
+      "concurrency",
+    ),
     batchSize: positiveInteger(
       values.get("batch-size") ?? String(defaults.batchSize),
       "batch-size",
@@ -112,20 +118,23 @@ function parseOptions(argv) {
 
 function positiveNumber(value, name) {
   const parsed = Number(value);
-  if (!Number.isFinite(parsed) || parsed <= 0) throw new Error(`--${name} must be positive`);
+  if (!Number.isFinite(parsed) || parsed <= 0)
+    throw new Error(`--${name} must be positive`);
   return parsed;
 }
 
 function positiveInteger(value, name) {
   const parsed = positiveNumber(value, name);
-  if (!Number.isSafeInteger(parsed)) throw new Error(`--${name} must be an integer`);
+  if (!Number.isSafeInteger(parsed))
+    throw new Error(`--${name} must be an integer`);
   return parsed;
 }
 
 function eventFor(profile, session, sequence, timestamp) {
-  const path = profile === "lean"
-    ? `/benchmark/lean/${sequence % 4}`
-    : REALISTIC_PATHS[sequence % REALISTIC_PATHS.length];
+  const path =
+    profile === "lean"
+      ? `/benchmark/lean/${sequence % 4}`
+      : REALISTIC_PATHS[sequence % REALISTIC_PATHS.length];
   const base = {
     eventId: `${session.id}.${sequence.toString(36)}`,
     sessionId: session.id,
@@ -151,10 +160,20 @@ function eventFor(profile, session, sequence, timestamp) {
   if (profile === "feature") {
     const step = sequence % 3;
     if (step === 0) {
-      return { ...base, type: "pageview", path: "/", affiliateSlug: "creator-club" };
+      return {
+        ...base,
+        type: "pageview",
+        path: "/",
+        affiliateSlug: "creator-club",
+      };
     }
     if (step === 1) {
-      return { ...base, type: "pageview", path: "/pricing", affiliateSlug: "creator-club" };
+      return {
+        ...base,
+        type: "pageview",
+        path: "/pricing",
+        affiliateSlug: "creator-club",
+      };
     }
     return {
       ...base,
@@ -172,7 +191,10 @@ function eventFor(profile, session, sequence, timestamp) {
     return {
       ...base,
       type: "pageview",
-      referrer: sequence % 2 === 0 ? "https://www.google.com/search?q=rastro" : undefined,
+      referrer:
+        sequence % 2 === 0
+          ? "https://www.google.com/search?q=rastro"
+          : undefined,
     };
   }
   if (kind < 13) return { ...base, type: "click", target: "Get started" };
@@ -184,7 +206,11 @@ function eventFor(profile, session, sequence, timestamp) {
       properties: { placement: "hero", experiment: `variant-${sequence % 3}` },
     };
   }
-  return { ...base, type: "outbound", href: "https://github.com/amageweb/amage-rastro" };
+  return {
+    ...base,
+    type: "outbound",
+    href: "https://github.com/amageweb/amage-rastro",
+  };
 }
 
 function requestContext(session) {
@@ -200,15 +226,19 @@ function requestContext(session) {
 
 function percentile(sorted, fraction) {
   if (sorted.length === 0) return 0;
-  return sorted[Math.min(sorted.length - 1, Math.ceil(sorted.length * fraction) - 1)];
+  return sorted[
+    Math.min(sorted.length - 1, Math.ceil(sorted.length * fraction) - 1)
+  ];
 }
 
 function hasValidSessionTotals(value) {
-  return value !== null &&
+  return (
+    value !== null &&
     typeof value === "object" &&
     [value.requestedSessions, value.foundSessions, value.storedEvents].every(
       (total) => Number.isSafeInteger(total) && total >= 0,
-    );
+    )
+  );
 }
 
 async function main() {
@@ -249,15 +279,16 @@ async function main() {
   const durations = [];
 
   const buildRequest = (requestIndex) => {
-    const session = options.profile === "lean"
-      ? {
-          id: `bench-${runId}-${requestIndex}`,
-          visitorId: `visitor-${runId}-${requestIndex}`,
-          sequence: 0,
-          locationIndex: requestIndex % LOCATIONS.length,
-          userAgentIndex: requestIndex % USER_AGENTS.length,
-        }
-      : sessions[requestIndex % sessions.length];
+    const session =
+      options.profile === "lean"
+        ? {
+            id: `bench-${runId}-${requestIndex}`,
+            visitorId: `visitor-${runId}-${requestIndex}`,
+            sequence: 0,
+            locationIndex: requestIndex % LOCATIONS.length,
+            userAgentIndex: requestIndex % USER_AGENTS.length,
+          }
+        : sessions[requestIndex % sessions.length];
     const sequenceStart = session.sequence;
     session.sequence += options.batchSize;
     const now = Date.now();
@@ -276,18 +307,26 @@ async function main() {
     throw new Error("generated request exceeds the 64 KiB HTTP limit");
   }
   if (options.dryRun) {
-    process.stdout.write(`${JSON.stringify({
-      profile: options.profile,
-      batchSize: options.batchSize,
-      requestBytes: Buffer.byteLength(dryRequest.body),
-      heartbeats: dryRequest.heartbeats,
-      location: requestContext(sessions[0]),
-    }, null, 2)}\n`);
+    process.stdout.write(
+      `${JSON.stringify(
+        {
+          profile: options.profile,
+          batchSize: options.batchSize,
+          requestBytes: Buffer.byteLength(dryRequest.body),
+          heartbeats: dryRequest.heartbeats,
+          location: requestContext(sessions[0]),
+        },
+        null,
+        2,
+      )}\n`,
+    );
     return;
   }
   if (options.profile !== "lean") sessions[0].sequence = 0;
   if (!options.url || !options.siteId) {
-    throw new Error("--url and --site-id are required unless --dry-run is used");
+    throw new Error(
+      "--url and --site-id are required unless --dry-run is used",
+    );
   }
 
   const stopForSignal = (signal) => {
@@ -299,7 +338,9 @@ async function main() {
   process.once("SIGINT", stopForInterrupt);
   process.once("SIGTERM", stopForTermination);
 
-  const convex = options.convexUrl ? new ConvexHttpClient(options.convexUrl) : null;
+  const convex = options.convexUrl
+    ? new ConvexHttpClient(options.convexUrl)
+    : null;
   if (convex) {
     const preflight = await convex.query(reconcileSessionsQuery, {
       siteId: options.siteId,
@@ -333,7 +374,9 @@ async function main() {
       const request = buildRequest(requestIndex);
       const requestBytes = Buffer.byteLength(request.body);
       if (requestBytes > 64 * 1024) {
-        throw new Error(`generated request ${requestIndex} exceeds the 64 KiB HTTP limit`);
+        throw new Error(
+          `generated request ${requestIndex} exceeds the 64 KiB HTTP limit`,
+        );
       }
       sentBytes += requestBytes;
       sentEvents += options.batchSize;
@@ -368,7 +411,8 @@ async function main() {
             ![result.accepted, result.duplicates, result.rejected].every(
               (value) => Number.isSafeInteger(value) && value >= 0,
             ) ||
-            result.accepted + result.duplicates + result.rejected !== options.batchSize
+            result.accepted + result.duplicates + result.rejected !==
+              options.batchSize
           ) {
             throw new Error("response has invalid event accounting");
           }
@@ -384,7 +428,9 @@ async function main() {
       } catch (error) {
         failures += 1;
         failedEvents += options.batchSize;
-        recordError(`fetch:${error instanceof Error ? error.message : "unknown"}`);
+        recordError(
+          `fetch:${error instanceof Error ? error.message : "unknown"}`,
+        );
       } finally {
         durations.push(performance.now() - requestStartedAt);
         completedRequests += 1;
@@ -393,11 +439,14 @@ async function main() {
   };
 
   const progress = setInterval(() => {
-    const elapsedSeconds = Math.max(0.001, (performance.now() - startedAt) / 1_000);
+    const elapsedSeconds = Math.max(
+      0.001,
+      (performance.now() - startedAt) / 1_000,
+    );
     process.stderr.write(
       `[${options.label}] ${Math.round(elapsedSeconds)}s ` +
-      `${accepted} accepted ${Math.round(accepted / elapsedSeconds)} events/s ` +
-      `${failures} failures\n`,
+        `${accepted} accepted ${Math.round(accepted / elapsedSeconds)} events/s ` +
+        `${failures} failures\n`,
     );
   }, options.progressSeconds * 1_000);
   progress.unref();
@@ -405,14 +454,16 @@ async function main() {
   clearInterval(progress);
 
   const elapsedMs = performance.now() - startedAt;
-  terminationReason ??= performance.now() >= deadline ? "duration" : "completed";
+  terminationReason ??=
+    performance.now() >= deadline ? "duration" : "completed";
   process.removeListener("SIGINT", stopForInterrupt);
   process.removeListener("SIGTERM", stopForTermination);
   const durationCompleted = terminationReason === "duration";
   durations.sort((left, right) => left - right);
-  const expectedSessions = options.profile === "lean"
-    ? nextRequest
-    : Math.min(nextRequest, options.sessionCount);
+  const expectedSessions =
+    options.profile === "lean"
+      ? nextRequest
+      : Math.min(nextRequest, options.sessionCount);
   let sessionTotals = null;
   if (convex && expectedSessions > 0) {
     try {
@@ -490,7 +541,8 @@ async function main() {
     },
     concurrency: options.concurrency,
     batchSize: options.batchSize,
-    sessionPool: options.profile === "lean" ? "unique-per-request" : options.sessionCount,
+    sessionPool:
+      options.profile === "lean" ? "unique-per-request" : options.sessionCount,
     maximumRequests: Number.isFinite(options.maximumRequests)
       ? options.maximumRequests
       : null,
@@ -513,9 +565,10 @@ async function main() {
       estimatedEventsPerDay: durationCompleted
         ? Math.round((accepted * 86_400_000) / elapsedMs)
         : null,
-      estimatedStoredEventsPerDay: durationCompleted && reconciliationPassed
-        ? Math.round((storedEvents * 86_400_000) / elapsedMs)
-        : null,
+      estimatedStoredEventsPerDay:
+        durationCompleted && reconciliationPassed
+          ? Math.round((storedEvents * 86_400_000) / elapsedMs)
+          : null,
       certifiedEventsPerDay: certificationPassed
         ? Math.round((accepted * 86_400_000) / elapsedMs)
         : null,

package/src/component/_generated/api.ts

@@ -20,13 +20,17 @@ import type * as geo from "../geo.js";
 import type * as goals from "../goals.js";
 import type * as guards from "../guards.js";
 import type * as http from "../http.js";
+import type * as identity from "../identity.js";
 import type * as ingest from "../ingest.js";
 import type * as live from "../live.js";
 import type * as reports from "../reports.js";
 import type * as retention from "../retention.js";
 import type * as sanitize from "../sanitize.js";
 import type * as sites from "../sites.js";
+import type * as useragent from "../useragent.js";
 import type * as validators from "../validators.js";
+import type * as visitors from "../visitors.js";
+import type * as vitals from "../vitals.js";
 
 import type {
   ApiFromModules,
@@ -48,13 +52,17 @@ const fullApi: ApiFromModules<{
   goals: typeof goals;
   guards: typeof guards;
   http: typeof http;
+  identity: typeof identity;
   ingest: typeof ingest;
   live: typeof live;
   reports: typeof reports;
   retention: typeof retention;
   sanitize: typeof sanitize;
   sites: typeof sites;
+  useragent: typeof useragent;
   validators: typeof validators;
+  visitors: typeof visitors;
+  vitals: typeof vitals;
 }> = anyApi as any;
 
 /**