@derwinjs/db 0.10.0 → 0.12.0

package/dist/cost-regression-evaluator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * createPrismaCostRegressionEvaluator — Sprint 12 Phase 4 (QAP-135).
+ *
+ * PR-time gate that compares a proposed fix-attempt's projected cost against
+ * the historical median for similar fixes scoped by
+ * (projectId, classification, surface) within a trailing window. Composes with
+ * the pure helper from @derwinjs/core to compute the verdict.
+ *
+ * # No new migration
+ *
+ * Reads the existing `QAFixAttempt.costCents` field (Int?, INTEGER cents —
+ * legacy schema, same column BudgetGate aggregates over since Sprint 8
+ * Phase 3 / QAP-084). The factory divides by 100 to surface USD floats so
+ * the SDK contract surface stays in dollars; no schema migration is needed
+ * for QAP-135.
+ *
+ * # Cohort scoping
+ *
+ * The QAFixAttempt rows do NOT carry classification or surface directly —
+ * those live on the joined QATicket model. Cohort filter is therefore
+ * expressed as `where.ticket: { classification, surface }` (the relation
+ * field on QAFixAttempt is `ticket`, joined via `qaTicketId`).
+ *
+ * # Window field
+ *
+ * QAFixAttempt has `attemptedAt` (not `createdAt`); the trailing-window
+ * filter uses that column.
+ *
+ * # Tenant isolation
+ *
+ * Every read scopes by `projectId`. Cross-tenant probes naturally surface
+ * as `no_baseline_yet` (the cohort findMany returns no rows for the wrong
+ * tenant), which is indistinguishable from a real cohort with insufficient
+ * samples — Pattern D defense-in-depth.
+ */
+import type { PrismaClient } from './prisma.js';
+import { type CostRegressionEvaluator } from '@derwinjs/sdk';
+export interface PrismaCostRegressionEvaluatorConfig {
+    /** Generated Prisma client. Pass an instance per process. */
+    prisma: PrismaClient;
+    /**
+     * Optional clock injection for deterministic window-boundary tests. Tests
+     * pass a fixed Date; production callers omit (defaults to `new Date()`).
+     */
+    now?: () => Date;
+}
+export declare function createPrismaCostRegressionEvaluator(config: PrismaCostRegressionEvaluatorConfig): CostRegressionEvaluator;
+//# sourceMappingURL=cost-regression-evaluator.d.ts.map

package/dist/cost-regression-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-regression-evaluator.d.ts","sourceRoot":"","sources":["../src/cost-regression-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAEL,KAAK,uBAAuB,EAG7B,MAAM,eAAe,CAAC;AAKvB,MAAM,WAAW,mCAAmC;IAClD,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AA6DD,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,mCAAmC,GAC1C,uBAAuB,CAkDzB"}

package/dist/cost-regression-evaluator.js

@@ -0,0 +1,114 @@
+/**
+ * createPrismaCostRegressionEvaluator — Sprint 12 Phase 4 (QAP-135).
+ *
+ * PR-time gate that compares a proposed fix-attempt's projected cost against
+ * the historical median for similar fixes scoped by
+ * (projectId, classification, surface) within a trailing window. Composes with
+ * the pure helper from @derwinjs/core to compute the verdict.
+ *
+ * # No new migration
+ *
+ * Reads the existing `QAFixAttempt.costCents` field (Int?, INTEGER cents —
+ * legacy schema, same column BudgetGate aggregates over since Sprint 8
+ * Phase 3 / QAP-084). The factory divides by 100 to surface USD floats so
+ * the SDK contract surface stays in dollars; no schema migration is needed
+ * for QAP-135.
+ *
+ * # Cohort scoping
+ *
+ * The QAFixAttempt rows do NOT carry classification or surface directly —
+ * those live on the joined QATicket model. Cohort filter is therefore
+ * expressed as `where.ticket: { classification, surface }` (the relation
+ * field on QAFixAttempt is `ticket`, joined via `qaTicketId`).
+ *
+ * # Window field
+ *
+ * QAFixAttempt has `attemptedAt` (not `createdAt`); the trailing-window
+ * filter uses that column.
+ *
+ * # Tenant isolation
+ *
+ * Every read scopes by `projectId`. Cross-tenant probes naturally surface
+ * as `no_baseline_yet` (the cohort findMany returns no rows for the wrong
+ * tenant), which is indistinguishable from a real cohort with insufficient
+ * samples — Pattern D defense-in-depth.
+ */
+import { CostRegressionEvaluatorError, } from '@derwinjs/sdk';
+import { DEFAULT_WINDOW_MS, evaluateCostRegression } from '@derwinjs/core';
+// ─── Validation ──────────────────────────────────────────────────────────
+function validateInput(input) {
+    if (typeof input.projectId !== 'string' || input.projectId.length === 0) {
+        throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: projectId is required');
+    }
+    if (typeof input.classification !== 'string' || input.classification.length === 0) {
+        throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: classification is required');
+    }
+    if (typeof input.surface !== 'string' || input.surface.length === 0) {
+        throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: surface is required');
+    }
+    if (typeof input.attemptedFixCostUsd !== 'number' ||
+        !Number.isFinite(input.attemptedFixCostUsd) ||
+        input.attemptedFixCostUsd < 0) {
+        throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: attemptedFixCostUsd must be a non-negative finite number');
+    }
+    if (input.thresholdMultiplier !== undefined) {
+        if (!Number.isFinite(input.thresholdMultiplier) || input.thresholdMultiplier <= 0) {
+            throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: thresholdMultiplier must be a positive finite number');
+        }
+    }
+    if (input.minSamples !== undefined) {
+        if (!Number.isInteger(input.minSamples) || input.minSamples < 1) {
+            throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: minSamples must be a positive integer');
+        }
+    }
+    if (input.windowMs !== undefined) {
+        if (!Number.isFinite(input.windowMs) || input.windowMs <= 0) {
+            throw new CostRegressionEvaluatorError('invalid_input', 'CostRegressionEvaluator: windowMs must be a positive finite number');
+        }
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────────
+export function createPrismaCostRegressionEvaluator(config) {
+    const { prisma } = config;
+    const now = config.now ?? (() => new Date());
+    return {
+        async evaluate(input) {
+            validateInput(input);
+            const windowMs = input.windowMs ?? DEFAULT_WINDOW_MS;
+            const since = new Date(now().getTime() - windowMs);
+            let attempts;
+            try {
+                attempts = await prisma.qAFixAttempt.findMany({
+                    where: {
+                        projectId: input.projectId,
+                        attemptedAt: { gte: since },
+                        costCents: { not: null },
+                        ticket: {
+                            classification: input.classification,
+                            // SurfaceCategory enum — SDK input mirrors QATicket.surface, so
+                            // Prisma accepts it directly without a cast.
+                            surface: input.surface,
+                        },
+                    },
+                    select: { costCents: true },
+                });
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                throw new CostRegressionEvaluatorError('storage_failed', `cost-regression query failed: ${message}`, err);
+            }
+            // QAFixAttempt.costCents is INT cents (legacy schema, preserved for
+            // back-compat with the audit trail). Divide by 100 to surface USD
+            // floats so the contract surface stays in dollars. Same conversion
+            // BudgetGate applies (see packages/db/src/budget-gate.ts).
+            const costsUsd = [];
+            for (const a of attempts) {
+                if (typeof a.costCents === 'number') {
+                    costsUsd.push(a.costCents / 100);
+                }
+            }
+            return evaluateCostRegression(input, costsUsd);
+        },
+    };
+}
+//# sourceMappingURL=cost-regression-evaluator.js.map

package/dist/cost-regression-evaluator.js.map

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

package/dist/index.d.ts

@@ -36,5 +36,8 @@ export { createPrismaAutoPromotionEvaluator, DEFAULT_PROMOTION_THRESHOLDS, type
 export { createPrismaVisualBaselineStore, type PrismaVisualBaselineStoreConfig, } from './visual-baseline-store.js';
 export { createPrismaContractBaselineStore, type PrismaContractBaselineStoreConfig, } from './contract-baseline-store.js';
 export { createPrismaTenantFuzzConfigStore, type PrismaTenantFuzzConfigStoreConfig, } from './tenant-fuzz-config-store.js';
+export { createPrismaRumSampleStore, RumSampleStoreError, type PrismaRumSampleStoreConfig, } from './rum-sample-store.js';
+export { createPrismaMilestoneEventStore, type PrismaMilestoneEventStoreConfig, } from './milestone-event-store.js';
+export { createPrismaCostRegressionEvaluator, type PrismaCostRegressionEvaluatorConfig, } from './cost-regression-evaluator.js';
 export * from './prisma.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAIpD,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kCAAkC,EAClC,KAAK,kCAAkC,GACxC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,8BAA8B,EAC9B,KAAK,8BAA8B,GACpC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EACL,4BAA4B,EAC5B,SAAS,EACT,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uCAAuC,EACvC,KAAK,uCAAuC,GAC7C,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qCAAqC,EACrC,KAAK,qCAAqC,GAC3C,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iCAAiC,EACjC,SAAS,EACT,cAAc,EACd,KAAK,iCAAiC,GACvC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,4BAA4B,EAC5B,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kCAAkC,EAClC,4BAA4B,EAC5B,KAAK,kCAAkC,GACxC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,+BAA+B,CAAC;AA4BvC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,eAAO,MAAM,YAAY,EAAG,cAAuB,CAAC;AAIpD,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,EAC7B,KAAK,6BAA6B,GACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kCAAkC,EAClC,KAAK,kCAAkC,GACxC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,8BAA8B,EAC9B,KAAK,8BAA8B,GACpC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,KAAK,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChG,OAAO,EACL,4BAA4B,EAC5B,SAAS,EACT,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uCAAuC,EACvC,KAAK,uCAAuC,GAC7C,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qCAAqC,EACrC,KAAK,qCAAqC,GAC3C,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iCAAiC,EACjC,SAAS,EACT,cAAc,EACd,KAAK,iCAAiC,GACvC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,KAAK,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,4BAA4B,EAC5B,KAAK,4BAA4B,GAClC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kCAAkC,EAClC,4BAA4B,EAC5B,KAAK,kCAAkC,GACxC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iCAAiC,EACjC,KAAK,iCAAiC,GACvC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,EAC/B,KAAK,+BAA+B,GACrC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mCAAmC,EACnC,KAAK,mCAAmC,GACzC,MAAM,gCAAgC,CAAC;AA4BxC,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -37,6 +37,9 @@ export { createPrismaAutoPromotionEvaluator, DEFAULT_PROMOTION_THRESHOLDS, } fro
 export { createPrismaVisualBaselineStore, } from './visual-baseline-store.js';
 export { createPrismaContractBaselineStore, } from './contract-baseline-store.js';
 export { createPrismaTenantFuzzConfigStore, } from './tenant-fuzz-config-store.js';
+export { createPrismaRumSampleStore, RumSampleStoreError, } from './rum-sample-store.js';
+export { createPrismaMilestoneEventStore, } from './milestone-event-store.js';
+export { createPrismaCostRegressionEvaluator, } from './cost-regression-evaluator.js';
 // ─── Prisma client re-export ─────────────────────────────────────────────
 //
 // @derwinjs/db ships its OWN generated Prisma client (output: prisma-client/

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAuB,CAAC;AAEpD,4EAA4E;AAE5E,OAAO,EAAE,yBAAyB,EAAkC,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,GAE9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAA+B,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAmC,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAkC,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,GAE9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,GAElC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kCAAkC,GAEnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,GAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAkC,MAAM,qBAAqB,CAAC;AAChG,OAAO,EACL,4BAA4B,EAC5B,SAAS,GAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uCAAuC,GAExC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qCAAqC,GAEtC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iCAAiC,EACjC,SAAS,EACT,cAAc,GAEf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAA+B,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAE/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,4BAA4B,GAE7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kCAAkC,EAClC,4BAA4B,GAE7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,GAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iCAAiC,GAElC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iCAAiC,GAElC,MAAM,+BAA+B,CAAC;AAEvC,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,sEAAsE;AACtE,wEAAwE;AACxE,wEAAwE;AACxE,gDAAgD;AAChD,EAAE;AACF,+DAA+D;AAC/D,0EAA0E;AAC1E,yCAAyC;AACzC,+EAA+E;AAC/E,yCAAyC;AACzC,uEAAuE;AACvE,sEAAsE;AACtE,kEAAkE;AAClE,+BAA+B;AAC/B,EAAE;AACF,oBAAoB;AACpB,8DAA8D;AAC9D,4CAA4C;AAC5C,qEAAqE;AACrE,QAAQ;AACR,gDAAgD;AAEhD,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,cAAuB,CAAC;AAEpD,4EAA4E;AAE5E,OAAO,EAAE,yBAAyB,EAAkC,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,GAE9B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,sBAAsB,EAA+B,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAmC,MAAM,uBAAuB,CAAC;AACpG,OAAO,EAAE,yBAAyB,EAAkC,MAAM,sBAAsB,CAAC;AACjG,OAAO,EACL,6BAA6B,GAE9B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,iCAAiC,GAElC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,kCAAkC,GAEnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,GAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,8BAA8B,GAE/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAkC,MAAM,qBAAqB,CAAC;AAChG,OAAO,EACL,4BAA4B,EAC5B,SAAS,GAEV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uCAAuC,GAExC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,qCAAqC,GAEtC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iCAAiC,EACjC,SAAS,EACT,cAAc,GAEf,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAA+B,MAAM,kBAAkB,CAAC;AACvF,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,GAE/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,4BAA4B,GAE7B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,kCAAkC,EAClC,4BAA4B,GAE7B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,+BAA+B,GAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,iCAAiC,GAElC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iCAAiC,GAElC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,GAEpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,+BAA+B,GAEhC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mCAAmC,GAEpC,MAAM,gCAAgC,CAAC;AAExC,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,sEAAsE;AACtE,wEAAwE;AACxE,wEAAwE;AACxE,gDAAgD;AAChD,EAAE;AACF,+DAA+D;AAC/D,0EAA0E;AAC1E,yCAAyC;AACzC,+EAA+E;AAC/E,yCAAyC;AACzC,uEAAuE;AACvE,sEAAsE;AACtE,kEAAkE;AAClE,+BAA+B;AAC/B,EAAE;AACF,oBAAoB;AACpB,8DAA8D;AAC9D,4CAA4C;AAC5C,qEAAqE;AACrE,QAAQ;AACR,gDAAgD;AAEhD,cAAc,aAAa,CAAC"}

package/dist/milestone-event-store.d.ts

@@ -0,0 +1,35 @@
+/**
+ * createPrismaMilestoneEventStore — Prisma-backed implementation of the SDK
+ * MilestoneEventStore contract introduced by QAP-115.
+ *
+ * Sprint 11 Phase 5 (Cross-product tracking timeline). One row per
+ * milestone in the `milestone_events` table, project-scoped via FK. v1
+ * is read-mostly (CRUD); drag-to-reschedule deferred to Sprint 14.
+ *
+ * Tenant isolation: every method scopes by projectId. Pattern D applies —
+ * `update` / `delete` against a row owned by a different projectId
+ * surfaces as `not_found` rather than `tenant_mismatch` (defense-in-depth
+ * against tenant enumeration). The composite (id, projectId) unique-ish
+ * lookup on `update` / `delete` is what enforces this — Prisma's
+ * `update({ where: { id, projectId } })` raises P2025 when nothing
+ * matches, and `deleteMany({ where: { id, projectId } })` returns
+ * `count: 0`.
+ *
+ * Validation runs at the factory boundary BEFORE any Prisma call — empty
+ * `name` / `kind` / `createdBy` / `projectId` throw `invalid_input` so
+ * the error surfaces with a clear caller-bug code rather than as a
+ * Prisma constraint violation.
+ *
+ * The kind column is intentionally a free-form String (not a Prisma
+ * enum). The factory enforces non-empty + trims; consumers may emit
+ * custom kinds (the conflict-detection helpers in @derwinjs/core treat
+ * unknown kinds as "no conflict computed against this kind").
+ */
+import { type PrismaClient } from './prisma.js';
+import { type MilestoneEventStore } from '@derwinjs/sdk';
+export interface PrismaMilestoneEventStoreConfig {
+    /** Generated Prisma client. Pass an instance per process. */
+    prisma: PrismaClient;
+}
+export declare function createPrismaMilestoneEventStore(config: PrismaMilestoneEventStoreConfig): MilestoneEventStore;
+//# sourceMappingURL=milestone-event-store.d.ts.map

package/dist/milestone-event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-event-store.d.ts","sourceRoot":"","sources":["../src/milestone-event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAKL,KAAK,mBAAmB,EAEzB,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,+BAA+B;IAC9C,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC;CACtB;AA6ED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,+BAA+B,GACtC,mBAAmB,CAqJrB"}

package/dist/milestone-event-store.js

@@ -0,0 +1,221 @@
+/**
+ * createPrismaMilestoneEventStore — Prisma-backed implementation of the SDK
+ * MilestoneEventStore contract introduced by QAP-115.
+ *
+ * Sprint 11 Phase 5 (Cross-product tracking timeline). One row per
+ * milestone in the `milestone_events` table, project-scoped via FK. v1
+ * is read-mostly (CRUD); drag-to-reschedule deferred to Sprint 14.
+ *
+ * Tenant isolation: every method scopes by projectId. Pattern D applies —
+ * `update` / `delete` against a row owned by a different projectId
+ * surfaces as `not_found` rather than `tenant_mismatch` (defense-in-depth
+ * against tenant enumeration). The composite (id, projectId) unique-ish
+ * lookup on `update` / `delete` is what enforces this — Prisma's
+ * `update({ where: { id, projectId } })` raises P2025 when nothing
+ * matches, and `deleteMany({ where: { id, projectId } })` returns
+ * `count: 0`.
+ *
+ * Validation runs at the factory boundary BEFORE any Prisma call — empty
+ * `name` / `kind` / `createdBy` / `projectId` throw `invalid_input` so
+ * the error surfaces with a clear caller-bug code rather than as a
+ * Prisma constraint violation.
+ *
+ * The kind column is intentionally a free-form String (not a Prisma
+ * enum). The factory enforces non-empty + trims; consumers may emit
+ * custom kinds (the conflict-detection helpers in @derwinjs/core treat
+ * unknown kinds as "no conflict computed against this kind").
+ */
+import { Prisma } from './prisma.js';
+import { MilestoneEventStoreError, } from '@derwinjs/sdk';
+// ─── Validation ──────────────────────────────────────────────────────────
+function assertNonEmpty(value, fieldName) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new MilestoneEventStoreError('invalid_input', `createPrismaMilestoneEventStore: ${fieldName} is required and non-empty`);
+    }
+}
+function assertDate(value, fieldName) {
+    if (!(value instanceof Date) || Number.isNaN(value.getTime())) {
+        throw new MilestoneEventStoreError('invalid_input', `createPrismaMilestoneEventStore: ${fieldName} must be a valid Date`);
+    }
+}
+function assertCreateInput(input) {
+    assertNonEmpty(input.projectId, 'projectId');
+    assertNonEmpty(input.name, 'name');
+    assertNonEmpty(input.kind, 'kind');
+    assertNonEmpty(input.createdBy, 'createdBy');
+    assertDate(input.startsAt, 'startsAt');
+    if (input.endsAt !== undefined) {
+        assertDate(input.endsAt, 'endsAt');
+        if (input.endsAt.getTime() < input.startsAt.getTime()) {
+            throw new MilestoneEventStoreError('invalid_input', 'createPrismaMilestoneEventStore: endsAt must be greater than or equal to startsAt');
+        }
+    }
+    if (input.description !== undefined && typeof input.description !== 'string') {
+        throw new MilestoneEventStoreError('invalid_input', 'createPrismaMilestoneEventStore: description must be a string when present');
+    }
+}
+function assertUpdatePatch(patch) {
+    if (patch.name !== undefined)
+        assertNonEmpty(patch.name, 'name');
+    if (patch.kind !== undefined)
+        assertNonEmpty(patch.kind, 'kind');
+    if (patch.startsAt !== undefined)
+        assertDate(patch.startsAt, 'startsAt');
+    if (patch.endsAt !== undefined && patch.endsAt !== null)
+        assertDate(patch.endsAt, 'endsAt');
+    if (patch.description !== undefined &&
+        patch.description !== null &&
+        typeof patch.description !== 'string') {
+        throw new MilestoneEventStoreError('invalid_input', 'createPrismaMilestoneEventStore: description must be a string or null when present');
+    }
+    // Cross-field check: if BOTH startsAt and endsAt are in the patch and
+    // both non-null, they must satisfy startsAt <= endsAt.
+    if (patch.startsAt !== undefined &&
+        patch.endsAt !== undefined &&
+        patch.endsAt !== null &&
+        patch.endsAt.getTime() < patch.startsAt.getTime()) {
+        throw new MilestoneEventStoreError('invalid_input', 'createPrismaMilestoneEventStore: endsAt must be greater than or equal to startsAt');
+    }
+}
+// ─── Factory ─────────────────────────────────────────────────────────────
+export function createPrismaMilestoneEventStore(config) {
+    const { prisma } = config;
+    return {
+        async list(filter) {
+            assertNonEmpty(filter.projectId, 'projectId');
+            const where = { projectId: filter.projectId };
+            const now = Date.now();
+            if (typeof filter.sinceMs === 'number' && Number.isFinite(filter.sinceMs)) {
+                const since = new Date(now - filter.sinceMs);
+                // A range milestone is "in window" if its startsAt OR endsAt
+                // falls in the trailing window. Point-in-time milestones (no
+                // endsAt) match on startsAt only.
+                where.OR = [{ startsAt: { gte: since } }, { endsAt: { gte: since } }];
+            }
+            if (typeof filter.untilMs === 'number' && Number.isFinite(filter.untilMs)) {
+                const until = new Date(now + filter.untilMs);
+                where.startsAt = { ...where.startsAt, lte: until };
+            }
+            if (Array.isArray(filter.kinds) && filter.kinds.length > 0) {
+                where.kind = { in: filter.kinds };
+            }
+            try {
+                const rows = await prisma.milestoneEvent.findMany({
+                    where,
+                    orderBy: { startsAt: 'asc' },
+                });
+                return rows.map(toMilestoneEvent);
+            }
+            catch (err) {
+                throw new MilestoneEventStoreError('storage_failed', `createPrismaMilestoneEventStore: list raised: ${err.message}`, err);
+            }
+        },
+        async create(input) {
+            assertCreateInput(input);
+            try {
+                const row = await prisma.milestoneEvent.create({
+                    data: {
+                        projectId: input.projectId,
+                        name: input.name,
+                        description: input.description ?? null,
+                        startsAt: input.startsAt,
+                        endsAt: input.endsAt ?? null,
+                        kind: input.kind,
+                        createdBy: input.createdBy,
+                    },
+                });
+                return toMilestoneEvent(row);
+            }
+            catch (err) {
+                if (err instanceof Prisma.PrismaClientKnownRequestError && err.code === 'P2003') {
+                    // FK violation on projectId — surface as invalid_input rather
+                    // than storage_failed so the API layer can return 400 (the
+                    // operator passed a nonexistent projectId, not a transient
+                    // storage problem).
+                    throw new MilestoneEventStoreError('invalid_input', `createPrismaMilestoneEventStore: projectId ${input.projectId} does not resolve to a Project row`, err);
+                }
+                throw new MilestoneEventStoreError('storage_failed', `createPrismaMilestoneEventStore: create raised: ${err.message}`, err);
+            }
+        },
+        async update(id, projectId, patch) {
+            assertNonEmpty(id, 'id');
+            assertNonEmpty(projectId, 'projectId');
+            assertUpdatePatch(patch);
+            // Two-step: updateMany returns count so we can distinguish
+            // not-found / wrong-tenant (count === 0) from a successful update
+            // without leaking existence via the standard `update` API's P2025.
+            try {
+                const data = {};
+                if (patch.name !== undefined)
+                    data.name = patch.name;
+                if (patch.description !== undefined)
+                    data.description = patch.description;
+                if (patch.startsAt !== undefined)
+                    data.startsAt = patch.startsAt;
+                if (patch.endsAt !== undefined)
+                    data.endsAt = patch.endsAt;
+                if (patch.kind !== undefined)
+                    data.kind = patch.kind;
+                const result = await prisma.milestoneEvent.updateMany({
+                    where: { id, projectId },
+                    data,
+                });
+                if (result.count === 0) {
+                    throw new MilestoneEventStoreError('not_found', `createPrismaMilestoneEventStore: milestone id=${id} not found in project ${projectId}`);
+                }
+                // Re-read to return the fresh row. updatedAt has been refreshed
+                // by Prisma's @updatedAt directive at this point.
+                const fresh = await prisma.milestoneEvent.findFirst({
+                    where: { id, projectId },
+                });
+                if (fresh === null) {
+                    // Concurrent delete between updateMany + findFirst. Rare; surface
+                    // as not_found.
+                    throw new MilestoneEventStoreError('not_found', `createPrismaMilestoneEventStore: milestone id=${id} disappeared after update in project ${projectId}`);
+                }
+                return toMilestoneEvent(fresh);
+            }
+            catch (err) {
+                if (err instanceof MilestoneEventStoreError)
+                    throw err;
+                throw new MilestoneEventStoreError('storage_failed', `createPrismaMilestoneEventStore: update raised: ${err.message}`, err);
+            }
+        },
+        async delete(id, projectId) {
+            assertNonEmpty(id, 'id');
+            assertNonEmpty(projectId, 'projectId');
+            try {
+                const result = await prisma.milestoneEvent.deleteMany({
+                    where: { id, projectId },
+                });
+                return result.count > 0;
+            }
+            catch (err) {
+                throw new MilestoneEventStoreError('storage_failed', `createPrismaMilestoneEventStore: delete raised: ${err.message}`, err);
+            }
+        },
+    };
+}
+/**
+ * Project a Prisma row to the SDK MilestoneEvent shape. Per memory
+ * rule 22, no defensive `as PrismaMilestoneEventRow` cast at the
+ * argument site — the inferred Prisma return type is exact after
+ * `prisma generate`. The inline interface above just documents the
+ * shape for readers; it's structurally compatible with the generated
+ * MilestoneEventGetPayload.
+ */
+function toMilestoneEvent(row) {
+    return {
+        id: row.id,
+        projectId: row.projectId,
+        name: row.name,
+        description: row.description,
+        startsAt: row.startsAt,
+        endsAt: row.endsAt,
+        kind: row.kind,
+        createdBy: row.createdBy,
+        createdAt: row.createdAt,
+        updatedAt: row.updatedAt,
+    };
+}
+//# sourceMappingURL=milestone-event-store.js.map

package/dist/milestone-event-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"milestone-event-store.js","sourceRoot":"","sources":["../src/milestone-event-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,wBAAwB,GAMzB,MAAM,eAAe,CAAC;AASvB,4EAA4E;AAE5E,SAAS,cAAc,CAAC,KAAc,EAAE,SAAiB;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,oCAAoC,SAAS,4BAA4B,CAC1E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc,EAAE,SAAiB;IACnD,IAAI,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,oCAAoC,SAAS,uBAAuB,CACrE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgC;IACzD,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC7C,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACnC,cAAc,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC7C,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACnC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YACtD,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,mFAAmF,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC7E,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,4EAA4E,CAC7E,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAgC;IACzD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjE,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;QAAE,UAAU,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI;QAAE,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5F,IACE,KAAK,CAAC,WAAW,KAAK,SAAS;QAC/B,KAAK,CAAC,WAAW,KAAK,IAAI;QAC1B,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EACrC,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,oFAAoF,CACrF,CAAC;IACJ,CAAC;IACD,sEAAsE;IACtE,uDAAuD;IACvD,IACE,KAAK,CAAC,QAAQ,KAAK,SAAS;QAC5B,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1B,KAAK,CAAC,MAAM,KAAK,IAAI;QACrB,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,EACjD,CAAC;QACD,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,mFAAmF,CACpF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,4EAA4E;AAE5E,MAAM,UAAU,+BAA+B,CAC7C,MAAuC;IAEvC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAgC;YACzC,cAAc,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAE9C,MAAM,KAAK,GAAoC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;YAC/E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7C,6DAA6D;gBAC7D,6DAA6D;gBAC7D,kCAAkC;gBAClC,KAAK,CAAC,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1E,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAC7C,KAAK,CAAC,QAAQ,GAAG,EAAE,GAAI,KAAK,CAAC,QAA8C,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;YAC5F,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3D,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YACpC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC;oBAChD,KAAK;oBACL,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;iBAC7B,CAAC,CAAC;gBACH,OAAO,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,wBAAwB,CAChC,gBAAgB,EAChB,iDAAkD,GAAa,CAAC,OAAO,EAAE,EACzE,GAAG,CACJ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,KAAgC;YAC3C,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAEzB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC;oBAC7C,IAAI,EAAE;wBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;wBAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;wBACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;wBACxB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;wBAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,SAAS,EAAE,KAAK,CAAC,SAAS;qBAC3B;iBACF,CAAC,CAAC;gBACH,OAAO,gBAAgB,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,MAAM,CAAC,6BAA6B,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAChF,8DAA8D;oBAC9D,2DAA2D;oBAC3D,2DAA2D;oBAC3D,oBAAoB;oBACpB,MAAM,IAAI,wBAAwB,CAChC,eAAe,EACf,8CAA8C,KAAK,CAAC,SAAS,oCAAoC,EACjG,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,wBAAwB,CAChC,gBAAgB,EAChB,mDAAoD,GAAa,CAAC,OAAO,EAAE,EAC3E,GAAG,CACJ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,SAAiB,EACjB,KAAgC;YAEhC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzB,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACvC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAEzB,2DAA2D;YAC3D,kEAAkE;YAClE,mEAAmE;YACnE,IAAI,CAAC;gBACH,MAAM,IAAI,GAAqC,EAAE,CAAC;gBAClD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;oBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBACrD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;oBAAE,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;gBAC1E,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS;oBAAE,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;gBACjE,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;oBAAE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;gBAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;oBAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;gBAErD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC;oBACpD,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;oBACxB,IAAI;iBACL,CAAC,CAAC;gBAEH,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,wBAAwB,CAChC,WAAW,EACX,iDAAiD,EAAE,yBAAyB,SAAS,EAAE,CACxF,CAAC;gBACJ,CAAC;gBAED,gEAAgE;gBAChE,kDAAkD;gBAClD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC;oBAClD,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;iBACzB,CAAC,CAAC;gBACH,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;oBACnB,kEAAkE;oBAClE,gBAAgB;oBAChB,MAAM,IAAI,wBAAwB,CAChC,WAAW,EACX,iDAAiD,EAAE,wCAAwC,SAAS,EAAE,CACvG,CAAC;gBACJ,CAAC;gBACD,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACjC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,wBAAwB;oBAAE,MAAM,GAAG,CAAC;gBACvD,MAAM,IAAI,wBAAwB,CAChC,gBAAgB,EAChB,mDAAoD,GAAa,CAAC,OAAO,EAAE,EAC3E,GAAG,CACJ,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,SAAiB;YACxC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACzB,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAEvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC;oBACpD,KAAK,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;iBACzB,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;YAC1B,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,IAAI,wBAAwB,CAChC,gBAAgB,EAChB,mDAAoD,GAAa,CAAC,OAAO,EAAE,EAC3E,GAAG,CACJ,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAiBD;;;;;;;GAOG;AACH,SAAS,gBAAgB,CAAC,GAAsB;IAC9C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC"}

package/dist/rum-sample-store.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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.
+ */
+import type { PrismaClient } from './prisma.js';
+import type { RumSampleStore } from '@derwinjs/sdk';
+export interface PrismaRumSampleStoreConfig {
+    /** Generated Prisma client. Pass an instance per process. */
+    prisma: PrismaClient;
+}
+/**
+ * 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 declare class RumSampleStoreError extends Error {
+    readonly code: 'invalid_input' | 'io_failed';
+    readonly cause?: unknown | undefined;
+    constructor(code: 'invalid_input' | 'io_failed', message: string, cause?: unknown | undefined);
+}
+export declare function createPrismaRumSampleStore(config: PrismaRumSampleStoreConfig): RumSampleStore;
+//# sourceMappingURL=rum-sample-store.d.ts.map

package/dist/rum-sample-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rum-sample-store.d.ts","sourceRoot":"","sources":["../src/rum-sample-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,eAAe,CAAC;AAIjE,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,MAAM,EAAE,YAAY,CAAC;CACtB;AAID;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAE1B,IAAI,EAAE,eAAe,GAAG,WAAW;aAE1B,KAAK,CAAC,EAAE,OAAO;gBAFxB,IAAI,EAAE,eAAe,GAAG,WAAW,EACnD,OAAO,EAAE,MAAM,EACU,KAAK,CAAC,EAAE,OAAO,YAAA;CAM3C;AAmED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,0BAA0B,GAAG,cAAc,CAwF7F"}