@zuplo/cli 7.11.0 → 7.11.3

package/node_modules/@hono/node-server/README.md

@@ -224,6 +224,8 @@ app.use('/static/*', serveStatic({ root: './static' }))
 
 Notice that `root` here is not relative to `src/index.ts`, rather to `my-hono-project`.
 
+Only `GET` and `HEAD` requests are served. Requests with other methods are passed to the next middleware.
+
 ### Options
 
 #### `allowPercentInPath`

package/node_modules/@hono/node-server/dist/index.cjs

@@ -846,7 +846,7 @@ const makeCloseHandler = (req, incoming, outgoing, needsBodyCleanup) => () => {
 	if (incoming.errored) {
 		recordBodyBufferedBeforeDisconnect(incoming);
 		req[abortRequest](incoming.errored.toString());
-	} else if (!outgoing.writableFinished) {
+	} else if (!outgoing.writableFinished || incoming instanceof node_http2.Http2ServerRequest && incoming.aborted) {
 		recordBodyBufferedBeforeDisconnect(incoming);
 		req[abortRequest]("Client connection prematurely closed.");
 	}

package/node_modules/@hono/node-server/dist/index.mjs

@@ -845,7 +845,7 @@ const makeCloseHandler = (req, incoming, outgoing, needsBodyCleanup) => () => {
 	if (incoming.errored) {
 		recordBodyBufferedBeforeDisconnect(incoming);
 		req[abortRequest](incoming.errored.toString());
-	} else if (!outgoing.writableFinished) {
+	} else if (!outgoing.writableFinished || incoming instanceof Http2ServerRequest && incoming.aborted) {
 		recordBodyBufferedBeforeDisconnect(incoming);
 		req[abortRequest]("Client connection prematurely closed.");
 	}

package/node_modules/@hono/node-server/dist/serve-static.cjs

@@ -74,6 +74,7 @@ const serveStatic = (options = { root: "" }) => {
 	if (root !== "" && !(0, node_fs.existsSync)(root)) console.error(`serveStatic: root path '${root}' is not found, are you sure it's correct?`);
 	return async (c, next) => {
 		if (c.finalized) return next();
+		if (c.req.method !== "GET" && c.req.method !== "HEAD") return next();
 		let filename;
 		if (optionPath) filename = optionPath;
 		else try {
@@ -115,7 +116,7 @@ const serveStatic = (options = { root: "" }) => {
 		const size = stats.size;
 		const range = c.req.header("range") || "";
 		c.header("Last-Modified", stats.mtime.toUTCString());
-		if (c.req.method == "HEAD" || c.req.method == "OPTIONS") {
+		if (c.req.method === "HEAD") {
 			c.header("Content-Length", size.toString());
 			c.status(200);
 			result = c.body(null);

package/node_modules/@hono/node-server/dist/serve-static.mjs

@@ -73,6 +73,7 @@ const serveStatic = (options = { root: "" }) => {
 	if (root !== "" && !existsSync(root)) console.error(`serveStatic: root path '${root}' is not found, are you sure it's correct?`);
 	return async (c, next) => {
 		if (c.finalized) return next();
+		if (c.req.method !== "GET" && c.req.method !== "HEAD") return next();
 		let filename;
 		if (optionPath) filename = optionPath;
 		else try {
@@ -114,7 +115,7 @@ const serveStatic = (options = { root: "" }) => {
 		const size = stats.size;
 		const range = c.req.header("range") || "";
 		c.header("Last-Modified", stats.mtime.toUTCString());
-		if (c.req.method == "HEAD" || c.req.method == "OPTIONS") {
+		if (c.req.method === "HEAD") {
 			c.header("Content-Length", size.toString());
 			c.status(200);
 			result = c.body(null);

package/node_modules/@hono/node-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hono/node-server",
-  "version": "2.1.4",
+  "version": "2.1.5",
   "description": "Node.js Adapter for Hono",
   "main": "dist/index.mjs",
   "type": "module",

package/node_modules/@posthog/core/dist/metrics/index.d.ts

@@ -14,6 +14,10 @@ import type { MetricsHost, ResolvedPostHogMetricsConfig } from './types';
  * Deliberately unlike logs, no per-user context (distinct ID, session ID) is
  * attached: every attribute value creates a new series, and per-user series
  * are the canonical metrics-cardinality explosion.
+ *
+ * A sample recorded inside a sampled span stamps its series with an exemplar
+ * (trace ID, span ID, value). One per series per window, last sample wins, so a
+ * metric point links to one representative trace at no cardinality cost.
  */
 export declare class PostHogMetrics {
     private readonly _instance;
@@ -46,6 +50,11 @@ export declare class PostHogMetrics {
     /** Clears the flush timer, drops the current window, and invalidates in-flight flushes. */
     reset(): void;
     private _capture;
+    /**
+     * The sampled span a sample is recorded in. An unsampled span is never
+     * exported, so an exemplar pointing at it would link to a missing trace.
+     */
+    private _activeTraceContext;
     /**
      * Cardinality gate for adding a series to the live window — warns once per
      * window when the cap is hit. Applied on capture and on merge-back alike.

package/node_modules/@posthog/core/dist/metrics/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAMpB,kBAAkB,EAEnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AActC,OAAO,KAAK,EAAE,WAAW,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAA;AA2BxE;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IA0BvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IA3B1B,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI3B;IAGD,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO,CAAC,gBAAgB,CAAQ;IAIhC,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,oBAAoB,CAAoB;IAChD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,yBAAyB,CAAI;IACrC,OAAO,CAAC,YAAY,CAAY;IAIhC,OAAO,CAAC,WAAW,CAAI;IAEvB,YACmB,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,MAAM,EAC9B;IAEJ,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAE3E;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAEvE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAE3E;IAED,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAerB;IAED;;;;;;OAMG;IACH,WAAW,IAAI,kBAAkB,GAAG,IAAI,CAUvC;IAED,2FAA2F;IAC3F,KAAK,IAAI,IAAI,CAWZ;IAED,OAAO,CAAC,QAAQ;IAsEhB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,KAAK;IA6Bb,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;YAYT,QAAQ;IAyDtB,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAwDrB,oFAAoF;IACpF,OAAO,CAAC,gBAAgB;CAqCzB;AAED,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AACnH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/metrics/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAOpB,kBAAkB,EAEnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAetC,OAAO,KAAK,EAAE,WAAW,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAA;AAoCxE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IA0BvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IA3B1B,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAI3B;IAGD,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO,CAAC,gBAAgB,CAAQ;IAIhC,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,oBAAoB,CAAoB;IAChD,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,yBAAyB,CAAI;IACrC,OAAO,CAAC,YAAY,CAAY;IAIhC,OAAO,CAAC,WAAW,CAAI;IAEvB,YACmB,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,4BAA4B,EACrC,OAAO,EAAE,MAAM,EAC9B;IAEJ,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAE3E;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAEvE;IAED,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAE3E;IAED,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAerB;IAED;;;;;;OAMG;IACH,WAAW,IAAI,kBAAkB,GAAG,IAAI,CAUvC;IAED,2FAA2F;IAC3F,KAAK,IAAI,IAAI,CAWZ;IAED,OAAO,CAAC,QAAQ;IA0EhB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;OAGG;IACH,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,KAAK;IA6Bb,OAAO,CAAC,cAAc;IAyBtB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,eAAe;YAYT,QAAQ;IAyDtB,OAAO,CAAC,aAAa;IASrB;;;OAGG;IACH,OAAO,CAAC,aAAa;IA4DrB,oFAAoF;IACpF,OAAO,CAAC,gBAAgB;CAuCzB;AAqBD,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAA;AACnH,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAC/C,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA"}

package/node_modules/@posthog/core/dist/metrics/index.js

@@ -39,6 +39,7 @@ const flush_timer_js_namespaceObject = require("../utils/flush-timer.js");
 const retry_after_js_namespaceObject = require("../utils/retry-after.js");
 const backoff_js_namespaceObject = require("../utils/backoff.js");
 const otlp_any_value_js_namespaceObject = require("../utils/otlp-any-value.js");
+const traceparent_js_namespaceObject = require("../traces/traceparent.js");
 const external_metrics_utils_js_namespaceObject = require("./metrics-utils.js");
 const external_config_js_namespaceObject = require("./config.js");
 const OTLP_TEMPORALITY_DELTA = 1;
@@ -157,8 +158,23 @@ class PostHogMetrics {
             this._logger.warn(`Metric name '${filtered.name}' is already used as a ${seenType}; recording it as a ${filtered.type} too will blend both series in charts. Use a distinct name.`);
         }
         this._fold(state, filtered.value);
+        const traceContext = this._activeTraceContext();
+        if (traceContext) state.exemplar = {
+            ...traceContext,
+            value: filtered.value,
+            timeMs: Date.now()
+        };
         this._armFlushTimer();
     }
+    _activeTraceContext() {
+        try {
+            const parsed = (0, traceparent_js_namespaceObject.parseTraceparent)(this._instance.getActiveSpan?.()?.traceparent());
+            if (parsed && parsed.flags === traceparent_js_namespaceObject.TRACE_FLAGS_SAMPLED) return {
+                traceId: parsed.traceId,
+                spanId: parsed.spanId
+            };
+        } catch  {}
+    }
     _admitNewSeries() {
         if (this._series.size < this._config.maxSeriesPerFlush) return true;
         if (!this._seriesCapWarned) {
@@ -288,19 +304,22 @@ class PostHogMetrics {
             }
             const attributes = (0, otlp_any_value_js_namespaceObject.toOtlpKeyValueList)(state.attributes ?? {}, this._logger);
             const startNano = (0, external_metrics_utils_js_namespaceObject.msToUnixNano)(state.windowStartMs);
+            const exemplars = toOtlpExemplars(state.exemplar);
             if ('count' === state.type) {
                 const dp = {
                     attributes,
                     startTimeUnixNano: startNano,
                     timeUnixNano: nowNano,
-                    asDouble: state.total ?? 0
+                    asDouble: state.total ?? 0,
+                    ...exemplars
                 };
                 metric.sum.dataPoints.push(dp);
             } else if ('gauge' === state.type) {
                 const dp = {
                     attributes,
                     timeUnixNano: nowNano,
-                    asDouble: state.last ?? 0
+                    asDouble: state.last ?? 0,
+                    ...exemplars
                 };
                 metric.gauge.dataPoints.push(dp);
             } else if (state.hist) {
@@ -313,7 +332,8 @@ class PostHogMetrics {
                     min: state.hist.min,
                     max: state.hist.max,
                     bucketCounts: state.hist.bucketCounts,
-                    explicitBounds: external_metrics_utils_js_namespaceObject.DEFAULT_HISTOGRAM_BOUNDS
+                    explicitBounds: external_metrics_utils_js_namespaceObject.DEFAULT_HISTOGRAM_BOUNDS,
+                    ...exemplars
                 };
                 metric.histogram.dataPoints.push(dp);
             }
@@ -328,6 +348,7 @@ class PostHogMetrics {
                 continue;
             }
             current.windowStartMs = Math.min(current.windowStartMs, old.windowStartMs);
+            current.exemplar = current.exemplar ?? old.exemplar;
             switch(current.type){
                 case 'count':
                     current.total = (current.total ?? 0) + (old.total ?? 0);
@@ -347,6 +368,20 @@ class PostHogMetrics {
         }
     }
 }
+function toOtlpExemplars(exemplar) {
+    if (!exemplar) return {};
+    return {
+        exemplars: [
+            {
+                filteredAttributes: [],
+                timeUnixNano: (0, external_metrics_utils_js_namespaceObject.msToUnixNano)(exemplar.timeMs),
+                asDouble: exemplar.value,
+                traceId: exemplar.traceId,
+                spanId: exemplar.spanId
+            }
+        ]
+    };
+}
 exports.DEFAULT_HISTOGRAM_BOUNDS = __webpack_exports__.DEFAULT_HISTOGRAM_BOUNDS;
 exports.PostHogMetrics = __webpack_exports__.PostHogMetrics;
 exports.buildMetricsResourceAttributes = __webpack_exports__.buildMetricsResourceAttributes;

package/node_modules/@posthog/core/dist/metrics/index.mjs

@@ -3,6 +3,7 @@ import { FlushTimer } from "../utils/flush-timer.mjs";
 import { RetryAfterWindow } from "../utils/retry-after.mjs";
 import { MAX_FLUSH_BACKOFF_MS, NO_JITTER, backoffDelayMs, drawJitter } from "../utils/backoff.mjs";
 import { toOtlpKeyValueList } from "../utils/otlp-any-value.mjs";
+import { TRACE_FLAGS_SAMPLED, parseTraceparent } from "../traces/traceparent.mjs";
 import { DEFAULT_HISTOGRAM_BOUNDS, bucketIndexFor, buildMetricsResourceAttributes, buildOtlpMetricsPayload, msToUnixNano, seriesKey } from "./metrics-utils.mjs";
 const OTLP_TEMPORALITY_DELTA = 1;
 class PostHogMetrics {
@@ -120,8 +121,23 @@ class PostHogMetrics {
             this._logger.warn(`Metric name '${filtered.name}' is already used as a ${seenType}; recording it as a ${filtered.type} too will blend both series in charts. Use a distinct name.`);
         }
         this._fold(state, filtered.value);
+        const traceContext = this._activeTraceContext();
+        if (traceContext) state.exemplar = {
+            ...traceContext,
+            value: filtered.value,
+            timeMs: Date.now()
+        };
         this._armFlushTimer();
     }
+    _activeTraceContext() {
+        try {
+            const parsed = parseTraceparent(this._instance.getActiveSpan?.()?.traceparent());
+            if (parsed && parsed.flags === TRACE_FLAGS_SAMPLED) return {
+                traceId: parsed.traceId,
+                spanId: parsed.spanId
+            };
+        } catch  {}
+    }
     _admitNewSeries() {
         if (this._series.size < this._config.maxSeriesPerFlush) return true;
         if (!this._seriesCapWarned) {
@@ -251,19 +267,22 @@ class PostHogMetrics {
             }
             const attributes = toOtlpKeyValueList(state.attributes ?? {}, this._logger);
             const startNano = msToUnixNano(state.windowStartMs);
+            const exemplars = toOtlpExemplars(state.exemplar);
             if ('count' === state.type) {
                 const dp = {
                     attributes,
                     startTimeUnixNano: startNano,
                     timeUnixNano: nowNano,
-                    asDouble: state.total ?? 0
+                    asDouble: state.total ?? 0,
+                    ...exemplars
                 };
                 metric.sum.dataPoints.push(dp);
             } else if ('gauge' === state.type) {
                 const dp = {
                     attributes,
                     timeUnixNano: nowNano,
-                    asDouble: state.last ?? 0
+                    asDouble: state.last ?? 0,
+                    ...exemplars
                 };
                 metric.gauge.dataPoints.push(dp);
             } else if (state.hist) {
@@ -276,7 +295,8 @@ class PostHogMetrics {
                     min: state.hist.min,
                     max: state.hist.max,
                     bucketCounts: state.hist.bucketCounts,
-                    explicitBounds: DEFAULT_HISTOGRAM_BOUNDS
+                    explicitBounds: DEFAULT_HISTOGRAM_BOUNDS,
+                    ...exemplars
                 };
                 metric.histogram.dataPoints.push(dp);
             }
@@ -291,6 +311,7 @@ class PostHogMetrics {
                 continue;
             }
             current.windowStartMs = Math.min(current.windowStartMs, old.windowStartMs);
+            current.exemplar = current.exemplar ?? old.exemplar;
             switch(current.type){
                 case 'count':
                     current.total = (current.total ?? 0) + (old.total ?? 0);
@@ -310,5 +331,19 @@ class PostHogMetrics {
         }
     }
 }
+function toOtlpExemplars(exemplar) {
+    if (!exemplar) return {};
+    return {
+        exemplars: [
+            {
+                filteredAttributes: [],
+                timeUnixNano: msToUnixNano(exemplar.timeMs),
+                asDouble: exemplar.value,
+                traceId: exemplar.traceId,
+                spanId: exemplar.spanId
+            }
+        ]
+    };
+}
 export { resolveMetricsConfig } from "./config.mjs";
 export { DEFAULT_HISTOGRAM_BOUNDS, PostHogMetrics, buildMetricsResourceAttributes, buildOtlpMetricsPayload };

package/node_modules/@posthog/core/dist/metrics/types.d.ts

@@ -1,5 +1,5 @@
-export type { MetricAttributeValue, MetricAttributes, MetricType, MetricsConfig, CaptureMetricOptions, MetricSample, BeforeSendMetricFn, Metrics, OtlpNumberDataPoint, OtlpHistogramDataPoint, OtlpMetric, OtlpMetricsPayload, } from '@posthog/types';
-import type { BeforeSendMetricFn, MetricAttributeValue, OtlpMetricsPayload } from '@posthog/types';
+export type { MetricAttributeValue, MetricAttributes, MetricType, MetricsConfig, CaptureMetricOptions, MetricSample, BeforeSendMetricFn, Metrics, OtlpNumberDataPoint, OtlpHistogramDataPoint, OtlpMetric, OtlpMetricsPayload, OtlpExemplar, } from '@posthog/types';
+import type { BeforeSendMetricFn, MetricAttributeValue, OtlpMetricsPayload, Span } from '@posthog/types';
 /** Same tagged outcome shape as `SendLogsBatchOutcome` — one policy for both signals. */
 export type SendMetricsBatchOutcome = {
     kind: 'ok';
@@ -30,6 +30,11 @@ export interface MetricsHost {
     _sendMetricsBatch(payload: OtlpMetricsPayload): Promise<SendMetricsBatchOutcome>;
     getLibraryId(): string;
     getLibraryVersion(): string;
+    /**
+     * The span active where a sample is recorded. A sampled one stamps the
+     * sample's series with an exemplar. Hosts without tracing leave it out.
+     */
+    getActiveSpan?(): Span | null;
 }
 /**
  * Configuration for the metrics feature on `new PostHog(key, { metrics: ... })`.

package/node_modules/@posthog/core/dist/metrics/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAElG,yFAAyF;AACzF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IACE,IAAI,EAAE,WAAW,CAAA;IACjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAErC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAChF,YAAY,IAAI,MAAM,CAAA;IACtB,iBAAiB,IAAI,MAAM,CAAA;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAEzD;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAA;CACvD;AAID,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/metrics/types.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,oBAAoB,EACpB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,OAAO,EACP,mBAAmB,EACnB,sBAAsB,EACtB,UAAU,EACV,kBAAkB,EAClB,YAAY,GACb,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAExG,yFAAyF;AACzF,MAAM,MAAM,uBAAuB,GAC/B;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9D;IACE,IAAI,EAAE,WAAW,CAAA;IACjB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAErC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAChF,YAAY,IAAI,MAAM,CAAA;IACtB,iBAAiB,IAAI,MAAM,CAAA;IAC3B;;;OAGG;IACH,aAAa,CAAC,IAAI,IAAI,GAAG,IAAI,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAEzD;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAE1B;;;OAGG;IACH,UAAU,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAA;CACvD;AAID,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;CAC1B"}

package/node_modules/@posthog/core/dist/traces/ids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/traces/ids.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAe7D;AAiBD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D"}
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/traces/ids.ts"],"names":[],"mappings":"AAoBA;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAe7D;AAiBD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAMD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE7D"}

package/node_modules/@posthog/core/dist/traces/ids.js

@@ -31,8 +31,8 @@ const TRACE_ID_BYTES = 16;
 const SPAN_ID_BYTES = 8;
 const TRACE_ID_HEX = 2 * TRACE_ID_BYTES;
 const SPAN_ID_HEX = 2 * SPAN_ID_BYTES;
-const INVALID_TRACE_ID = '0'.repeat(TRACE_ID_HEX);
-const INVALID_SPAN_ID = '0'.repeat(SPAN_ID_HEX);
+const INVALID_SPAN_ID = '0000000000000000';
+const INVALID_TRACE_ID = INVALID_SPAN_ID + INVALID_SPAN_ID;
 const HEX_RE = /^[0-9a-f]+$/;
 function getRandomBytes(byteLength) {
     const bytes = new Uint8Array(byteLength);

package/node_modules/@posthog/core/dist/traces/ids.mjs

@@ -2,8 +2,8 @@ const TRACE_ID_BYTES = 16;
 const SPAN_ID_BYTES = 8;
 const TRACE_ID_HEX = 2 * TRACE_ID_BYTES;
 const SPAN_ID_HEX = 2 * SPAN_ID_BYTES;
-const INVALID_TRACE_ID = '0'.repeat(TRACE_ID_HEX);
-const INVALID_SPAN_ID = '0'.repeat(SPAN_ID_HEX);
+const INVALID_SPAN_ID = '0000000000000000';
+const INVALID_TRACE_ID = INVALID_SPAN_ID + INVALID_SPAN_ID;
 const HEX_RE = /^[0-9a-f]+$/;
 function getRandomBytes(byteLength) {
     const bytes = new Uint8Array(byteLength);

package/node_modules/@posthog/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/core",
-  "version": "1.58.1",
+  "version": "1.59.0",
   "bugs": {
     "url": "https://github.com/PostHog/posthog-js/issues"
   },
@@ -72,7 +72,7 @@
     }
   },
   "dependencies": {
-    "@posthog/types": "^1.415.3"
+    "@posthog/types": "^1.416.0"
   },
   "devDependencies": {
     "@rslib/core": "0.23.2",

package/node_modules/@posthog/core/src/metrics/index.spec.ts

@@ -203,6 +203,81 @@ describe('PostHogMetrics', () => {
     })
   })
 
+  describe('exemplars', () => {
+    const TRACE_ID = '4bf92f3577b34da6a3ce929d0e0e4736'
+    const SPAN_ID = '00f067aa0ba902b7'
+    const withActiveSpan = (traceparent: string | null): any =>
+      createMockInstance({ getActiveSpan: () => ({ traceparent: () => traceparent }) })
+
+    const dataPoints = (instance: any): any[] =>
+      sentMetrics(instance).map((m) => (m.sum ?? m.gauge ?? m.histogram)!.dataPoints[0])
+
+    it('stamps every metric type with the last sample recorded inside a sampled span', async () => {
+      const instance = withActiveSpan(`00-${TRACE_ID}-${SPAN_ID}-01`)
+      const metrics = createMetrics(undefined, instance)
+      metrics.count('c', 1)
+      metrics.count('c', 4)
+      metrics.gauge('g', 7)
+      metrics.histogram('h', 12)
+      await metrics.flush()
+
+      const points = dataPoints(instance)
+      expect(points.map((p) => p.exemplars)).toEqual(
+        [4, 7, 12].map((value) => [
+          {
+            filteredAttributes: [],
+            timeUnixNano: expect.stringMatching(/^\d+$/),
+            asDouble: value,
+            traceId: TRACE_ID,
+            spanId: SPAN_ID,
+          },
+        ])
+      )
+    })
+
+    it.each([
+      ['no getActiveSpan on the host', createMockInstance],
+      ['no active span', () => createMockInstance({ getActiveSpan: () => null })],
+      ['an unsampled span', () => withActiveSpan(`00-${TRACE_ID}-${SPAN_ID}-00`)],
+      ['a span with no traceparent', () => withActiveSpan(null)],
+      [
+        'a throwing host',
+        () =>
+          createMockInstance({
+            getActiveSpan: () => {
+              throw new Error('boom')
+            },
+          }),
+      ],
+    ])('records the sample without an exemplar for %s', async (_, makeInstance) => {
+      const instance = makeInstance()
+      const metrics = createMetrics(undefined, instance)
+      metrics.count('c', 2)
+      await metrics.flush()
+
+      const [point] = dataPoints(instance)
+      expect(point.asDouble).toBe(2)
+      expect(point).not.toHaveProperty('exemplars')
+    })
+
+    it('keeps the exemplar of a window merged back after a failed flush', async () => {
+      const instance = withActiveSpan(`00-${TRACE_ID}-${SPAN_ID}-01`)
+      instance._sendMetricsBatch
+        .mockResolvedValueOnce({ kind: 'retry-later', error: new Error('503') })
+        .mockResolvedValue({ kind: 'ok' })
+      const metrics = createMetrics(undefined, instance)
+      metrics.count('c', 1)
+      await metrics.flush()
+      instance.getActiveSpan = () => null
+      metrics.count('c', 2)
+      await metrics.flush()
+
+      const point = dataPoints(instance)[1]
+      expect(point.asDouble).toBe(3)
+      expect(point.exemplars[0]).toMatchObject({ traceId: TRACE_ID, spanId: SPAN_ID, asDouble: 1 })
+    })
+  })
+
   describe('resource attributes', () => {
     it('attaches service.name, sdk identity, and user resource attributes', async () => {
       const metrics = createMetrics({

package/node_modules/@posthog/core/src/metrics/index.ts

@@ -3,6 +3,7 @@ import type {
   MetricAttributes,
   MetricSample,
   MetricType,
+  OtlpExemplar,
   OtlpHistogramDataPoint,
   OtlpMetric,
   OtlpMetricsPayload,
@@ -14,6 +15,7 @@ import { FlushTimer } from '../utils/flush-timer'
 import { RetryAfterWindow } from '../utils/retry-after'
 import { MAX_FLUSH_BACKOFF_MS, NO_JITTER, backoffDelayMs, drawJitter } from '../utils/backoff'
 import { toOtlpKeyValueList } from '../utils/otlp-any-value'
+import { TRACE_FLAGS_SAMPLED, parseTraceparent } from '../traces/traceparent'
 import {
   DEFAULT_HISTOGRAM_BOUNDS,
   bucketIndexFor,
@@ -26,6 +28,13 @@ import type { MetricsHost, ResolvedPostHogMetricsConfig } from './types'
 
 const OTLP_TEMPORALITY_DELTA = 1
 
+interface ExemplarState {
+  traceId: string
+  spanId: string
+  value: number
+  timeMs: number
+}
+
 interface HistogramState {
   count: number
   sum: number
@@ -47,6 +56,8 @@ interface SeriesState {
   total?: number
   last?: number
   hist?: HistogramState
+  /** The last sample recorded inside a sampled span this window. */
+  exemplar?: ExemplarState
 }
 
 /**
@@ -62,6 +73,10 @@ interface SeriesState {
  * Deliberately unlike logs, no per-user context (distinct ID, session ID) is
  * attached: every attribute value creates a new series, and per-user series
  * are the canonical metrics-cardinality explosion.
+ *
+ * A sample recorded inside a sampled span stamps its series with an exemplar
+ * (trace ID, span ID, value). One per series per window, last sample wins, so a
+ * metric point links to one representative trace at no cardinality cost.
  */
 export class PostHogMetrics {
   private _series = new Map<string, SeriesState>()
@@ -224,9 +239,29 @@ export class PostHogMetrics {
     }
 
     this._fold(state, filtered.value)
+    const traceContext = this._activeTraceContext()
+    if (traceContext) {
+      state.exemplar = { ...traceContext, value: filtered.value, timeMs: Date.now() }
+    }
     this._armFlushTimer()
   }
 
+  /**
+   * The sampled span a sample is recorded in. An unsampled span is never
+   * exported, so an exemplar pointing at it would link to a missing trace.
+   */
+  private _activeTraceContext(): { traceId: string; spanId: string } | undefined {
+    try {
+      const parsed = parseTraceparent(this._instance.getActiveSpan?.()?.traceparent())
+      if (parsed && parsed.flags === TRACE_FLAGS_SAMPLED) {
+        return { traceId: parsed.traceId, spanId: parsed.spanId }
+      }
+    } catch {
+      // A throwing host never costs the sample itself.
+    }
+    return undefined
+  }
+
   /**
    * Cardinality gate for adding a series to the live window — warns once per
    * window when the cap is hit. Applied on capture and on merge-back alike.
@@ -413,6 +448,7 @@ export class PostHogMetrics {
 
       const attributes = toOtlpKeyValueList(state.attributes ?? {}, this._logger)
       const startNano = msToUnixNano(state.windowStartMs)
+      const exemplars = toOtlpExemplars(state.exemplar)
 
       if (state.type === 'count') {
         const dp: OtlpNumberDataPoint = {
@@ -420,6 +456,7 @@ export class PostHogMetrics {
           startTimeUnixNano: startNano,
           timeUnixNano: nowNano,
           asDouble: state.total ?? 0,
+          ...exemplars,
         }
         metric.sum!.dataPoints.push(dp)
       } else if (state.type === 'gauge') {
@@ -427,6 +464,7 @@ export class PostHogMetrics {
           attributes,
           timeUnixNano: nowNano,
           asDouble: state.last ?? 0,
+          ...exemplars,
         }
         metric.gauge!.dataPoints.push(dp)
       } else if (state.hist) {
@@ -440,6 +478,7 @@ export class PostHogMetrics {
           max: state.hist.max,
           bucketCounts: state.hist.bucketCounts,
           explicitBounds: DEFAULT_HISTOGRAM_BOUNDS,
+          ...exemplars,
         }
         metric.histogram!.dataPoints.push(dp)
       }
@@ -461,6 +500,8 @@ export class PostHogMetrics {
         continue
       }
       current.windowStartMs = Math.min(current.windowStartMs, old.windowStartMs)
+      // The live window's exemplar is newer; the old one only fills a gap.
+      current.exemplar = current.exemplar ?? old.exemplar
       switch (current.type) {
         case 'count':
           current.total = (current.total ?? 0) + (old.total ?? 0)
@@ -488,6 +529,25 @@ export class PostHogMetrics {
   }
 }
 
+// Spread into the data point, so a point without an exemplar keeps its exact
+// pre-exemplar wire shape.
+function toOtlpExemplars(exemplar: ExemplarState | undefined): { exemplars?: OtlpExemplar[] } {
+  if (!exemplar) {
+    return {}
+  }
+  return {
+    exemplars: [
+      {
+        filteredAttributes: [],
+        timeUnixNano: msToUnixNano(exemplar.timeMs),
+        asDouble: exemplar.value,
+        traceId: exemplar.traceId,
+        spanId: exemplar.spanId,
+      },
+    ],
+  }
+}
+
 export { buildOtlpMetricsPayload, buildMetricsResourceAttributes, DEFAULT_HISTOGRAM_BOUNDS } from './metrics-utils'
 export { resolveMetricsConfig } from './config'
 export type { MetricsHost, PostHogMetricsConfig, ResolvedPostHogMetricsConfig, SendMetricsBatchOutcome } from './types'

package/node_modules/@posthog/core/src/metrics/types.ts

@@ -13,9 +13,10 @@ export type {
   OtlpHistogramDataPoint,
   OtlpMetric,
   OtlpMetricsPayload,
+  OtlpExemplar,
 } from '@posthog/types'
 
-import type { BeforeSendMetricFn, MetricAttributeValue, OtlpMetricsPayload } from '@posthog/types'
+import type { BeforeSendMetricFn, MetricAttributeValue, OtlpMetricsPayload, Span } from '@posthog/types'
 
 /** Same tagged outcome shape as `SendLogsBatchOutcome` — one policy for both signals. */
 export type SendMetricsBatchOutcome =
@@ -43,6 +44,11 @@ export interface MetricsHost {
   _sendMetricsBatch(payload: OtlpMetricsPayload): Promise<SendMetricsBatchOutcome>
   getLibraryId(): string
   getLibraryVersion(): string
+  /**
+   * The span active where a sample is recorded. A sampled one stamps the
+   * sample's series with an exemplar. Hosts without tracing leave it out.
+   */
+  getActiveSpan?(): Span | null
 }
 
 /**

package/node_modules/@posthog/core/src/traces/ids.ts

@@ -9,8 +9,10 @@ const SPAN_ID_BYTES = 8
 const TRACE_ID_HEX = TRACE_ID_BYTES * 2
 const SPAN_ID_HEX = SPAN_ID_BYTES * 2
 
-const INVALID_TRACE_ID = '0'.repeat(TRACE_ID_HEX)
-const INVALID_SPAN_ID = '0'.repeat(SPAN_ID_HEX)
+// Spelled out rather than `'0'.repeat(...)`: this runs at module load and the
+// browser bundle, which reaches it through metrics, still loads in IE11.
+const INVALID_SPAN_ID = '0000000000000000'
+const INVALID_TRACE_ID = INVALID_SPAN_ID + INVALID_SPAN_ID
 
 const HEX_RE = /^[0-9a-f]+$/