veryfront 0.1.474 → 0.1.475

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.474",
+    "version": "0.1.475",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "workspace": [

package/esm/src/observability/index.d.ts

@@ -18,6 +18,7 @@ export { addSpanEvent, createChildSpan, endSpan, extractContext, getActiveContex
 export { getMetricsState, initMetrics, isMetricsEnabled, type MetricsConfig, recordBuild, recordBundle, recordCacheGet, recordCacheInvalidate, recordCacheSet, recordCorsRejection, recordDataFetch, recordDataFetchError, recordHttpRequest, recordHttpRequestComplete, recordRender, recordRenderError, recordRSCError, recordRSCRender, recordRSCRequest, recordRSCStream, recordSecurityHeaders, setCacheSize, shutdownMetrics, } from "./metrics/index.js";
 export { type AutoInstrumentConfig, initAutoInstrumentation, instrument, instrumentBatch, instrumentErrorHandler, instrumentFetch, instrumentHttpHandler, instrumentReactRender, instrumentSync, isAutoInstrumentEnabled, } from "./auto-instrument/index.js";
 export { initializeOTLP, isOTLPEnabled, type OTLPConfig, shutdownOTLP, } from "./tracing/otlp-setup.js";
+export { createOpenTelemetryServiceTracer, type CreateOpenTelemetryServiceTracerOptions, type OpenTelemetryContextApi, type OpenTelemetryServiceTracer, type OpenTelemetrySpan, type OpenTelemetrySpanContext, type OpenTelemetryTraceApi, type OpenTelemetryTracer, type ServiceTracer, type ServiceTracerAttributeInput, type ServiceTracerAttributes, type ServiceTracerAttributeValue, type ServiceTracerSpan, type ServiceTracerSpanContext, type ServiceTracerStartSpanOptions, } from "./tracing/service-tracer.js";
 export { type DevError, ErrorCollector, type ErrorFilter, type ErrorSubscriber, type ErrorType, getErrorCollector, parseCompileError, resetErrorCollector, } from "./error-collector.js";
 export { getLogBuffer, interceptConsole, LogBuffer, type LogEntry, type LogFilter as LogBufferFilter, type LogLevel, type LogSubscriber, resetLogBuffer, } from "./log-buffer.js";
 export { createFileLogSubscriber, type FileLogConfig, FileLogSubscriber, parseMaxSize, } from "./file-log-subscriber.js";

package/esm/src/observability/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,KAAK,WAAW,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,IAAI,eAAe,EACjC,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,yBAAyB,CAAC;AAGjC,OAAO,EACL,YAAY,EACZ,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,KAAK,WAAW,EAChB,SAAS,EACT,KAAK,aAAa,EAClB,cAAc,EACd,QAAQ,EACR,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,GACxB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,UAAU,EACf,YAAY,GACb,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,gCAAgC,EAChC,KAAK,uCAAuC,EAC5C,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,KAAK,2BAA2B,EAChC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,6BAA6B,GACnC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,KAAK,QAAQ,EACb,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,KAAK,QAAQ,EACb,KAAK,SAAS,IAAI,eAAe,EACjC,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,uBAAuB,EACvB,KAAK,aAAa,EAClB,iBAAiB,EACjB,YAAY,GACb,MAAM,0BAA0B,CAAC"}

package/esm/src/observability/index.js

@@ -18,6 +18,7 @@ export { addSpanEvent, createChildSpan, endSpan, extractContext, getActiveContex
 export { getMetricsState, initMetrics, isMetricsEnabled, recordBuild, recordBundle, recordCacheGet, recordCacheInvalidate, recordCacheSet, recordCorsRejection, recordDataFetch, recordDataFetchError, recordHttpRequest, recordHttpRequestComplete, recordRender, recordRenderError, recordRSCError, recordRSCRender, recordRSCRequest, recordRSCStream, recordSecurityHeaders, setCacheSize, shutdownMetrics, } from "./metrics/index.js";
 export { initAutoInstrumentation, instrument, instrumentBatch, instrumentErrorHandler, instrumentFetch, instrumentHttpHandler, instrumentReactRender, instrumentSync, isAutoInstrumentEnabled, } from "./auto-instrument/index.js";
 export { initializeOTLP, isOTLPEnabled, shutdownOTLP, } from "./tracing/otlp-setup.js";
+export { createOpenTelemetryServiceTracer, } from "./tracing/service-tracer.js";
 export { ErrorCollector, getErrorCollector, parseCompileError, resetErrorCollector, } from "./error-collector.js";
 export { getLogBuffer, interceptConsole, LogBuffer, resetLogBuffer, } from "./log-buffer.js";
 export { createFileLogSubscriber, FileLogSubscriber, parseMaxSize, } from "./file-log-subscriber.js";

package/esm/src/observability/tracing/service-tracer.d.ts

@@ -0,0 +1,73 @@
+export type OpenTelemetrySpanContext = {
+    traceId: string;
+    spanId: string;
+};
+export type OpenTelemetrySpan = {
+    setAttribute(key: string, value: string | number | boolean): unknown;
+    setAttributes(attributes: Record<string, string | number | boolean>): unknown;
+    setStatus(status: {
+        code: number;
+    }): unknown;
+    recordException(error: unknown): unknown;
+    end(): unknown;
+    spanContext(): OpenTelemetrySpanContext;
+};
+export type OpenTelemetryTracer<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+    startSpan(name: string, options: TSpanOptions | undefined, context: TContext): TSpan;
+    startActiveSpan<T>(name: string, fn: (span: TSpan) => T): T;
+};
+export type OpenTelemetryTraceApi<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+    getTracer(serviceName: string): OpenTelemetryTracer<TContext, TSpan, TSpanOptions>;
+    getSpan(context: TContext): TSpan | undefined;
+    setSpan(context: TContext, span: TSpan): TContext;
+};
+export type OpenTelemetryContextApi<TContext> = {
+    active(): TContext;
+    with<T>(context: TContext, fn: () => T): T;
+};
+export type ServiceTracerAttributeInput = string | number | boolean | null | undefined | object;
+export type ServiceTracerAttributePrimitive = string | number | boolean;
+export type ServiceTracerAttributeValue = ServiceTracerAttributePrimitive | readonly ServiceTracerAttributePrimitive[] | null | undefined;
+export type ServiceTracerAttributes = Record<string, ServiceTracerAttributeValue>;
+export type ServiceTracerSpanContext = {
+    toTraceId(): string;
+    toSpanId(): string;
+};
+export type ServiceTracerSpan<TContext, TSpan extends OpenTelemetrySpan> = {
+    setTag(key: string, value: ServiceTracerAttributeInput): TSpan;
+    setAttributes(attributes: Record<string, ServiceTracerAttributeInput>): TSpan;
+    finish(): void;
+    withContext<T>(fn: () => T): T;
+    context(): ServiceTracerSpanContext | undefined;
+    readonly otelSpan: TSpan;
+    readonly otelContext: TContext;
+};
+export type ServiceTracerStartSpanOptions<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = TSpanOptions & {
+    childOf?: ServiceTracerSpan<TContext, TSpan>;
+};
+export type ServiceTracer<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+    init(): void;
+    startSpan(name: string, options?: ServiceTracerStartSpanOptions<TContext, TSpan, TSpanOptions>): ServiceTracerSpan<TContext, TSpan>;
+    scope(): {
+        active(): ServiceTracerSpan<TContext, TSpan> | null;
+    };
+    wrap<TArgs extends unknown[], TResult>(name: string, fn: (...args: TArgs) => TResult): (...args: TArgs) => TResult;
+    trace<T>(name: string, fn: () => Promise<T>): Promise<T>;
+    trace<T>(name: string, fn: () => T): T;
+};
+export type CreateOpenTelemetryServiceTracerOptions<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+    serviceName: string;
+    context: OpenTelemetryContextApi<TContext>;
+    trace: OpenTelemetryTraceApi<TContext, TSpan, TSpanOptions>;
+    errorStatusCode: number;
+};
+export type OpenTelemetryServiceTracer<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+    tracer: ServiceTracer<TContext, TSpan, TSpanOptions>;
+    setActiveSpanAttributes(attributes: ServiceTracerAttributes): void;
+    getTraceContext(): {
+        traceId?: string;
+        spanId?: string;
+    };
+};
+export declare function createOpenTelemetryServiceTracer<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions>(options: CreateOpenTelemetryServiceTracerOptions<TContext, TSpan, TSpanOptions>): OpenTelemetryServiceTracer<TContext, TSpan, TSpanOptions>;
+//# sourceMappingURL=service-tracer.d.ts.map

package/esm/src/observability/tracing/service-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-tracer.d.ts","sourceRoot":"","sources":["../../../../src/src/observability/tracing/service-tracer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACrE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC;IAC9E,SAAS,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC7C,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IACzC,GAAG,IAAI,OAAO,CAAC;IACf,WAAW,IAAI,wBAAwB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,mBAAmB,CAAC,QAAQ,EAAE,KAAK,SAAS,iBAAiB,EAAE,YAAY,IAAI;IACzF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,OAAO,EAAE,QAAQ,GAAG,KAAK,CAAC;IACrF,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC;CAC7D,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,QAAQ,EAAE,KAAK,SAAS,iBAAiB,EAAE,YAAY,IAAI;IAC3F,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACnF,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAC9C,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,QAAQ,CAAC;CACnD,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,QAAQ,IAAI;IAC9C,MAAM,IAAI,QAAQ,CAAC;IACnB,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC;AAChG,MAAM,MAAM,+BAA+B,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACxE,MAAM,MAAM,2BAA2B,GACnC,+BAA+B,GAC/B,SAAS,+BAA+B,EAAE,GAC1C,IAAI,GACJ,SAAS,CAAC;AACd,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;AAElF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,IAAI,MAAM,CAAC;IACpB,QAAQ,IAAI,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAC3B,QAAQ,EACR,KAAK,SAAS,iBAAiB,IAC7B;IACF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,2BAA2B,GAAG,KAAK,CAAC;IAC/D,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,GAAG,KAAK,CAAC;IAC9E,MAAM,IAAI,IAAI,CAAC;IACf,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,IAAI,wBAAwB,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,6BAA6B,CACvC,QAAQ,EACR,KAAK,SAAS,iBAAiB,EAC/B,YAAY,IACV,YAAY,GAAG;IACjB,OAAO,CAAC,EAAE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,QAAQ,EAAE,KAAK,SAAS,iBAAiB,EAAE,YAAY,IAAI;IACnF,IAAI,IAAI,IAAI,CAAC;IACb,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,6BAA6B,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,GACrE,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,KAAK,IAAI;QACP,MAAM,IAAI,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;KACrD,CAAC;IACF,IAAI,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACnC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,GAC9B,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC;IAC/B,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACzD,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,uCAAuC,CACjD,QAAQ,EACR,KAAK,SAAS,iBAAiB,EAC/B,YAAY,IACV;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC3C,KAAK,EAAE,qBAAqB,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAC5D,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,0BAA0B,CACpC,QAAQ,EACR,KAAK,SAAS,iBAAiB,EAC/B,YAAY,IACV;IACF,MAAM,EAAE,aAAa,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IACrD,uBAAuB,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACnE,eAAe,IAAI;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D,CAAC;AA4DF,wBAAgB,gCAAgC,CAC9C,QAAQ,EACR,KAAK,SAAS,iBAAiB,EAC/B,YAAY,EAEZ,OAAO,EAAE,uCAAuC,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,GAC9E,0BAA0B,CAAC,QAAQ,EAAE,KAAK,EAAE,YAAY,CAAC,CAmG3D"}

package/esm/src/observability/tracing/service-tracer.js

@@ -0,0 +1,131 @@
+function toAttributeValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return value;
+}
+function createTracerSpan(contextApi, span, context) {
+    const spanContext = span.spanContext();
+    return {
+        setTag: (key, value) => {
+            span.setAttribute(key, toAttributeValue(value));
+            return span;
+        },
+        setAttributes: (attributes) => {
+            for (const [key, value] of Object.entries(attributes)) {
+                span.setAttribute(key, toAttributeValue(value));
+            }
+            return span;
+        },
+        finish: () => {
+            span.end();
+        },
+        withContext: (fn) => contextApi.with(context, fn),
+        context: () => ({
+            toTraceId: () => spanContext.traceId,
+            toSpanId: () => spanContext.spanId,
+        }),
+        otelSpan: span,
+        otelContext: context,
+    };
+}
+function setSpanErrorStatus(span, errorStatusCode, error) {
+    span.setStatus({ code: errorStatusCode });
+    if (error instanceof Error) {
+        span.recordException(error);
+    }
+}
+function isPromise(value) {
+    return value instanceof Promise;
+}
+export function createOpenTelemetryServiceTracer(options) {
+    const otelTracer = options.trace.getTracer(options.serviceName);
+    function wrap(name, fn) {
+        return (...args) => {
+            const span = otelTracer.startSpan(name, undefined, options.context.active());
+            const contextWithSpan = options.trace.setSpan(options.context.active(), span);
+            try {
+                return options.context.with(contextWithSpan, () => fn(...args));
+            }
+            catch (error) {
+                setSpanErrorStatus(span, options.errorStatusCode, error);
+                throw error;
+            }
+            finally {
+                span.end();
+            }
+        };
+    }
+    function trace(name, fn) {
+        return otelTracer.startActiveSpan(name, (span) => {
+            try {
+                const result = fn();
+                if (isPromise(result)) {
+                    return result
+                        .then((value) => {
+                        span.end();
+                        return value;
+                    })
+                        .catch((error) => {
+                        setSpanErrorStatus(span, options.errorStatusCode, error);
+                        span.end();
+                        throw error;
+                    });
+                }
+                span.end();
+                return result;
+            }
+            catch (error) {
+                setSpanErrorStatus(span, options.errorStatusCode, error);
+                span.end();
+                throw error;
+            }
+        });
+    }
+    const tracer = {
+        init: () => { },
+        startSpan: (name, startOptions) => {
+            let parentContext = options.context.active();
+            if (startOptions?.childOf?.otelSpan) {
+                parentContext = options.trace.setSpan(options.context.active(), startOptions.childOf.otelSpan);
+            }
+            const span = otelTracer.startSpan(name, startOptions, parentContext);
+            const spanContext = options.trace.setSpan(parentContext, span);
+            return createTracerSpan(options.context, span, spanContext);
+        },
+        scope: () => ({
+            active: () => {
+                const activeContext = options.context.active();
+                const activeSpan = options.trace.getSpan(activeContext);
+                if (!activeSpan)
+                    return null;
+                return createTracerSpan(options.context, activeSpan, activeContext);
+            },
+        }),
+        wrap,
+        trace,
+    };
+    return {
+        tracer,
+        setActiveSpanAttributes(attributes) {
+            const activeSpan = tracer.scope().active();
+            if (!activeSpan)
+                return;
+            activeSpan.setAttributes(attributes);
+        },
+        getTraceContext() {
+            const activeSpan = tracer.scope().active();
+            if (!activeSpan) {
+                return {};
+            }
+            const spanContext = activeSpan.otelSpan.spanContext();
+            return {
+                traceId: spanContext.traceId,
+                spanId: spanContext.spanId,
+            };
+        },
+    };
+}

package/esm/src/utils/version-constant.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.474";
+export declare const VERSION = "0.1.475";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.474";
+export const VERSION = "0.1.475";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.474",
+  "version": "0.1.475",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.474",
+  "version": "0.1.475",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "workspace": [

package/src/src/observability/index.ts

@@ -82,6 +82,24 @@ export {
   shutdownOTLP,
 } from "./tracing/otlp-setup.js";
 
+export {
+  createOpenTelemetryServiceTracer,
+  type CreateOpenTelemetryServiceTracerOptions,
+  type OpenTelemetryContextApi,
+  type OpenTelemetryServiceTracer,
+  type OpenTelemetrySpan,
+  type OpenTelemetrySpanContext,
+  type OpenTelemetryTraceApi,
+  type OpenTelemetryTracer,
+  type ServiceTracer,
+  type ServiceTracerAttributeInput,
+  type ServiceTracerAttributes,
+  type ServiceTracerAttributeValue,
+  type ServiceTracerSpan,
+  type ServiceTracerSpanContext,
+  type ServiceTracerStartSpanOptions,
+} from "./tracing/service-tracer.js";
+
 export {
   type DevError,
   ErrorCollector,

package/src/src/observability/tracing/service-tracer.ts

@@ -0,0 +1,267 @@
+export type OpenTelemetrySpanContext = {
+  traceId: string;
+  spanId: string;
+};
+
+export type OpenTelemetrySpan = {
+  setAttribute(key: string, value: string | number | boolean): unknown;
+  setAttributes(attributes: Record<string, string | number | boolean>): unknown;
+  setStatus(status: { code: number }): unknown;
+  recordException(error: unknown): unknown;
+  end(): unknown;
+  spanContext(): OpenTelemetrySpanContext;
+};
+
+export type OpenTelemetryTracer<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+  startSpan(name: string, options: TSpanOptions | undefined, context: TContext): TSpan;
+  startActiveSpan<T>(name: string, fn: (span: TSpan) => T): T;
+};
+
+export type OpenTelemetryTraceApi<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+  getTracer(serviceName: string): OpenTelemetryTracer<TContext, TSpan, TSpanOptions>;
+  getSpan(context: TContext): TSpan | undefined;
+  setSpan(context: TContext, span: TSpan): TContext;
+};
+
+export type OpenTelemetryContextApi<TContext> = {
+  active(): TContext;
+  with<T>(context: TContext, fn: () => T): T;
+};
+
+export type ServiceTracerAttributeInput = string | number | boolean | null | undefined | object;
+export type ServiceTracerAttributePrimitive = string | number | boolean;
+export type ServiceTracerAttributeValue =
+  | ServiceTracerAttributePrimitive
+  | readonly ServiceTracerAttributePrimitive[]
+  | null
+  | undefined;
+export type ServiceTracerAttributes = Record<string, ServiceTracerAttributeValue>;
+
+export type ServiceTracerSpanContext = {
+  toTraceId(): string;
+  toSpanId(): string;
+};
+
+export type ServiceTracerSpan<
+  TContext,
+  TSpan extends OpenTelemetrySpan,
+> = {
+  setTag(key: string, value: ServiceTracerAttributeInput): TSpan;
+  setAttributes(attributes: Record<string, ServiceTracerAttributeInput>): TSpan;
+  finish(): void;
+  withContext<T>(fn: () => T): T;
+  context(): ServiceTracerSpanContext | undefined;
+  readonly otelSpan: TSpan;
+  readonly otelContext: TContext;
+};
+
+export type ServiceTracerStartSpanOptions<
+  TContext,
+  TSpan extends OpenTelemetrySpan,
+  TSpanOptions,
+> = TSpanOptions & {
+  childOf?: ServiceTracerSpan<TContext, TSpan>;
+};
+
+export type ServiceTracer<TContext, TSpan extends OpenTelemetrySpan, TSpanOptions> = {
+  init(): void;
+  startSpan(
+    name: string,
+    options?: ServiceTracerStartSpanOptions<TContext, TSpan, TSpanOptions>,
+  ): ServiceTracerSpan<TContext, TSpan>;
+  scope(): {
+    active(): ServiceTracerSpan<TContext, TSpan> | null;
+  };
+  wrap<TArgs extends unknown[], TResult>(
+    name: string,
+    fn: (...args: TArgs) => TResult,
+  ): (...args: TArgs) => TResult;
+  trace<T>(name: string, fn: () => Promise<T>): Promise<T>;
+  trace<T>(name: string, fn: () => T): T;
+};
+
+export type CreateOpenTelemetryServiceTracerOptions<
+  TContext,
+  TSpan extends OpenTelemetrySpan,
+  TSpanOptions,
+> = {
+  serviceName: string;
+  context: OpenTelemetryContextApi<TContext>;
+  trace: OpenTelemetryTraceApi<TContext, TSpan, TSpanOptions>;
+  errorStatusCode: number;
+};
+
+export type OpenTelemetryServiceTracer<
+  TContext,
+  TSpan extends OpenTelemetrySpan,
+  TSpanOptions,
+> = {
+  tracer: ServiceTracer<TContext, TSpan, TSpanOptions>;
+  setActiveSpanAttributes(attributes: ServiceTracerAttributes): void;
+  getTraceContext(): { traceId?: string; spanId?: string };
+};
+
+function toAttributeValue(value: ServiceTracerAttributeInput): string | number | boolean {
+  if (value === null || value === undefined) {
+    return "";
+  }
+
+  if (typeof value === "object") {
+    return JSON.stringify(value);
+  }
+
+  return value;
+}
+
+function createTracerSpan<TContext, TSpan extends OpenTelemetrySpan>(
+  contextApi: OpenTelemetryContextApi<TContext>,
+  span: TSpan,
+  context: TContext,
+): ServiceTracerSpan<TContext, TSpan> {
+  const spanContext = span.spanContext();
+
+  return {
+    setTag: (key, value) => {
+      span.setAttribute(key, toAttributeValue(value));
+      return span;
+    },
+    setAttributes: (attributes) => {
+      for (const [key, value] of Object.entries(attributes)) {
+        span.setAttribute(key, toAttributeValue(value));
+      }
+      return span;
+    },
+    finish: () => {
+      span.end();
+    },
+    withContext: <T>(fn: () => T): T => contextApi.with(context, fn),
+    context: () => ({
+      toTraceId: () => spanContext.traceId,
+      toSpanId: () => spanContext.spanId,
+    }),
+    otelSpan: span,
+    otelContext: context,
+  };
+}
+
+function setSpanErrorStatus<TSpan extends OpenTelemetrySpan>(
+  span: TSpan,
+  errorStatusCode: number,
+  error: unknown,
+): void {
+  span.setStatus({ code: errorStatusCode });
+  if (error instanceof Error) {
+    span.recordException(error);
+  }
+}
+
+function isPromise<T>(value: T | Promise<T>): value is Promise<T> {
+  return value instanceof Promise;
+}
+
+export function createOpenTelemetryServiceTracer<
+  TContext,
+  TSpan extends OpenTelemetrySpan,
+  TSpanOptions,
+>(
+  options: CreateOpenTelemetryServiceTracerOptions<TContext, TSpan, TSpanOptions>,
+): OpenTelemetryServiceTracer<TContext, TSpan, TSpanOptions> {
+  const otelTracer = options.trace.getTracer(options.serviceName);
+
+  function wrap<TArgs extends unknown[], TResult>(
+    name: string,
+    fn: (...args: TArgs) => TResult,
+  ): (...args: TArgs) => TResult {
+    return (...args: TArgs): TResult => {
+      const span = otelTracer.startSpan(name, undefined, options.context.active());
+      const contextWithSpan = options.trace.setSpan(options.context.active(), span);
+      try {
+        return options.context.with(contextWithSpan, () => fn(...args));
+      } catch (error) {
+        setSpanErrorStatus(span, options.errorStatusCode, error);
+        throw error;
+      } finally {
+        span.end();
+      }
+    };
+  }
+
+  function trace<T>(name: string, fn: () => Promise<T>): Promise<T>;
+  function trace<T>(name: string, fn: () => T): T;
+  function trace<T>(name: string, fn: () => T | Promise<T>): T | Promise<T> {
+    return otelTracer.startActiveSpan(name, (span) => {
+      try {
+        const result = fn();
+        if (isPromise(result)) {
+          return result
+            .then((value) => {
+              span.end();
+              return value;
+            })
+            .catch((error) => {
+              setSpanErrorStatus(span, options.errorStatusCode, error);
+              span.end();
+              throw error;
+            });
+        }
+        span.end();
+        return result;
+      } catch (error) {
+        setSpanErrorStatus(span, options.errorStatusCode, error);
+        span.end();
+        throw error;
+      }
+    });
+  }
+
+  const tracer: ServiceTracer<TContext, TSpan, TSpanOptions> = {
+    init: () => {},
+    startSpan: (name, startOptions) => {
+      let parentContext = options.context.active();
+
+      if (startOptions?.childOf?.otelSpan) {
+        parentContext = options.trace.setSpan(
+          options.context.active(),
+          startOptions.childOf.otelSpan,
+        );
+      }
+
+      const span = otelTracer.startSpan(name, startOptions, parentContext);
+      const spanContext = options.trace.setSpan(parentContext, span);
+      return createTracerSpan(options.context, span, spanContext);
+    },
+    scope: () => ({
+      active: () => {
+        const activeContext = options.context.active();
+        const activeSpan = options.trace.getSpan(activeContext);
+        if (!activeSpan) return null;
+
+        return createTracerSpan(options.context, activeSpan, activeContext);
+      },
+    }),
+    wrap,
+    trace,
+  };
+
+  return {
+    tracer,
+    setActiveSpanAttributes(attributes) {
+      const activeSpan = tracer.scope().active();
+      if (!activeSpan) return;
+
+      activeSpan.setAttributes(attributes);
+    },
+    getTraceContext() {
+      const activeSpan = tracer.scope().active();
+      if (!activeSpan) {
+        return {};
+      }
+
+      const spanContext = activeSpan.otelSpan.spanContext();
+      return {
+        traceId: spanContext.traceId,
+        spanId: spanContext.spanId,
+      };
+    },
+  };
+}

package/src/src/utils/version-constant.ts

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.474";
+export const VERSION = "0.1.475";