@derwinjs/db 0.10.0 → 0.12.0

package/dist/rum-sample-store.js

@@ -0,0 +1,155 @@
+/**
+ * createPrismaRumSampleStore — Prisma-backed implementation of the SDK
+ * RumSampleStore contract introduced by QAP-113.
+ *
+ * Sprint 11 Phase 3 (Test Surfaces — RUM ingestion). Samples are stored as
+ * one row per insert against the `RumSample` model. There is no uniqueness
+ * constraint on (projectId, metric) — a single page-load may emit multiple
+ * samples per metric, and operators need the full distribution to derive
+ * percentiles.
+ *
+ * Tenant isolation: every method scopes by projectId. Pattern D applies —
+ * unknown / wrong-project lookups return null from `getBaseline` rather
+ * than throwing or leaking existence (defense-in-depth against tenant
+ * enumeration). The "no samples in window" return is also null, so
+ * cross-tenant probes look identical to "no data this window".
+ *
+ * Percentile math: derived in-memory via array-index math after the
+ * `findMany` returns a value-sorted result set. No third-party stats
+ * library — RumSample row sets per (projectId, metric, window) cap at the
+ * tens-of-thousands order of magnitude, which fits comfortably in process
+ * memory for the percentile read.
+ */
+// ─── Error class ─────────────────────────────────────────────────────────
+/**
+ * Errors thrown by the Prisma-backed RumSampleStore. The store-level
+ * errors are kept inside @derwinjs/db (NOT promoted to @derwinjs/sdk)
+ * because they reflect storage-layer specifics; the route layer maps
+ * them to the operator-facing WebVitalsIngestorError before crossing
+ * the SDK boundary.
+ *
+ * The discriminating `code` field lets callers route handling:
+ *   - `invalid_input` — caller bug rejected at the factory boundary; do
+ *                       not retry.
+ *   - `io_failed`     — underlying Prisma call raised; transient — retry
+ *                       or escalate.
+ */
+export class RumSampleStoreError extends Error {
+    code;
+    cause;
+    constructor(code, message, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = 'RumSampleStoreError';
+        Object.setPrototypeOf(this, RumSampleStoreError.prototype);
+    }
+}
+// ─── Validation ──────────────────────────────────────────────────────────
+function assertNonEmpty(value, fieldName) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new RumSampleStoreError('invalid_input', `createPrismaRumSampleStore: ${fieldName} is required and non-empty`);
+    }
+}
+function assertFiniteNumber(value, fieldName) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new RumSampleStoreError('invalid_input', `createPrismaRumSampleStore: ${fieldName} must be a finite number`);
+    }
+}
+function assertNonNegativeMs(value, fieldName) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value < 0) {
+        throw new RumSampleStoreError('invalid_input', `createPrismaRumSampleStore: ${fieldName} must be a non-negative finite number`);
+    }
+}
+// ─── Percentile helper ──────────────────────────────────────────────────
+/**
+ * Nearest-rank percentile over a value-sorted ascending array. Mirrors the
+ * convention web-vitals.js + most RUM analytics tools use:
+ *
+ *   index = ceil((p / 100) * N) - 1, clamped to [0, N-1].
+ *
+ * For a single-element array all percentiles return that element. For
+ * pre-sorted ascending arrays this is the cheapest correct percentile; the
+ * caller is responsible for sorting before passing the array in.
+ */
+function percentile(sortedAsc, p) {
+    const n = sortedAsc.length;
+    if (n === 0) {
+        throw new RumSampleStoreError('invalid_input', 'createPrismaRumSampleStore: percentile() called on empty array (caller bug)');
+    }
+    const idx = Math.max(0, Math.min(n - 1, Math.ceil((p / 100) * n) - 1));
+    // idx is in [0, n-1] and n >= 1, so the slot is always set. Runtime-guard
+    // form (memory rule 13) instead of `!` or `as number` — both are banned by
+    // @typescript-eslint/no-non-null-assertion + non-nullable-type-assertion-style.
+    const value = sortedAsc[idx];
+    if (value === undefined) {
+        throw new RumSampleStoreError('invalid_input', `createPrismaRumSampleStore: percentile() unreachable branch — idx=${String(idx)} of ${String(n)}`);
+    }
+    return value;
+}
+// ─── Factory ─────────────────────────────────────────────────────────────
+export function createPrismaRumSampleStore(config) {
+    const { prisma } = config;
+    return {
+        async insert(input) {
+            assertNonEmpty(input.projectId, 'projectId');
+            assertNonEmpty(input.metric, 'metric');
+            assertFiniteNumber(input.value, 'value');
+            assertNonEmpty(input.rating, 'rating');
+            assertNonEmpty(input.url, 'url');
+            try {
+                const row = await prisma.rumSample.create({
+                    data: {
+                        projectId: input.projectId,
+                        metric: input.metric,
+                        value: input.value,
+                        rating: input.rating,
+                        url: input.url,
+                        deviceType: input.deviceType ?? null,
+                        sessionId: input.sessionId ?? null,
+                    },
+                    select: { id: true },
+                });
+                return { id: row.id };
+            }
+            catch (err) {
+                throw new RumSampleStoreError('io_failed', `createPrismaRumSampleStore: insert raised: ${err.message}`, err);
+            }
+        },
+        async getBaseline(input) {
+            assertNonEmpty(input.projectId, 'projectId');
+            assertNonEmpty(input.metric, 'metric');
+            assertNonNegativeMs(input.sinceMs, 'sinceMs');
+            const windowEnd = new Date();
+            const windowStart = new Date(windowEnd.getTime() - input.sinceMs);
+            let rows;
+            try {
+                rows = await prisma.rumSample.findMany({
+                    where: {
+                        projectId: input.projectId,
+                        metric: input.metric,
+                        capturedAt: { gte: windowStart },
+                    },
+                    orderBy: { value: 'asc' },
+                    select: { value: true },
+                });
+            }
+            catch (err) {
+                throw new RumSampleStoreError('io_failed', `createPrismaRumSampleStore: getBaseline raised: ${err.message}`, err);
+            }
+            if (rows.length === 0)
+                return null;
+            const values = rows.map((r) => r.value);
+            return {
+                metric: input.metric,
+                p50: percentile(values, 50),
+                p75: percentile(values, 75),
+                p95: percentile(values, 95),
+                sampleCount: values.length,
+                windowStart,
+                windowEnd,
+            };
+        },
+    };
+}
+//# sourceMappingURL=rum-sample-store.js.map

package/dist/rum-sample-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rum-sample-store.js","sourceRoot":"","sources":["../src/rum-sample-store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@derwinjs/db",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Prisma schema + migrations for Derwin's own Postgres. 14 models, project-namespaced. Per ADR-0005. Ships its own generated Prisma client (multi-platform binaries) for cross-consumer compatibility.",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
@@ -33,8 +33,8 @@
   },
   "dependencies": {
     "@prisma/client": "^5.22.0",
-    "@derwinjs/sdk": "0.10.0",
-    "@derwinjs/core": "0.10.0"
+    "@derwinjs/core": "0.12.0",
+    "@derwinjs/sdk": "0.12.0"
   },
   "devDependencies": {
     "@vitest/coverage-v8": "^2.1.9",

package/prisma/migrations/20260508000100_sprint11_phase3_rum_samples/migration.sql

@@ -0,0 +1,31 @@
+-- Sprint 11 Phase 3 (QAP-113) — RUM / Web Vitals samples.
+--
+-- Stores consumer-pushed Real User Monitoring (RUM) samples emitted by the
+-- consumer app's web-vitals hooks. One row per (projectId, metric, capturedAt)
+-- — there is no uniqueness constraint because the same metric + URL may fire
+-- many times per session. Baseline statistics (p50/p75/p95) are derived on
+-- demand from this row set rather than maintained as a rolling aggregate.
+--
+-- Idempotent (IF NOT EXISTS) — safe to re-run on environments where the
+-- table or index already exists.
+
+CREATE TABLE IF NOT EXISTS "derwin"."rum_samples" (
+    "id" TEXT NOT NULL,
+    "projectId" TEXT NOT NULL,
+    "metric" TEXT NOT NULL,
+    "value" DOUBLE PRECISION NOT NULL,
+    "rating" TEXT NOT NULL,
+    "url" TEXT NOT NULL,
+    "deviceType" TEXT,
+    "sessionId" TEXT,
+    "capturedAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    CONSTRAINT "rum_samples_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX IF NOT EXISTS "rum_samples_projectId_metric_capturedAt_idx"
+    ON "derwin"."rum_samples"("projectId", "metric", "capturedAt" DESC);
+
+ALTER TABLE "derwin"."rum_samples"
+    ADD CONSTRAINT "rum_samples_projectId_fkey"
+    FOREIGN KEY ("projectId") REFERENCES "derwin"."projects"("id")
+    ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/migrations/20260508000200_sprint11_phase5_milestone_events/migration.sql

@@ -0,0 +1,42 @@
+-- Sprint 11 Phase 5 (QAP-115) — MilestoneEvent foundation.
+--
+-- Cross-product tracking timeline data source. Backs the Tracking Timeline
+-- Gantt UI (Phase 6) plus future cross-product coherence features (e.g.,
+-- conflict alerts when a release lands inside another project's freeze
+-- window). The spec's `tenantId?` field is intentionally omitted in v1 —
+-- per the Derwin multi-tenant boundary rule (each consumer = ONE Project
+-- row), milestones are project-scoped only; if a downstream consumer ever
+-- needs intra-project tenant slicing it can be added as an optional column
+-- in a future migration without breaking the existing queries.
+--
+-- `kind` is held as a String column rather than a Prisma enum so consumers
+-- can emit custom kinds (alongside the canonical
+-- release / freeze / demo / launch) without requiring a migration. The
+-- conflict-detection helpers in `@derwinjs/core` validate the value at
+-- runtime where it matters.
+--
+-- Two indexes:
+--   - (projectId, startsAt ASC) supports the per-project chronological
+--     listing the Phase 6 Gantt issues on every read.
+--   - (projectId, kind) supports the swimlane-by-kind grouping the Gantt
+--     uses to lay out releases / freezes / demos / launches.
+
+CREATE TABLE "derwin"."milestone_events" (
+    "id" TEXT NOT NULL,
+    "projectId" TEXT NOT NULL,
+    "name" TEXT NOT NULL,
+    "description" TEXT,
+    "startsAt" TIMESTAMP(3) NOT NULL,
+    "endsAt" TIMESTAMP(3),
+    "kind" TEXT NOT NULL,
+    "createdBy" TEXT NOT NULL,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updatedAt" TIMESTAMP(3) NOT NULL,
+    CONSTRAINT "milestone_events_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "milestone_events_projectId_startsAt_idx" ON "derwin"."milestone_events"("projectId", "startsAt" ASC);
+
+CREATE INDEX "milestone_events_projectId_kind_idx" ON "derwin"."milestone_events"("projectId", "kind");
+
+ALTER TABLE "derwin"."milestone_events" ADD CONSTRAINT "milestone_events_projectId_fkey" FOREIGN KEY ("projectId") REFERENCES "derwin"."projects"("id") ON DELETE CASCADE ON UPDATE CASCADE;

package/prisma/schema.prisma

@@ -151,6 +151,8 @@ model Project {
   visualBaselines         VisualBaseline[]
   contractBaselines       ContractBaseline[]
   tenantFuzzConfig        TenantFuzzConfig?
+  rumSamples              RumSample[]
+  milestoneEvents         MilestoneEvent[]
 
   @@map("projects")
   @@schema("derwin")
@@ -1089,3 +1091,83 @@ model TenantFuzzConfig {
   @@map("tenant_fuzz_configs")
   @@schema("derwin")
 }
+
+// ═══════════════════════════════════════════════════════════════════════════
+// QAP-113 (Sprint 11 Phase 3) — RUM / Web Vitals samples
+// ═══════════════════════════════════════════════════════════════════════════
+//
+// Stores consumer-pushed Real User Monitoring (RUM) samples emitted by the
+// consumer app's web-vitals hooks. Unlike Sprint 10/11 scanner surfaces this
+// is INGESTION — the data is pushed from client devices, not produced by a
+// Derwin-spawned scanner. One row per individual sample; baseline statistics
+// (p50/p75/p95) are derived on demand from this row set rather than
+// maintained as a rolling aggregate.
+//
+// The Prisma-backed implementation lives at
+// packages/db/src/rum-sample-store.ts; the SDK contract is in
+// @derwinjs/sdk (RumSampleStore in
+// packages/sdk/src/types/rum-sample-store.ts) and the ingest contract
+// (WebVitalsIngestor) in packages/sdk/src/types/web-vitals-ingestor.ts.
+//
+// `metric` and `rating` are held as String columns rather than Prisma enums
+// so consumers can emit custom metrics (alongside the canonical
+// CLS / FCP / INP / LCP / TTFB) without requiring a migration. The factory
+// validates the value at runtime where it matters.
+
+model RumSample {
+  id         String   @id @default(cuid())
+  projectId  String
+  metric     String // 'CLS' | 'FCP' | 'INP' | 'LCP' | 'TTFB' or custom
+  value      Float
+  rating     String // 'good' | 'needs-improvement' | 'poor'
+  url        String
+  deviceType String?
+  sessionId  String?
+  capturedAt DateTime @default(now())
+
+  project Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
+
+  @@index([projectId, metric, capturedAt(sort: Desc)])
+  @@map("rum_samples")
+  @@schema("derwin")
+}
+
+// ═══════════════════════════════════════════════════════════════════════════
+// QAP-115 (Sprint 11 Phase 5) — Cross-product tracking timeline (MilestoneEvent)
+// ═══════════════════════════════════════════════════════════════════════════
+//
+// Foundation for the Tracking Timeline Gantt UI shipped in Sprint 11 Phase 6.
+// One row per scheduled or in-progress milestone; ranges (releases, freeze
+// windows) carry both `startsAt` + `endsAt`; point-in-time milestones (demos,
+// launches) carry only `startsAt`. `kind` is intentionally a free-form String
+// rather than a Prisma enum so consumers can emit custom kinds (the conflict-
+// detection helpers in @derwinjs/core treat unknown kinds as "no conflict
+// computed against this kind" rather than throwing).
+//
+// The Prisma-backed implementation lives at
+// packages/db/src/milestone-event-store.ts; the SDK contract is in
+// @derwinjs/sdk (MilestoneEventStore in
+// packages/sdk/src/types/milestone-event-store.ts).
+//
+// Indexes mirror the two read paths: chronological per project (for the
+// Gantt's primary read) and per-kind per project (for swimlane grouping).
+
+model MilestoneEvent {
+  id          String    @id @default(cuid())
+  projectId   String
+  name        String
+  description String?   @db.Text
+  startsAt    DateTime
+  endsAt      DateTime?
+  kind        String // 'release' | 'freeze' | 'demo' | 'launch' | custom
+  createdBy   String
+  createdAt   DateTime  @default(now())
+  updatedAt   DateTime  @updatedAt
+
+  project Project @relation(fields: [projectId], references: [id], onDelete: Cascade)
+
+  @@index([projectId, startsAt(sort: Asc)])
+  @@index([projectId, kind])
+  @@map("milestone_events")
+  @@schema("derwin")
+}