@editframe/elements 0.24.1-beta.0 → 0.25.1-beta.0

package/dist/otel/tracingHelpers.d.ts

@@ -1,34 +1,7 @@
-import { Context, Span } from '@opentelemetry/api';
-export type TraceContext = Record<string, string>;
-/**
- * Enable tracing globally. Call this during initialization if tracing is requested.
- */
-export declare function enableTracing(): void;
-/**
- * Check if tracing is currently enabled.
- */
-export declare function isTracingEnabled(): boolean;
-/**
- * Set the current frame's span. Call this when starting a frame render.
- * All spans created during this frame will use this as parent if
- * Zone.js doesn't provide one via context.active()
- */
-export declare function setCurrentFrameSpan(span: Span): void;
-/**
- * Clear the current frame span. Call this when a frame completes.
- */
-export declare function clearCurrentFrameSpan(): void;
-export declare function extractParentContext(traceContext?: TraceContext): Context;
-/**
- * Get the active span's context to pass to child operations
- * Use this when calling functions that create child spans
- */
-export declare function getActiveContext(): Context;
-/**
- * Wrapper that passes span context explicitly to the function
- * Use this for operations that need to store or propagate context across boundaries
- */
-export declare function withSpanAndContext<T>(name: string, attributes: Record<string, string | number | boolean> | undefined, parentContext: Context | undefined, fn: (span: Span, activeContext: Context) => Promise<T>): Promise<T>;
-export declare function createSpan(name: string, attributes?: Record<string, string | number | boolean>, parentContext?: Context): Span;
-export declare function withSpan<T>(name: string, attributes: Record<string, string | number | boolean> | undefined, parentContext: Context | undefined, fn: (span: Span) => Promise<T>): Promise<T>;
-export declare function withSpanSync<T>(name: string, attributes: Record<string, string | number | boolean> | undefined, parentContext: Context | undefined, fn: (span: Span) => T): T;
+import "@opentelemetry/api";
+
+//#region src/otel/tracingHelpers.d.ts
+type TraceContext = Record<string, string>;
+//#endregion
+export { TraceContext };
+//# sourceMappingURL=tracingHelpers.d.ts.map

package/dist/otel/tracingHelpers.js

@@ -1,15 +1,40 @@
 import { context, propagation, trace } from "@opentelemetry/api";
-var tracingEnabled = false;
+
+//#region src/otel/tracingHelpers.ts
+/**
+* Global flag to enable/disable tracing.
+* When false, all tracing functions become no-ops for zero overhead.
+*/
+let tracingEnabled = false;
+/**
+* Enable tracing globally. Call this during initialization if tracing is requested.
+*/
 function enableTracing() {
 	tracingEnabled = true;
 }
+/**
+* Check if tracing is currently enabled.
+*/
 function isTracingEnabled() {
 	return tracingEnabled;
 }
-var currentFrameSpan;
+/**
+* Frame-local span storage for rendering.
+* Since rendering is single-threaded and sequential (one frame at a time),
+* we store the active frame span directly and use it as parent for orphaned spans.
+*/
+let currentFrameSpan;
+/**
+* Set the current frame's span. Call this when starting a frame render.
+* All spans created during this frame will use this as parent if
+* Zone.js doesn't provide one via context.active()
+*/
 function setCurrentFrameSpan(span) {
 	currentFrameSpan = span;
 }
+/**
+* Clear the current frame span. Call this when a frame completes.
+*/
 function clearCurrentFrameSpan() {
 	currentFrameSpan = void 0;
 }
@@ -21,6 +46,10 @@ function extractParentContext(traceContext) {
 		return context.active();
 	}
 }
+/**
+* Wrapper that passes span context explicitly to the function
+* Use this for operations that need to store or propagate context across boundaries
+*/
 async function withSpanAndContext(name, attributes, parentContext, fn) {
 	if (!tracingEnabled) {
 		const noopSpan = trace.getTracer("telecine-browser").startSpan(name);
@@ -109,4 +138,7 @@ function withSpanSync(name, attributes, parentContext, fn) {
 		throw error;
 	}
 }
+
+//#endregion
 export { clearCurrentFrameSpan, enableTracing, extractParentContext, isTracingEnabled, setCurrentFrameSpan, withSpan, withSpanAndContext, withSpanSync };
+//# sourceMappingURL=tracingHelpers.js.map

package/dist/otel/tracingHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracingHelpers.js","names":["currentFrameSpan: Span | undefined","ctx: Context"],"sources":["../../src/otel/tracingHelpers.ts"],"sourcesContent":["import {\n  type Context,\n  context,\n  propagation,\n  type Span,\n  trace,\n} from \"@opentelemetry/api\";\n\nexport type TraceContext = Record<string, string>;\n\n/**\n * Global flag to enable/disable tracing.\n * When false, all tracing functions become no-ops for zero overhead.\n */\nlet tracingEnabled = false;\n\n/**\n * Enable tracing globally. Call this during initialization if tracing is requested.\n */\nexport function enableTracing(): void {\n  tracingEnabled = true;\n}\n\n/**\n * Check if tracing is currently enabled.\n */\nexport function isTracingEnabled(): boolean {\n  return tracingEnabled;\n}\n\n/**\n * Frame-local span storage for rendering.\n * Since rendering is single-threaded and sequential (one frame at a time),\n * we store the active frame span directly and use it as parent for orphaned spans.\n */\nlet currentFrameSpan: Span | undefined;\n\n/**\n * Set the current frame's span. Call this when starting a frame render.\n * All spans created during this frame will use this as parent if\n * Zone.js doesn't provide one via context.active()\n */\nexport function setCurrentFrameSpan(span: Span): void {\n  currentFrameSpan = span;\n}\n\n/**\n * Clear the current frame span. Call this when a frame completes.\n */\nexport function clearCurrentFrameSpan(): void {\n  currentFrameSpan = undefined;\n}\n\nexport function extractParentContext(traceContext?: TraceContext): Context {\n  if (!traceContext) {\n    return context.active();\n  }\n\n  try {\n    return propagation.extract(context.active(), traceContext);\n  } catch (_error) {\n    return context.active();\n  }\n}\n\n/**\n * Get the active span's context to pass to child operations\n * Use this when calling functions that create child spans\n */\nexport function getActiveContext(): Context {\n  return context.active();\n}\n\n/**\n * Wrapper that passes span context explicitly to the function\n * Use this for operations that need to store or propagate context across boundaries\n */\nexport async function withSpanAndContext<T>(\n  name: string,\n  attributes: Record<string, string | number | boolean> | undefined,\n  parentContext: Context | undefined,\n  fn: (span: Span, activeContext: Context) => Promise<T>,\n): Promise<T> {\n  // No-op if tracing is disabled\n  if (!tracingEnabled) {\n    // Create a minimal no-op span for compatibility\n    const noopSpan = trace.getTracer(\"telecine-browser\").startSpan(name);\n    const ctx = parentContext || context.active();\n    const result = await fn(noopSpan, ctx);\n    noopSpan.end();\n    return result;\n  }\n\n  const tracer = trace.getTracer(\"telecine-browser\");\n\n  // Same context resolution as withSpan\n  let ctx: Context;\n\n  if (parentContext) {\n    ctx = parentContext;\n  } else {\n    const activeContext = context.active();\n    const activeSpan = trace.getSpan(activeContext);\n\n    if (activeSpan?.isRecording?.()) {\n      ctx = activeContext;\n    } else if (currentFrameSpan) {\n      ctx = trace.setSpan(context.active(), currentFrameSpan);\n    } else {\n      ctx = activeContext;\n    }\n  }\n\n  const span = tracer.startSpan(\n    name,\n    {\n      attributes,\n    },\n    ctx,\n  );\n\n  // Create context with this span as active\n  const spanContext = trace.setSpan(ctx, span);\n\n  try {\n    // Pass the spanContext explicitly to the function\n    const result = await context.with(spanContext, async () => {\n      return fn(span, spanContext);\n    });\n    span.end();\n    return result;\n  } catch (error) {\n    span.recordException(error as Error);\n    span.end();\n    throw error;\n  }\n}\n\nexport function createSpan(\n  name: string,\n  attributes?: Record<string, string | number | boolean>,\n  parentContext?: Context,\n): Span {\n  const tracer = trace.getTracer(\"telecine-browser\");\n  const ctx = parentContext || context.active();\n\n  return context.with(ctx, () => {\n    const span = tracer.startSpan(name);\n\n    if (attributes) {\n      span.setAttributes(attributes);\n    }\n\n    return span;\n  });\n}\n\nexport async function withSpan<T>(\n  name: string,\n  attributes: Record<string, string | number | boolean> | undefined,\n  parentContext: Context | undefined,\n  fn: (span: Span) => Promise<T>,\n): Promise<T> {\n  // No-op if tracing is disabled\n  if (!tracingEnabled) {\n    // Create a minimal no-op span for compatibility\n    const noopSpan = trace.getTracer(\"telecine-browser\").startSpan(name);\n    const result = await fn(noopSpan);\n    noopSpan.end();\n    return result;\n  }\n\n  const tracer = trace.getTracer(\"telecine-browser\");\n\n  // Context resolution priority:\n  // 1. Explicit parentContext (if provided)\n  // 2. context.active() from Zone.js (if it has a valid span)\n  // 3. Create context from currentFrameSpan (fallback for Lit Task boundaries)\n  let ctx: Context;\n\n  if (parentContext) {\n    ctx = parentContext;\n  } else {\n    const activeContext = context.active();\n    const activeSpan = trace.getSpan(activeContext);\n\n    // Try to use context.active() if it has a real span\n    if (activeSpan?.isRecording?.()) {\n      ctx = activeContext;\n    } else if (currentFrameSpan) {\n      // Create context from the stored frame span\n      ctx = trace.setSpan(context.active(), currentFrameSpan);\n    } else {\n      ctx = activeContext;\n    }\n  }\n\n  // Start span with explicit parent\n  const span = tracer.startSpan(\n    name,\n    {\n      attributes,\n    },\n    ctx,\n  );\n\n  // Create context with this span as active\n  const spanContext = trace.setSpan(ctx, span);\n\n  try {\n    // Execute function with span context\n    const result = await context.with(spanContext, async () => {\n      return fn(span);\n    });\n    span.end();\n    return result;\n  } catch (error) {\n    span.recordException(error as Error);\n    span.end();\n    throw error;\n  }\n}\n\nexport function withSpanSync<T>(\n  name: string,\n  attributes: Record<string, string | number | boolean> | undefined,\n  parentContext: Context | undefined,\n  fn: (span: Span) => T,\n): T {\n  // No-op if tracing is disabled\n  if (!tracingEnabled) {\n    // Create a minimal no-op span for compatibility\n    const noopSpan = trace.getTracer(\"telecine-browser\").startSpan(name);\n    const result = fn(noopSpan);\n    noopSpan.end();\n    return result;\n  }\n\n  const span = createSpan(name, attributes, parentContext);\n  const ctx = parentContext || context.active();\n\n  try {\n    const result = context.with(trace.setSpan(ctx, span), () => fn(span));\n    span.end();\n    return result;\n  } catch (error) {\n    span.recordException(error as Error);\n    span.end();\n    throw error;\n  }\n}\n"],"mappings":"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"}