margin-ts 0.6.0 → 0.6.2

package/dist/adapters/express.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Express middleware adapter for margin.
+ *
+ * Tracks per-route health: latency, error rate, request rate.
+ * Exposes /margin/health endpoint with typed classifications.
+ *
+ * Usage:
+ *   import express from 'express';
+ *   import { marginMiddleware, marginHealthRoute } from 'margin-ts/adapters/express';
+ *
+ *   const app = express();
+ *   app.use(marginMiddleware());
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Zero dependencies beyond margin-ts core (express types are optional).
+ */
+import { Thresholds } from '../index.js';
+interface RouteMetrics {
+    route: string;
+    totalRequests: number;
+    totalErrors: number;
+    total4xx: number;
+    latencies: number[];
+    timestamps: Date[];
+    maxWindow: number;
+}
+export interface EndpointThresholds {
+    p50Latency: Thresholds;
+    p99Latency: Thresholds;
+    errorRate: Thresholds;
+    requestRate: Thresholds;
+}
+export declare const DEFAULT_THRESHOLDS: EndpointThresholds;
+export interface MarginMiddlewareOptions {
+    /** Track per-route or aggregate only (default: true) */
+    perRoute?: boolean;
+    /** Max latency samples to keep per route (default: 200) */
+    window?: number;
+    /** Custom thresholds */
+    thresholds?: EndpointThresholds;
+    /** Routes to ignore (e.g. ['/margin/health', '/favicon.ico']) */
+    ignore?: string[];
+    /** Normalize route paths: replace numeric segments with :id (default: true) */
+    normalizePaths?: boolean;
+}
+/** The shared state object — accessible for custom endpoints */
+export interface MarginState {
+    routes: Map<string, RouteMetrics>;
+    aggregate: RouteMetrics;
+    options: Required<MarginMiddlewareOptions>;
+}
+/**
+ * Express middleware that tracks request latency and error rates.
+ *
+ * Attach to your app before routes:
+ *   app.use(marginMiddleware());
+ */
+export declare function marginMiddleware(options?: MarginMiddlewareOptions): any;
+export interface HealthResponse {
+    status: string;
+    expression: string;
+    aggregate: Record<string, unknown>;
+    routes?: Record<string, Record<string, unknown>>;
+    drift?: Record<string, unknown>;
+}
+/**
+ * Express route handler for /margin/health.
+ *
+ * Returns typed health classification for all tracked routes.
+ *
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Or pass the middleware directly:
+ *   const mw = marginMiddleware();
+ *   app.use(mw);
+ *   app.get('/margin/health', marginHealthRoute(mw));
+ */
+export declare function marginHealthRoute(middleware?: any): any;
+export {};
+//# sourceMappingURL=express.d.ts.map

package/dist/adapters/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/adapters/express.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAGL,UAAU,EAcX,MAAM,aAAa,CAAC;AAMrB,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,IAAI,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AA8BD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;IACtB,WAAW,EAAE,UAAU,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,kBAKhC,CAAC;AAmFF,MAAM,WAAW,uBAAuB;IACtC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB;IACxB,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAClC,SAAS,EAAE,YAAY,CAAC;IACxB,OAAO,EAAE,QAAQ,CAAC,uBAAuB,CAAC,CAAC;CAC5C;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,GAAG,CAoD3E;AAMD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,CA4DvD"}

package/dist/adapters/express.js

@@ -0,0 +1,237 @@
+"use strict";
+/**
+ * Express middleware adapter for margin.
+ *
+ * Tracks per-route health: latency, error rate, request rate.
+ * Exposes /margin/health endpoint with typed classifications.
+ *
+ * Usage:
+ *   import express from 'express';
+ *   import { marginMiddleware, marginHealthRoute } from 'margin-ts/adapters/express';
+ *
+ *   const app = express();
+ *   app.use(marginMiddleware());
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Zero dependencies beyond margin-ts core (express types are optional).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_THRESHOLDS = void 0;
+exports.marginMiddleware = marginMiddleware;
+exports.marginHealthRoute = marginHealthRoute;
+const index_js_1 = require("../index.js");
+function createRouteMetrics(route, maxWindow = 200) {
+    return {
+        route,
+        totalRequests: 0,
+        totalErrors: 0,
+        total4xx: 0,
+        latencies: [],
+        timestamps: [],
+        maxWindow,
+    };
+}
+function recordRequest(rm, latencyMs, statusCode) {
+    rm.totalRequests++;
+    if (statusCode >= 500)
+        rm.totalErrors++;
+    if (statusCode >= 400 && statusCode < 500)
+        rm.total4xx++;
+    rm.latencies.push(latencyMs);
+    rm.timestamps.push(new Date());
+    if (rm.latencies.length > rm.maxWindow) {
+        rm.latencies.shift();
+        rm.timestamps.shift();
+    }
+}
+exports.DEFAULT_THRESHOLDS = {
+    p50Latency: (0, index_js_1.createThresholds)(100, 500, false), // ms, lower is better
+    p99Latency: (0, index_js_1.createThresholds)(500, 2000, false), // ms, lower is better
+    errorRate: (0, index_js_1.createThresholds)(0.01, 0.10, false), // ratio, lower is better
+    requestRate: (0, index_js_1.createThresholds)(1.0, 0.1, true), // req/s, higher is better
+};
+// -----------------------------------------------------------------------
+// Metrics → Observations
+// -----------------------------------------------------------------------
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.ceil(sorted.length * p) - 1;
+    return sorted[Math.max(0, Math.min(idx, sorted.length - 1))];
+}
+function classifyRoute(rm, thresholds, now) {
+    if (rm.latencies.length < 3)
+        return [];
+    const sorted = [...rm.latencies].sort((a, b) => a - b);
+    const p50 = percentile(sorted, 0.5);
+    const p99 = percentile(sorted, 0.99);
+    const errorRate = rm.totalRequests > 0 ? rm.totalErrors / rm.totalRequests : 0;
+    // Request rate: requests in window / window duration
+    let requestRate = 0;
+    if (rm.timestamps.length >= 2) {
+        const windowMs = rm.timestamps[rm.timestamps.length - 1].getTime() - rm.timestamps[0].getTime();
+        if (windowMs > 0)
+            requestRate = (rm.timestamps.length / windowMs) * 1000;
+    }
+    const prefix = rm.route === '*' ? '' : `${rm.route}:`;
+    const observations = [
+        {
+            name: `${prefix}p50_latency`,
+            health: (0, index_js_1.classify)(p50, index_js_1.Confidence.HIGH, thresholds.p50Latency),
+            value: p50,
+            baseline: thresholds.p50Latency.intact,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: `${prefix}p99_latency`,
+            health: (0, index_js_1.classify)(p99, index_js_1.Confidence.HIGH, thresholds.p99Latency),
+            value: p99,
+            baseline: thresholds.p99Latency.intact,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: `${prefix}error_rate`,
+            health: (0, index_js_1.classify)(errorRate, index_js_1.Confidence.HIGH, thresholds.errorRate),
+            value: errorRate,
+            baseline: 0.001,
+            confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false,
+            provenance: [],
+            measuredAt: now,
+        },
+        {
+            name: `${prefix}request_rate`,
+            health: (0, index_js_1.classify)(requestRate, index_js_1.Confidence.MODERATE, thresholds.requestRate),
+            value: requestRate,
+            baseline: 10.0,
+            confidence: index_js_1.Confidence.MODERATE,
+            higherIsBetter: true,
+            provenance: [],
+            measuredAt: now,
+        },
+    ];
+    return observations;
+}
+function normalizePath(path) {
+    return path.replace(/\/\d+/g, '/:id').replace(/\/[0-9a-f]{24}/g, '/:id');
+}
+/**
+ * Express middleware that tracks request latency and error rates.
+ *
+ * Attach to your app before routes:
+ *   app.use(marginMiddleware());
+ */
+function marginMiddleware(options = {}) {
+    const opts = {
+        perRoute: options.perRoute ?? true,
+        window: options.window ?? 200,
+        thresholds: options.thresholds ?? exports.DEFAULT_THRESHOLDS,
+        ignore: options.ignore ?? ['/margin/health', '/favicon.ico'],
+        normalizePaths: options.normalizePaths ?? true,
+    };
+    const state = {
+        routes: new Map(),
+        aggregate: createRouteMetrics('*', opts.window),
+        options: opts,
+    };
+    const middleware = (req, res, next) => {
+        const path = req.path || req.url || '/';
+        if (opts.ignore.includes(path)) {
+            next();
+            return;
+        }
+        const start = Date.now();
+        // Hook into response finish
+        const onFinish = () => {
+            res.removeListener('finish', onFinish);
+            const latency = Date.now() - start;
+            const status = res.statusCode || 200;
+            // Aggregate
+            recordRequest(state.aggregate, latency, status);
+            // Per-route
+            if (opts.perRoute) {
+                const route = opts.normalizePaths ? normalizePath(path) : path;
+                if (!state.routes.has(route)) {
+                    state.routes.set(route, createRouteMetrics(route, opts.window));
+                }
+                recordRequest(state.routes.get(route), latency, status);
+            }
+        };
+        res.on('finish', onFinish);
+        next();
+    };
+    // Attach state to middleware for access by health route
+    middleware.__marginState = state;
+    return middleware;
+}
+/**
+ * Express route handler for /margin/health.
+ *
+ * Returns typed health classification for all tracked routes.
+ *
+ *   app.get('/margin/health', marginHealthRoute());
+ *
+ * Or pass the middleware directly:
+ *   const mw = marginMiddleware();
+ *   app.use(mw);
+ *   app.get('/margin/health', marginHealthRoute(mw));
+ */
+function marginHealthRoute(middleware) {
+    return (req, res) => {
+        // Find state from middleware
+        let state;
+        if (middleware && middleware.__marginState) {
+            state = middleware.__marginState;
+        }
+        else if (req.app) {
+            // Walk through app middleware stack to find ours
+            const stack = req.app._router?.stack || [];
+            for (const layer of stack) {
+                if (layer.handle?.__marginState) {
+                    state = layer.handle.__marginState;
+                    break;
+                }
+            }
+        }
+        if (!state) {
+            res.status(500).json({ error: 'margin middleware not found' });
+            return;
+        }
+        const now = new Date();
+        const thresholds = state.options.thresholds;
+        // Aggregate health
+        const aggObs = classifyRoute(state.aggregate, thresholds, now);
+        const aggExpr = (0, index_js_1.createExpression)(aggObs, [], 'aggregate');
+        // Determine overall status
+        const SEVERITY_MAP = {
+            [index_js_1.Health.INTACT]: 0, [index_js_1.Health.RECOVERING]: 1, [index_js_1.Health.DEGRADED]: 2,
+            [index_js_1.Health.ABLATED]: 3, [index_js_1.Health.OOD]: 4,
+        };
+        const worstHealth = aggObs.reduce((worst, o) => SEVERITY_MAP[o.health] > SEVERITY_MAP[worst] ? o.health : worst, index_js_1.Health.INTACT);
+        const response = {
+            status: worstHealth,
+            expression: (0, index_js_1.expressionToString)(aggExpr),
+            aggregate: (0, index_js_1.expressionToDict)(aggExpr),
+        };
+        // Per-route health
+        if (state.options.perRoute && state.routes.size > 0) {
+            const routes = {};
+            for (const [route, metrics] of state.routes) {
+                const obs = classifyRoute(metrics, thresholds, now);
+                if (obs.length > 0) {
+                    const expr = (0, index_js_1.createExpression)(obs, [], route);
+                    routes[route] = (0, index_js_1.expressionToDict)(expr);
+                }
+            }
+            response.routes = routes;
+        }
+        res.json(response);
+    };
+}
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

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

package/dist/adapters/nextjs.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Next.js API route adapter for margin.
+ *
+ * One-liner health tracking for any API route:
+ *
+ *   // pages/api/users.ts (Pages Router)
+ *   import { withMargin } from 'margin-ts/adapters/nextjs';
+ *   export default withMargin(handler);
+ *
+ *   // app/api/users/route.ts (App Router)
+ *   import { withMarginApp } from 'margin-ts/adapters/nextjs';
+ *   export const GET = withMarginApp(handler);
+ *
+ *   // Health endpoint
+ *   // pages/api/margin/health.ts
+ *   import { marginHealthHandler } from 'margin-ts/adapters/nextjs';
+ *   export default marginHealthHandler();
+ *
+ * Tracks latency, error rate, and request count per route.
+ * Zero dependencies beyond margin-ts core.
+ */
+import { Thresholds } from '../index.js';
+export interface NextjsThresholds {
+    p50Latency: Thresholds;
+    p99Latency: Thresholds;
+    errorRate: Thresholds;
+}
+export declare const DEFAULT_NEXTJS_THRESHOLDS: NextjsThresholds;
+export interface WithMarginOptions {
+    route?: string;
+    thresholds?: NextjsThresholds;
+}
+/**
+ * Wrap a Pages Router API handler with margin health tracking.
+ *
+ *   export default withMargin(handler);
+ *   export default withMargin(handler, { route: '/api/users' });
+ */
+export declare function withMargin(handler: (req: any, res: any) => any, options?: WithMarginOptions): (req: any, res: any) => any;
+/**
+ * Wrap an App Router handler with margin health tracking.
+ *
+ *   export const GET = withMarginApp(handler);
+ *   export const POST = withMarginApp(handler, { route: '/api/users' });
+ */
+export declare function withMarginApp(handler: (req: any) => any, options?: WithMarginOptions): (req: any) => any;
+/**
+ * Pages Router: health endpoint handler.
+ *
+ *   // pages/api/margin/health.ts
+ *   import { marginHealthHandler } from 'margin-ts/adapters/nextjs';
+ *   export default marginHealthHandler();
+ */
+export declare function marginHealthHandler(thresholds?: NextjsThresholds): (req: any, res: any) => void;
+/**
+ * App Router: health endpoint handler.
+ *
+ *   // app/api/margin/health/route.ts
+ *   import { marginHealthAppHandler } from 'margin-ts/adapters/nextjs';
+ *   export const GET = marginHealthAppHandler();
+ */
+export declare function marginHealthAppHandler(thresholds?: NextjsThresholds): (req: any) => any;
+/** Clear all tracked routes (for testing). */
+export declare function resetRoutes(): void;
+//# sourceMappingURL=nextjs.d.ts.map

package/dist/adapters/nextjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../../src/adapters/nextjs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,UAAU,EAOX,MAAM,aAAa,CAAC;AAwCrB,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAIvC,CAAC;AA8CF,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,GAAG,EACpC,OAAO,GAAE,iBAAsB,GAC9B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,GAAG,CAiB7B;AAMD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,EAC1B,OAAO,GAAE,iBAAsB,GAC9B,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAiBnB;AAMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAkC/F;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,CAAC,EAAE,gBAAgB,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAqCvF;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,IAAI,IAAI,CAElC"}

package/dist/adapters/nextjs.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Next.js API route adapter for margin.
+ *
+ * One-liner health tracking for any API route:
+ *
+ *   // pages/api/users.ts (Pages Router)
+ *   import { withMargin } from 'margin-ts/adapters/nextjs';
+ *   export default withMargin(handler);
+ *
+ *   // app/api/users/route.ts (App Router)
+ *   import { withMarginApp } from 'margin-ts/adapters/nextjs';
+ *   export const GET = withMarginApp(handler);
+ *
+ *   // Health endpoint
+ *   // pages/api/margin/health.ts
+ *   import { marginHealthHandler } from 'margin-ts/adapters/nextjs';
+ *   export default marginHealthHandler();
+ *
+ * Tracks latency, error rate, and request count per route.
+ * Zero dependencies beyond margin-ts core.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_NEXTJS_THRESHOLDS = void 0;
+exports.withMargin = withMargin;
+exports.withMarginApp = withMarginApp;
+exports.marginHealthHandler = marginHealthHandler;
+exports.marginHealthAppHandler = marginHealthAppHandler;
+exports.resetRoutes = resetRoutes;
+const index_js_1 = require("../index.js");
+const _routes = new Map();
+const _MAX_WINDOW = 200;
+function getOrCreateRoute(route) {
+    if (!_routes.has(route)) {
+        _routes.set(route, {
+            totalRequests: 0,
+            totalErrors: 0,
+            latencies: [],
+            maxWindow: _MAX_WINDOW,
+        });
+    }
+    return _routes.get(route);
+}
+function record(route, latencyMs, isError) {
+    const stats = getOrCreateRoute(route);
+    stats.totalRequests++;
+    if (isError)
+        stats.totalErrors++;
+    stats.latencies.push(latencyMs);
+    if (stats.latencies.length > stats.maxWindow)
+        stats.latencies.shift();
+}
+exports.DEFAULT_NEXTJS_THRESHOLDS = {
+    p50Latency: (0, index_js_1.createThresholds)(100, 500, false),
+    p99Latency: (0, index_js_1.createThresholds)(500, 2000, false),
+    errorRate: (0, index_js_1.createThresholds)(0.01, 0.10, false),
+};
+// -----------------------------------------------------------------------
+// Classification
+// -----------------------------------------------------------------------
+function percentile(sorted, p) {
+    if (sorted.length === 0)
+        return 0;
+    const idx = Math.ceil(sorted.length * p) - 1;
+    return sorted[Math.max(0, Math.min(idx, sorted.length - 1))];
+}
+function classifyRoute(route, stats, thresholds) {
+    if (stats.latencies.length < 3)
+        return null;
+    const sorted = [...stats.latencies].sort((a, b) => a - b);
+    const p50 = percentile(sorted, 0.5);
+    const p99 = percentile(sorted, 0.99);
+    const errorRate = stats.totalRequests > 0 ? stats.totalErrors / stats.totalRequests : 0;
+    const now = new Date();
+    const observations = [
+        {
+            name: `${route}:p50`, health: (0, index_js_1.classify)(p50, index_js_1.Confidence.HIGH, thresholds.p50Latency),
+            value: p50, baseline: thresholds.p50Latency.intact, confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false, provenance: [], measuredAt: now,
+        },
+        {
+            name: `${route}:p99`, health: (0, index_js_1.classify)(p99, index_js_1.Confidence.HIGH, thresholds.p99Latency),
+            value: p99, baseline: thresholds.p99Latency.intact, confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false, provenance: [], measuredAt: now,
+        },
+        {
+            name: `${route}:errors`, health: (0, index_js_1.classify)(errorRate, index_js_1.Confidence.HIGH, thresholds.errorRate),
+            value: errorRate, baseline: 0.001, confidence: index_js_1.Confidence.HIGH,
+            higherIsBetter: false, provenance: [], measuredAt: now,
+        },
+    ];
+    return (0, index_js_1.createExpression)(observations, [], route);
+}
+/**
+ * Wrap a Pages Router API handler with margin health tracking.
+ *
+ *   export default withMargin(handler);
+ *   export default withMargin(handler, { route: '/api/users' });
+ */
+function withMargin(handler, options = {}) {
+    return async (req, res) => {
+        const route = options.route || req.url || '/api/unknown';
+        const start = Date.now();
+        try {
+            const result = await handler(req, res);
+            const latency = Date.now() - start;
+            const status = res.statusCode || 200;
+            record(route, latency, status >= 500);
+            return result;
+        }
+        catch (err) {
+            const latency = Date.now() - start;
+            record(route, latency, true);
+            throw err;
+        }
+    };
+}
+// -----------------------------------------------------------------------
+// App Router wrapper
+// -----------------------------------------------------------------------
+/**
+ * Wrap an App Router handler with margin health tracking.
+ *
+ *   export const GET = withMarginApp(handler);
+ *   export const POST = withMarginApp(handler, { route: '/api/users' });
+ */
+function withMarginApp(handler, options = {}) {
+    return async (req) => {
+        const route = options.route || new URL(req.url || '/', 'http://localhost').pathname;
+        const start = Date.now();
+        try {
+            const response = await handler(req);
+            const latency = Date.now() - start;
+            const status = response?.status || 200;
+            record(route, latency, status >= 500);
+            return response;
+        }
+        catch (err) {
+            const latency = Date.now() - start;
+            record(route, latency, true);
+            throw err;
+        }
+    };
+}
+// -----------------------------------------------------------------------
+// Health endpoint
+// -----------------------------------------------------------------------
+/**
+ * Pages Router: health endpoint handler.
+ *
+ *   // pages/api/margin/health.ts
+ *   import { marginHealthHandler } from 'margin-ts/adapters/nextjs';
+ *   export default marginHealthHandler();
+ */
+function marginHealthHandler(thresholds) {
+    const t = thresholds || exports.DEFAULT_NEXTJS_THRESHOLDS;
+    return (_req, res) => {
+        const routeHealth = {};
+        let worstOverall = index_js_1.Health.INTACT;
+        const SEVERITY = {
+            [index_js_1.Health.INTACT]: 0, [index_js_1.Health.RECOVERING]: 1, [index_js_1.Health.DEGRADED]: 2,
+            [index_js_1.Health.ABLATED]: 3, [index_js_1.Health.OOD]: 4,
+        };
+        for (const [route, stats] of _routes) {
+            const expr = classifyRoute(route, stats, t);
+            if (expr) {
+                routeHealth[route] = {
+                    expression: (0, index_js_1.expressionToString)(expr),
+                    ...(0, index_js_1.expressionToDict)(expr),
+                    requests: stats.totalRequests,
+                    errors: stats.totalErrors,
+                };
+                for (const obs of expr.observations) {
+                    if (SEVERITY[obs.health] > SEVERITY[worstOverall]) {
+                        worstOverall = obs.health;
+                    }
+                }
+            }
+        }
+        res.status(200).json({
+            status: worstOverall,
+            routes: routeHealth,
+            totalRoutes: _routes.size,
+        });
+    };
+}
+/**
+ * App Router: health endpoint handler.
+ *
+ *   // app/api/margin/health/route.ts
+ *   import { marginHealthAppHandler } from 'margin-ts/adapters/nextjs';
+ *   export const GET = marginHealthAppHandler();
+ */
+function marginHealthAppHandler(thresholds) {
+    const t = thresholds || exports.DEFAULT_NEXTJS_THRESHOLDS;
+    return (_req) => {
+        const routeHealth = {};
+        let worstOverall = index_js_1.Health.INTACT;
+        const SEVERITY = {
+            [index_js_1.Health.INTACT]: 0, [index_js_1.Health.RECOVERING]: 1, [index_js_1.Health.DEGRADED]: 2,
+            [index_js_1.Health.ABLATED]: 3, [index_js_1.Health.OOD]: 4,
+        };
+        for (const [route, stats] of _routes) {
+            const expr = classifyRoute(route, stats, t);
+            if (expr) {
+                routeHealth[route] = {
+                    expression: (0, index_js_1.expressionToString)(expr),
+                    ...(0, index_js_1.expressionToDict)(expr),
+                    requests: stats.totalRequests,
+                    errors: stats.totalErrors,
+                };
+                for (const obs of expr.observations) {
+                    if (SEVERITY[obs.health] > SEVERITY[worstOverall]) {
+                        worstOverall = obs.health;
+                    }
+                }
+            }
+        }
+        return new Response(JSON.stringify({
+            status: worstOverall,
+            routes: routeHealth,
+            totalRoutes: _routes.size,
+        }), {
+            status: 200,
+            headers: { 'Content-Type': 'application/json' },
+        });
+    };
+}
+/** Clear all tracked routes (for testing). */
+function resetRoutes() {
+    _routes.clear();
+}
+//# sourceMappingURL=nextjs.js.map

package/dist/adapters/nextjs.js.map

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