@selvajs/platform 0.13.0 → 0.14.0

package/dist/config.d.ts

@@ -2,6 +2,7 @@ import type { IAuthProvider } from './auth/interface.js';
 import type { IDataProvider } from './data/interface.js';
 import type { IStorageProvider } from './storage/interface.js';
 import type { IEventSink } from './events/interface.js';
+import type { ISolveMetricSink } from './metrics/interface.js';
 import type { IBindingResolver } from './bindings/interface.js';
 /**
  * - `single`: one org per deployment. Setup creates it; `ctx.actingOrgId`
@@ -63,6 +64,12 @@ export interface SelvaConfig {
     storage: IStorageProvider;
     /** Optional. Defaults to `NoopEventSink`. */
     events?: IEventSink;
+    /**
+     * Optional. Records per-solve timing (wall time of the Rhino.Compute solve
+     * call). Defaults to `NoopSolveMetricSink`, which discards every metric.
+     * Supply a real sink to persist or aggregate solve durations.
+     */
+    solveMetrics?: ISolveMetricSink;
     /**
      * Optional. Resolves values for inputs marked as `source.kind === 'server'`
      * in the schema. Defaults to `NoopBindingResolver`, which returns nothing

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IAC1B,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC;IACpB,gEAAgE;IAChE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,WAAW,CAAC;AAE1F,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,GAAG,OAAO,CAElF;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAC3B,MAAM,EAAE,WAAW,GAAG,kBAAkB,GACtC,WAAW,GAAG,kBAAkB,CAElC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC7B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IAC1B,+EAA+E;IAC/E,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,yEAAyE;IACzE,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC3B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,aAAa,CAAC;IACpB;;;OAGG;IACH,IAAI,EAAE,aAAa,CAAC;IACpB,gEAAgE;IAChE,OAAO,EAAE,gBAAgB,CAAC;IAC1B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KAAK,WAAW,CAAC;AAE1F,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,UAAU,GAAG,OAAO,CAElF;AAED,oEAAoE;AACpE,wBAAgB,YAAY,CAC3B,MAAM,EAAE,WAAW,GAAG,kBAAkB,GACtC,WAAW,GAAG,kBAAkB,CAElC"}

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAiFA,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,IAAsB;IACxE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAC3B,MAAwC;IAExC,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAwFA,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,IAAsB;IACxE,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAC3B,MAAwC;IAExC,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -45,6 +45,8 @@ export { canView, canSolve, canEdit, canManage, canEditProjectSettings, canChang
 export type { DomainEvent, DomainEventType, IEventSink } from './events/interface.js';
 export { actorFrom, NoopEventSink } from './events/interface.js';
 export type { AuditEventRow, AuditCursor, AuditQueryFilters, AuditQueryResult, IAuditQuery } from './events/audit.js';
+export type { ISolveMetricSink, SolveMetric, SolveFailureKind } from './metrics/interface.js';
+export { NoopSolveMetricSink } from './metrics/interface.js';
 export type { IBindingResolver } from './bindings/interface.js';
 export { NoopBindingResolver } from './bindings/interface.js';
 export type { AuditUpdate, AuditSoftDelete } from './utils/audit.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -20,6 +20,7 @@ export { isPlatformServer, isOrgServer } from './computeServer/types.js';
 export { serversVisibleTo, defaultServerIdFor, resolveServerForOrg, findServerById, platformServers, orgServersFor } from './computeServer/utils.js';
 export { canView, canSolve, canEdit, canManage, canEditProjectSettings, canChangeVisibilityToPublic, canEditDefinition, canReclaim, canCreateProject, checkOwnerRemoval, withAdminBypass } from './access/rules.js';
 export { actorFrom, NoopEventSink } from './events/interface.js';
+export { NoopSolveMetricSink } from './metrics/interface.js';
 export { NoopBindingResolver } from './bindings/interface.js';
 export { auditUpdate, auditSoftDelete } from './utils/audit.js';
 export { SYSTEM_CONTEXT, hasPermission } from './context.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,cAAc;AAkBd,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAQ5F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAatD,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,MAAM,4BAA4B,CAAC;AAcpC,OAAO,EACN,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACN,0BAA0B,EAC1B,gCAAgC,EAChC,MAAM,+BAA+B,CAAC;AAevC,OAAO,EACN,aAAa,EACb,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EACN,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,UAAU,EACV,UAAU,EACV,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAMrE,OAAO,EACN,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,MAAM,oBAAoB,CAAC;AAiB5B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,MAAM,0BAA0B,CAAC;AAclC,OAAO,EACN,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAajE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAM9D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMhE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAC/E,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,cAAc;AAkBd,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAQ5F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAatD,OAAO,EACN,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,EAC7B,MAAM,4BAA4B,CAAC;AAcpC,OAAO,EACN,uBAAuB,EACvB,iBAAiB,EACjB,oBAAoB,EACpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACN,0BAA0B,EAC1B,gCAAgC,EAChC,MAAM,+BAA+B,CAAC;AAevC,OAAO,EACN,aAAa,EACb,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EACN,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,yBAAyB,EACzB,UAAU,EACV,UAAU,EACV,MAAM,0BAA0B,CAAC;AAOlC,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAMrE,OAAO,EACN,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,sBAAsB,EACtB,MAAM,oBAAoB,CAAC;AAiB5B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGzE,OAAO,EACN,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,aAAa,EACb,MAAM,0BAA0B,CAAC;AAclC,OAAO,EACN,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,EACjB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAajE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAM7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAM9D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMhE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7D,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AASrE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/metrics/interface.d.ts

@@ -0,0 +1,83 @@
+import type { RequestContext } from '../context.js';
+/**
+ * Why a solve did not produce a usable result. `ok` means the solve completed
+ * (it may still carry Grasshopper runtime errors — see `errorCount`). The
+ * failure kinds mirror the distinct branches the compute route already
+ * distinguishes, so the recorded reason matches the HTTP status the client saw.
+ */
+export type SolveFailureKind = 
+/** Solve completed; the response was returned to the client. */
+'ok'
+/** Scheduler deadline exceeded (HTTP 504). */
+ | 'timeout'
+/** Client disconnected mid-solve; the request signal aborted (HTTP 499). */
+ | 'client_abort'
+/** Rejected by the per-key rate limiter before solving (HTTP 429). */
+ | 'rate_limited'
+/** Share-link solve cap reached before solving (HTTP 429). */
+ | 'share_cap'
+/** Result exceeded the response size limit (HTTP 413). */
+ | 'too_large'
+/** Compute server unreachable or the solve threw for any other reason. */
+ | 'compute_error';
+/**
+ * One solve's timing and outcome, recorded once per solve attempt — including
+ * attempts rejected before `scheduler.solve()` runs (rate limit, share cap).
+ *
+ * `durationMs` is wall time around the Rhino.Compute solve call only — it
+ * excludes definition loading, auth, schema work, and result serialization. It
+ * is 0 for attempts rejected before the solve started.
+ */
+export interface SolveMetric {
+    /** Definition the solve ran against. `local:<guid>` or a remote URL. */
+    definitionUrl: string;
+    /**
+     * Local definition id (the `local:` guid), or null for remote-URL solves.
+     * Stored alongside `definitionUrl` so timings join to the definition record.
+     */
+    definitionId: string | null;
+    /**
+     * The exact version solved, or null for remote-URL solves (and for local
+     * attempts rejected before the version resolved). Lets you compare timings
+     * across versions of the same definition.
+     */
+    versionId: string | null;
+    /** Channel solved, mirroring the compute request. */
+    channel: 'live' | 'draft';
+    /** Org whose compute pool served the solve, or null for remote definitions. */
+    orgId: string | null;
+    /** Wall-clock duration of `scheduler.solve()` in milliseconds. 0 if never started. */
+    durationMs: number;
+    /** Whether the solve completed and returned a result. */
+    ok: boolean;
+    /** Why the solve did not return a result; `'ok'` when it did. */
+    failureKind: SolveFailureKind;
+    /**
+     * Count of Grasshopper runtime errors in the solve response. A solve can be
+     * `ok` yet still report component-level errors — this is distinct from
+     * `failureKind`. 0 when the solve never returned a response.
+     */
+    errorCount: number;
+    /** Count of Grasshopper runtime warnings in the solve response. */
+    warningCount: number;
+}
+/**
+ * Sink for per-solve timing telemetry. Called once per solve attempt from the
+ * compute route, AFTER the solve resolves or rejects.
+ *
+ * MUST NOT throw — recording is best-effort and sits on the hot path of every
+ * solve. Implementations catch and log their own failures; the only side
+ * effect visible to the caller is a fulfilled promise. MAY be fire-and-forget.
+ */
+export interface ISolveMetricSink {
+    record(ctx: RequestContext, metric: SolveMetric): Promise<void>;
+}
+/**
+ * Default `ISolveMetricSink` — discards every metric. Used when
+ * `SelvaConfig.solveMetrics` is omitted. Swap in a real sink to persist or
+ * aggregate solve timings.
+ */
+export declare class NoopSolveMetricSink implements ISolveMetricSink {
+    record(_ctx: RequestContext, _metric: SolveMetric): Promise<void>;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/metrics/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/metrics/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB;AAC3B,gEAAgE;AAC9D,IAAI;AACN,8CAA8C;GAC5C,SAAS;AACX,4EAA4E;GAC1E,cAAc;AAChB,sEAAsE;GACpE,cAAc;AAChB,8DAA8D;GAC5D,WAAW;AACb,0DAA0D;GACxD,WAAW;AACb,0EAA0E;GACxE,eAAe,CAAC;AAEnB;;;;;;;GAOG;AACH,MAAM,WAAW,WAAW;IAC3B,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;;;OAIG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,EAAE,EAAE,OAAO,CAAC;IACZ,iEAAiE;IACjE,WAAW,EAAE,gBAAgB,CAAC;IAC9B;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAChC,MAAM,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IACrD,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CACvE"}

package/dist/metrics/interface.js

@@ -0,0 +1,9 @@
+/**
+ * Default `ISolveMetricSink` — discards every metric. Used when
+ * `SelvaConfig.solveMetrics` is omitted. Swap in a real sink to persist or
+ * aggregate solve timings.
+ */
+export class NoopSolveMetricSink {
+    async record(_ctx, _metric) { }
+}
+//# sourceMappingURL=interface.js.map

package/dist/metrics/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/metrics/interface.ts"],"names":[],"mappings":"AA8EA;;;;GAIG;AACH,MAAM,OAAO,mBAAmB;IAC/B,KAAK,CAAC,MAAM,CAAC,IAAoB,EAAE,OAAoB,IAAkB,CAAC;CAC1E"}

package/dist/testing/index.d.ts

@@ -20,6 +20,8 @@ export { runShareLinkStoreConformance } from './suites/shareLinkStoreSuite.js';
 export type { ShareLinkStoreConformanceOptions, ShareLinkTestScope } from './suites/shareLinkStoreSuite.js';
 export { runEventSinkConformance, RecordingEventSink } from './suites/eventSinkSuite.js';
 export type { EventSinkConformanceOptions } from './suites/eventSinkSuite.js';
+export { runSolveMetricSinkConformance } from './suites/solveMetricSinkSuite.js';
+export type { SolveMetricSinkConformanceOptions, RecordedSolveMetric } from './suites/solveMetricSinkSuite.js';
 export { runPlatformPermissionStoreConformance } from './suites/platformPermissionStoreSuite.js';
 export type { PlatformPermissionStoreConformanceOptions } from './suites/platformPermissionStoreSuite.js';
 export { runPlatformProjectGrantStoreConformance } from './suites/platformProjectGrantStoreSuite.js';

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAE1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAE1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,YAAY,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnG,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AACvF,YAAY,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAEhG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,YAAY,EACX,gCAAgC,EAChC,kBAAkB,EAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACzF,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC;AACjG,YAAY,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AAE1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,4CAA4C,CAAC;AACrG,YAAY,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAC7E,YAAY,EAAE,+BAA+B,EAAE,MAAM,gCAAgC,CAAC;AAEtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAE1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,YAAY,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,YAAY,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AAE1F,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACnF,YAAY,EAAE,kCAAkC,EAAE,MAAM,mCAAmC,CAAC;AAE5F,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,YAAY,EAAE,6BAA6B,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnG,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AACvF,YAAY,EAAE,oCAAoC,EAAE,MAAM,qCAAqC,CAAC;AAEhG,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAC/E,YAAY,EACX,gCAAgC,EAChC,kBAAkB,EAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACzF,YAAY,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAE9E,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EACX,iCAAiC,EACjC,mBAAmB,EACnB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC;AACjG,YAAY,EAAE,yCAAyC,EAAE,MAAM,0CAA0C,CAAC;AAE1G,OAAO,EAAE,uCAAuC,EAAE,MAAM,4CAA4C,CAAC;AACrG,YAAY,EAAE,2CAA2C,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/testing/index.js

@@ -9,6 +9,7 @@ export { runInviteStoreConformance } from './suites/inviteStoreSuite.js';
 export { runComputeServerStoreConformance } from './suites/computeServerStoreSuite.js';
 export { runShareLinkStoreConformance } from './suites/shareLinkStoreSuite.js';
 export { runEventSinkConformance, RecordingEventSink } from './suites/eventSinkSuite.js';
+export { runSolveMetricSinkConformance } from './suites/solveMetricSinkSuite.js';
 export { runPlatformPermissionStoreConformance } from './suites/platformPermissionStoreSuite.js';
 export { runPlatformProjectGrantStoreConformance } from './suites/platformProjectGrantStoreSuite.js';
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAG7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAGnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAGvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAM/E,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC;AAGjG,OAAO,EAAE,uCAAuC,EAAE,MAAM,4CAA4C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAG7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAGjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAGnF,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,EAAE,gCAAgC,EAAE,MAAM,qCAAqC,CAAC;AAGvF,OAAO,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAM/E,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGzF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAMjF,OAAO,EAAE,qCAAqC,EAAE,MAAM,0CAA0C,CAAC;AAGjG,OAAO,EAAE,uCAAuC,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/testing/suites/solveMetricSinkSuite.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Adapter conformance suite for the solve-metric-sink contract.
+ *
+ * Unlike `IEventSink`, an `ISolveMetricSink` is not driven by store mutations —
+ * the compute route calls `record()` directly, once per solve attempt. So this
+ * suite is a round-trip: hand a `SolveMetric` to the sink, then read the row
+ * back through an adapter-supplied `readRows` and assert the persisted shape.
+ *
+ * It also pins the contract's hard guarantee: `record` MUST NOT throw, even on
+ * a backend failure — the compute route depends on that to keep serving the
+ * response after a solve.
+ */
+import type { ISolveMetricSink, SolveMetric } from '../../index.js';
+/**
+ * Adapter's view of a persisted metric, normalized back to the `SolveMetric`
+ * shape plus the recorded `actorId`. Implementations map their column names
+ * onto these fields so the suite stays storage-agnostic.
+ */
+export interface RecordedSolveMetric extends SolveMetric {
+    /** The actor the sink derived from the `RequestContext` it was handed. */
+    actorId: string;
+}
+export interface SolveMetricSinkConformanceOptions {
+    name: string;
+    /** Build a fresh sink against the adapter's backend. */
+    createSink: () => Promise<ISolveMetricSink> | ISolveMetricSink;
+    /** Read every persisted metric back, normalized to `RecordedSolveMetric`. */
+    readRows: () => Promise<RecordedSolveMetric[]>;
+    /**
+     * Build a sink whose backing store is broken so writes fail. Used to prove
+     * `record` swallows errors. Omit if the adapter can't simulate a failure;
+     * the throw-safety test is skipped when absent.
+     */
+    createFailingSink?: () => Promise<ISolveMetricSink> | ISolveMetricSink;
+    /** Optional per-test cleanup (truncate the metrics table, etc.). */
+    cleanup?: () => Promise<void> | void;
+}
+export declare function runSolveMetricSinkConformance(opts: SolveMetricSinkConformanceOptions): void;
+//# sourceMappingURL=solveMetricSinkSuite.d.ts.map

package/dist/testing/suites/solveMetricSinkSuite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"solveMetricSinkSuite.d.ts","sourceRoot":"","sources":["../../../src/testing/suites/solveMetricSinkSuite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AAEpF;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACvD,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iCAAiC;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,UAAU,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;IAC/D,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC/C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;IACvE,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrC;AAsBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,iCAAiC,GAAG,IAAI,CAwE3F"}

package/dist/testing/suites/solveMetricSinkSuite.js

@@ -0,0 +1,89 @@
+/**
+ * Adapter conformance suite for the solve-metric-sink contract.
+ *
+ * Unlike `IEventSink`, an `ISolveMetricSink` is not driven by store mutations —
+ * the compute route calls `record()` directly, once per solve attempt. So this
+ * suite is a round-trip: hand a `SolveMetric` to the sink, then read the row
+ * back through an adapter-supplied `readRows` and assert the persisted shape.
+ *
+ * It also pins the contract's hard guarantee: `record` MUST NOT throw, even on
+ * a backend failure — the compute route depends on that to keep serving the
+ * response after a solve.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+function sysCtx(userId) {
+    return { userId, platformPermissions: [], orgPermissions: [], system: true };
+}
+function baseMetric(overrides = {}) {
+    return {
+        definitionUrl: 'local:00000000-0000-0000-0000-0000000000aa',
+        definitionId: '00000000-0000-0000-0000-0000000000aa',
+        versionId: '00000000-0000-0000-0000-0000000000bb',
+        channel: 'live',
+        orgId: '00000000-0000-0000-0000-0000000000cc',
+        durationMs: 123.5,
+        ok: true,
+        failureKind: 'ok',
+        errorCount: 0,
+        warningCount: 0,
+        ...overrides
+    };
+}
+export function runSolveMetricSinkConformance(opts) {
+    const { name, createSink, readRows, createFailingSink, cleanup } = opts;
+    describe(`ISolveMetricSink conformance: ${name}`, () => {
+        let sink;
+        beforeEach(async () => {
+            sink = await createSink();
+        });
+        afterEach(async () => {
+            if (cleanup)
+                await cleanup();
+        });
+        it('persists a successful solve with all fields intact', async () => {
+            const metric = baseMetric();
+            await sink.record(sysCtx('user-1'), metric);
+            const rows = await readRows();
+            expect(rows).toHaveLength(1);
+            expect(rows[0]).toMatchObject({ ...metric, actorId: 'user-1' });
+        });
+        it('records the actor from the RequestContext', async () => {
+            await sink.record(sysCtx('user-xyz'), baseMetric());
+            const rows = await readRows();
+            expect(rows[0].actorId).toBe('user-xyz');
+        });
+        it('falls back to "system" when the context has no user id', async () => {
+            await sink.record(sysCtx(''), baseMetric());
+            const rows = await readRows();
+            expect(rows[0].actorId).toBe('system');
+        });
+        it('persists a failed solve with its failureKind and zero duration', async () => {
+            await sink.record(sysCtx('user-1'), baseMetric({ ok: false, failureKind: 'timeout', durationMs: 0 }));
+            const rows = await readRows();
+            expect(rows[0]).toMatchObject({ ok: false, failureKind: 'timeout', durationMs: 0 });
+        });
+        it('persists error/warning counts on an otherwise-ok solve', async () => {
+            await sink.record(sysCtx('user-1'), baseMetric({ errorCount: 2, warningCount: 5 }));
+            const rows = await readRows();
+            expect(rows[0]).toMatchObject({ ok: true, errorCount: 2, warningCount: 5 });
+        });
+        it('persists null definition/version/org for remote-URL solves', async () => {
+            await sink.record(sysCtx('user-1'), baseMetric({
+                definitionUrl: 'https://example.com/def.gh',
+                definitionId: null,
+                versionId: null,
+                orgId: null
+            }));
+            const rows = await readRows();
+            expect(rows[0]).toMatchObject({ definitionId: null, versionId: null, orgId: null });
+        });
+        if (createFailingSink) {
+            it('does not throw when the backing write fails', async () => {
+                const failing = await createFailingSink();
+                // The contract: record swallows the failure and resolves.
+                await expect(failing.record(sysCtx('user-1'), baseMetric())).resolves.toBeUndefined();
+            });
+        }
+    });
+}
+//# sourceMappingURL=solveMetricSinkSuite.js.map

package/dist/testing/suites/solveMetricSinkSuite.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@selvajs/platform",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Pure TypeScript interfaces for Selva platform providers (auth, definitions, compute)",
   "license": "MIT",
   "publishConfig": {

package/src/config.ts

@@ -2,6 +2,7 @@ import type { IAuthProvider } from './auth/interface.js';
 import type { IDataProvider } from './data/interface.js';
 import type { IStorageProvider } from './storage/interface.js';
 import type { IEventSink } from './events/interface.js';
+import type { ISolveMetricSink } from './metrics/interface.js';
 import type { IBindingResolver } from './bindings/interface.js';
 
 /**
@@ -67,6 +68,12 @@ export interface SelvaConfig {
 	storage: IStorageProvider;
 	/** Optional. Defaults to `NoopEventSink`. */
 	events?: IEventSink;
+	/**
+	 * Optional. Records per-solve timing (wall time of the Rhino.Compute solve
+	 * call). Defaults to `NoopSolveMetricSink`, which discards every metric.
+	 * Supply a real sink to persist or aggregate solve durations.
+	 */
+	solveMetrics?: ISolveMetricSink;
 	/**
 	 * Optional. Resolves values for inputs marked as `source.kind === 'server'`
 	 * in the schema. Defaults to `NoopBindingResolver`, which returns nothing

package/src/index.ts

@@ -200,6 +200,12 @@ export type {
 	IAuditQuery
 } from './events/audit.js';
 
+// ---------------------------------------------------------------------------
+// metrics (per-solve timing telemetry)
+// ---------------------------------------------------------------------------
+export type { ISolveMetricSink, SolveMetric, SolveFailureKind } from './metrics/interface.js';
+export { NoopSolveMetricSink } from './metrics/interface.js';
+
 // ---------------------------------------------------------------------------
 // bindings (server-side resolver for schema inputs marked `source.kind === 'server'`)
 // ---------------------------------------------------------------------------

package/src/metrics/interface.ts

@@ -0,0 +1,86 @@
+import type { RequestContext } from '../context.js';
+
+/**
+ * Why a solve did not produce a usable result. `ok` means the solve completed
+ * (it may still carry Grasshopper runtime errors — see `errorCount`). The
+ * failure kinds mirror the distinct branches the compute route already
+ * distinguishes, so the recorded reason matches the HTTP status the client saw.
+ */
+export type SolveFailureKind =
+	/** Solve completed; the response was returned to the client. */
+	| 'ok'
+	/** Scheduler deadline exceeded (HTTP 504). */
+	| 'timeout'
+	/** Client disconnected mid-solve; the request signal aborted (HTTP 499). */
+	| 'client_abort'
+	/** Rejected by the per-key rate limiter before solving (HTTP 429). */
+	| 'rate_limited'
+	/** Share-link solve cap reached before solving (HTTP 429). */
+	| 'share_cap'
+	/** Result exceeded the response size limit (HTTP 413). */
+	| 'too_large'
+	/** Compute server unreachable or the solve threw for any other reason. */
+	| 'compute_error';
+
+/**
+ * One solve's timing and outcome, recorded once per solve attempt — including
+ * attempts rejected before `scheduler.solve()` runs (rate limit, share cap).
+ *
+ * `durationMs` is wall time around the Rhino.Compute solve call only — it
+ * excludes definition loading, auth, schema work, and result serialization. It
+ * is 0 for attempts rejected before the solve started.
+ */
+export interface SolveMetric {
+	/** Definition the solve ran against. `local:<guid>` or a remote URL. */
+	definitionUrl: string;
+	/**
+	 * Local definition id (the `local:` guid), or null for remote-URL solves.
+	 * Stored alongside `definitionUrl` so timings join to the definition record.
+	 */
+	definitionId: string | null;
+	/**
+	 * The exact version solved, or null for remote-URL solves (and for local
+	 * attempts rejected before the version resolved). Lets you compare timings
+	 * across versions of the same definition.
+	 */
+	versionId: string | null;
+	/** Channel solved, mirroring the compute request. */
+	channel: 'live' | 'draft';
+	/** Org whose compute pool served the solve, or null for remote definitions. */
+	orgId: string | null;
+	/** Wall-clock duration of `scheduler.solve()` in milliseconds. 0 if never started. */
+	durationMs: number;
+	/** Whether the solve completed and returned a result. */
+	ok: boolean;
+	/** Why the solve did not return a result; `'ok'` when it did. */
+	failureKind: SolveFailureKind;
+	/**
+	 * Count of Grasshopper runtime errors in the solve response. A solve can be
+	 * `ok` yet still report component-level errors — this is distinct from
+	 * `failureKind`. 0 when the solve never returned a response.
+	 */
+	errorCount: number;
+	/** Count of Grasshopper runtime warnings in the solve response. */
+	warningCount: number;
+}
+
+/**
+ * Sink for per-solve timing telemetry. Called once per solve attempt from the
+ * compute route, AFTER the solve resolves or rejects.
+ *
+ * MUST NOT throw — recording is best-effort and sits on the hot path of every
+ * solve. Implementations catch and log their own failures; the only side
+ * effect visible to the caller is a fulfilled promise. MAY be fire-and-forget.
+ */
+export interface ISolveMetricSink {
+	record(ctx: RequestContext, metric: SolveMetric): Promise<void>;
+}
+
+/**
+ * Default `ISolveMetricSink` — discards every metric. Used when
+ * `SelvaConfig.solveMetrics` is omitted. Swap in a real sink to persist or
+ * aggregate solve timings.
+ */
+export class NoopSolveMetricSink implements ISolveMetricSink {
+	async record(_ctx: RequestContext, _metric: SolveMetric): Promise<void> {}
+}

package/src/testing/index.ts

@@ -34,6 +34,12 @@ export type {
 export { runEventSinkConformance, RecordingEventSink } from './suites/eventSinkSuite.js';
 export type { EventSinkConformanceOptions } from './suites/eventSinkSuite.js';
 
+export { runSolveMetricSinkConformance } from './suites/solveMetricSinkSuite.js';
+export type {
+	SolveMetricSinkConformanceOptions,
+	RecordedSolveMetric
+} from './suites/solveMetricSinkSuite.js';
+
 export { runPlatformPermissionStoreConformance } from './suites/platformPermissionStoreSuite.js';
 export type { PlatformPermissionStoreConformanceOptions } from './suites/platformPermissionStoreSuite.js';
 

package/src/testing/suites/solveMetricSinkSuite.ts

@@ -0,0 +1,135 @@
+/**
+ * Adapter conformance suite for the solve-metric-sink contract.
+ *
+ * Unlike `IEventSink`, an `ISolveMetricSink` is not driven by store mutations —
+ * the compute route calls `record()` directly, once per solve attempt. So this
+ * suite is a round-trip: hand a `SolveMetric` to the sink, then read the row
+ * back through an adapter-supplied `readRows` and assert the persisted shape.
+ *
+ * It also pins the contract's hard guarantee: `record` MUST NOT throw, even on
+ * a backend failure — the compute route depends on that to keep serving the
+ * response after a solve.
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import type { ISolveMetricSink, SolveMetric, RequestContext } from '../../index.js';
+
+/**
+ * Adapter's view of a persisted metric, normalized back to the `SolveMetric`
+ * shape plus the recorded `actorId`. Implementations map their column names
+ * onto these fields so the suite stays storage-agnostic.
+ */
+export interface RecordedSolveMetric extends SolveMetric {
+	/** The actor the sink derived from the `RequestContext` it was handed. */
+	actorId: string;
+}
+
+export interface SolveMetricSinkConformanceOptions {
+	name: string;
+	/** Build a fresh sink against the adapter's backend. */
+	createSink: () => Promise<ISolveMetricSink> | ISolveMetricSink;
+	/** Read every persisted metric back, normalized to `RecordedSolveMetric`. */
+	readRows: () => Promise<RecordedSolveMetric[]>;
+	/**
+	 * Build a sink whose backing store is broken so writes fail. Used to prove
+	 * `record` swallows errors. Omit if the adapter can't simulate a failure;
+	 * the throw-safety test is skipped when absent.
+	 */
+	createFailingSink?: () => Promise<ISolveMetricSink> | ISolveMetricSink;
+	/** Optional per-test cleanup (truncate the metrics table, etc.). */
+	cleanup?: () => Promise<void> | void;
+}
+
+function sysCtx(userId: string): RequestContext {
+	return { userId, platformPermissions: [], orgPermissions: [], system: true };
+}
+
+function baseMetric(overrides: Partial<SolveMetric> = {}): SolveMetric {
+	return {
+		definitionUrl: 'local:00000000-0000-0000-0000-0000000000aa',
+		definitionId: '00000000-0000-0000-0000-0000000000aa',
+		versionId: '00000000-0000-0000-0000-0000000000bb',
+		channel: 'live',
+		orgId: '00000000-0000-0000-0000-0000000000cc',
+		durationMs: 123.5,
+		ok: true,
+		failureKind: 'ok',
+		errorCount: 0,
+		warningCount: 0,
+		...overrides
+	};
+}
+
+export function runSolveMetricSinkConformance(opts: SolveMetricSinkConformanceOptions): void {
+	const { name, createSink, readRows, createFailingSink, cleanup } = opts;
+
+	describe(`ISolveMetricSink conformance: ${name}`, () => {
+		let sink: ISolveMetricSink;
+
+		beforeEach(async () => {
+			sink = await createSink();
+		});
+
+		afterEach(async () => {
+			if (cleanup) await cleanup();
+		});
+
+		it('persists a successful solve with all fields intact', async () => {
+			const metric = baseMetric();
+			await sink.record(sysCtx('user-1'), metric);
+
+			const rows = await readRows();
+			expect(rows).toHaveLength(1);
+			expect(rows[0]).toMatchObject({ ...metric, actorId: 'user-1' });
+		});
+
+		it('records the actor from the RequestContext', async () => {
+			await sink.record(sysCtx('user-xyz'), baseMetric());
+			const rows = await readRows();
+			expect(rows[0].actorId).toBe('user-xyz');
+		});
+
+		it('falls back to "system" when the context has no user id', async () => {
+			await sink.record(sysCtx(''), baseMetric());
+			const rows = await readRows();
+			expect(rows[0].actorId).toBe('system');
+		});
+
+		it('persists a failed solve with its failureKind and zero duration', async () => {
+			await sink.record(
+				sysCtx('user-1'),
+				baseMetric({ ok: false, failureKind: 'timeout', durationMs: 0 })
+			);
+			const rows = await readRows();
+			expect(rows[0]).toMatchObject({ ok: false, failureKind: 'timeout', durationMs: 0 });
+		});
+
+		it('persists error/warning counts on an otherwise-ok solve', async () => {
+			await sink.record(sysCtx('user-1'), baseMetric({ errorCount: 2, warningCount: 5 }));
+			const rows = await readRows();
+			expect(rows[0]).toMatchObject({ ok: true, errorCount: 2, warningCount: 5 });
+		});
+
+		it('persists null definition/version/org for remote-URL solves', async () => {
+			await sink.record(
+				sysCtx('user-1'),
+				baseMetric({
+					definitionUrl: 'https://example.com/def.gh',
+					definitionId: null,
+					versionId: null,
+					orgId: null
+				})
+			);
+			const rows = await readRows();
+			expect(rows[0]).toMatchObject({ definitionId: null, versionId: null, orgId: null });
+		});
+
+		if (createFailingSink) {
+			it('does not throw when the backing write fails', async () => {
+				const failing = await createFailingSink();
+				// The contract: record swallows the failure and resolves.
+				await expect(failing.record(sysCtx('user-1'), baseMetric())).resolves.toBeUndefined();
+			});
+		}
+	});
+}