apps 0.0.1-beta.60 → 0.0.1-beta.62

package/types/telemetry/src/index.d.ts

@@ -7,4 +7,4 @@ export { TraceContext, currentTraceContext, externalTrace, traceLinks } from "./
 export { pendingSpan } from "./pending-span.js";
 export { makeOwnershipAccounting, measuredSpan, owned, ownedBy, ownerAttribute, type Owner, type SpanMeasure, } from "./ownership.js";
 export { recordWorkerMeasurements } from "./measurements.js";
-export { allowlistedSpans, httpSpanAttributeAllowlist, spanAttributeAllowed, } from "./span-attributes.js";
+export { allowlistedSpans, httpSpanAttributeAllowlist, recordRoute, routeTemplates, spanAttributeAllowed, } from "./span-attributes.js";

package/types/telemetry/src/span-attributes.d.ts

@@ -18,11 +18,27 @@
  *
  * Attributes outside these namespaces are the product's own and pass through.
  */
-import { Layer } from "effect";
+import { Effect, Layer } from "effect";
 /** Every HTTP attribute an exported span may carry. */
 export declare const httpSpanAttributeAllowlist: ReadonlySet<string>;
 /** Record this attribute? HTTP names must be allowlisted; product names pass through. */
 export declare const spanAttributeAllowed: (key: string) => boolean;
+/**
+ * Record the template of a route whose path an app or its caller chose, in place of the router's
+ * wildcard: an app's own page or asset, or an app's outbound request. Its last parameter stands
+ * for the rest of the path. It annotates the current span, so call it from the request's handler.
+ */
+export declare const recordRoute: (template: `/${string}`) => Effect.Effect<void, never, never>;
+/**
+ * A fixed set of endpoint templates served under one wildcard route, such as Better Auth's
+ * endpoints under `/api/auth/*`. `:name` stands for one segment. `record` names the request's
+ * endpoint by its template and leaves the wildcard for any path the set does not hold, so a span
+ * keeps which endpoint ran without any segment the caller chose.
+ */
+export declare const routeTemplates: (templates: Iterable<`/${string}`>) => {
+    match: (path: string) => `/${string}` | undefined;
+    record: (path: string) => Effect.Effect<void, never, never>;
+};
 /** Wrap whichever tracer is already in scope; provide this above the exporter. */
 export declare const spanAttributes: (clock?: "system" | "cloudflare-io", recordAll?: boolean) => Layer.Layer<never>;
 /** Header and URL filtering without making an unsupported claim about the runtime clock. */