@dxos/tracing 0.1.56-main.d9d1c3e

package/dist/lib/node/index.cjs

@@ -0,0 +1,342 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/common/tracing/src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  TRACE_PROCESSOR: () => TRACE_PROCESSOR,
+  TRACE_SPAN_ATTRIBUTE: () => TRACE_SPAN_ATTRIBUTE,
+  TraceProcessor: () => TraceProcessor,
+  TraceSender: () => TraceSender,
+  TracingSpan: () => TracingSpan,
+  getTracingContext: () => getTracingContext,
+  symbolTracingContext: () => symbolTracingContext,
+  trace: () => trace
+});
+module.exports = __toCommonJS(src_exports);
+
+// packages/common/tracing/src/api.ts
+var import_context = require("@dxos/context");
+
+// packages/common/tracing/src/symbols.ts
+var symbolTracingContext = Symbol("dxos.tracing-context");
+var getTracingContext = (target) => {
+  var _a2;
+  return (_a2 = target[symbolTracingContext]) != null ? _a2 : target[symbolTracingContext] = {
+    infoProperties: {}
+  };
+};
+var TRACE_SPAN_ATTRIBUTE = "dxos.trace-span";
+
+// packages/common/tracing/src/trace-processor.ts
+var import_util = require("@dxos/util");
+
+// packages/common/tracing/src/trace-sender.ts
+var import_codec_protobuf = require("@dxos/codec-protobuf");
+var FLUSH_INTERVAL = 1e3;
+var TraceSender = class {
+  constructor(_traceProcessor) {
+    this._traceProcessor = _traceProcessor;
+  }
+  streamTrace(request) {
+    return new import_codec_protobuf.Stream(({ ctx, next }) => {
+      const subscription = {
+        dirtyResources: /* @__PURE__ */ new Set(),
+        dirtySpans: /* @__PURE__ */ new Set()
+      };
+      this._traceProcessor.subscriptions.add(subscription);
+      ctx.onDispose(() => {
+        this._traceProcessor.subscriptions.delete(subscription);
+      });
+      const flushEvents = (resources, spans) => {
+        const event = {
+          resourceAdded: [],
+          resourceRemoved: [],
+          spanAdded: []
+        };
+        if (resources) {
+          for (const id of resources) {
+            const entry = this._traceProcessor.resources.get(id);
+            if (entry) {
+              event.resourceAdded.push({
+                resource: entry.data
+              });
+            } else {
+              event.resourceRemoved.push({
+                id
+              });
+            }
+          }
+        } else {
+          for (const entry of this._traceProcessor.resources.values()) {
+            event.resourceAdded.push({
+              resource: entry.data
+            });
+          }
+        }
+        if (spans) {
+          for (const id of spans) {
+            const span2 = this._traceProcessor.spans.get(id);
+            if (span2) {
+              event.spanAdded.push({
+                span: span2
+              });
+            }
+          }
+        } else {
+          for (const span2 of this._traceProcessor.spans.values()) {
+            event.spanAdded.push({
+              span: span2
+            });
+          }
+        }
+        if (event.resourceAdded.length > 0 || event.resourceRemoved.length > 0 || event.spanAdded.length > 0) {
+          next(event);
+        }
+      };
+      flushEvents(null, null);
+      const timer = setInterval(() => {
+        flushEvents(subscription.dirtyResources, subscription.dirtySpans);
+        subscription.dirtyResources.clear();
+        subscription.dirtySpans.clear();
+      }, FLUSH_INTERVAL);
+      ctx.onDispose(() => {
+        clearInterval(timer);
+      });
+    });
+  }
+};
+
+// packages/common/tracing/src/trace-processor.ts
+var MAX_RESOURCE_RECORDS = 500;
+var MAX_SPAN_RECORDS = 1e3;
+var TraceProcessor = class {
+  constructor() {
+    this.resources = /* @__PURE__ */ new Map();
+    this.resourceInstanceIndex = /* @__PURE__ */ new WeakMap();
+    this.resourceIdList = [];
+    this.spans = /* @__PURE__ */ new Map();
+    this.spanIdList = [];
+    this.subscriptions = /* @__PURE__ */ new Set();
+  }
+  traceResourceConstructor(params) {
+    const id = this.resources.size;
+    const entry = {
+      data: {
+        id,
+        className: params.constructor.name,
+        instanceId: (0, import_util.getPrototypeSpecificInstanceId)(params.instance),
+        info: this.getResourceInfo(params.instance),
+        links: []
+      },
+      instance: new WeakRef(params.instance)
+    };
+    this.resources.set(id, entry);
+    this.resourceInstanceIndex.set(params.instance, entry);
+    this.resourceIdList.push(id);
+    if (this.resourceIdList.length > MAX_RESOURCE_RECORDS) {
+      this._clearResources();
+    }
+    this._markResourceDirty(id);
+  }
+  getResourceInfo(instance) {
+    const res = {};
+    const tracingContext = getTracingContext(Object.getPrototypeOf(instance));
+    for (const [key, _opts] of Object.entries(tracingContext.infoProperties)) {
+      try {
+        res[key] = typeof instance[key] === "function" ? instance[key]() : instance[key];
+      } catch (err) {
+        res[key] = err.message;
+      }
+    }
+    return res;
+  }
+  traceSpan(params) {
+    const span2 = new TracingSpan(this, params);
+    this._flushSpan(span2);
+    return span2;
+  }
+  addLink(parent, child, opts) {
+  }
+  getResourceId(instance) {
+    const entry = this.resourceInstanceIndex.get(instance);
+    return entry ? entry.data.id : null;
+  }
+  createTraceSender() {
+    return new TraceSender(this);
+  }
+  /**
+  * @internal
+  */
+  _flushSpan(runtimeSpan) {
+    const span2 = runtimeSpan.serialize();
+    this.spans.set(span2.id, span2);
+    this.spanIdList.push(span2.id);
+    if (this.spanIdList.length > MAX_SPAN_RECORDS) {
+      this._clearSpans();
+    }
+    this._markSpanDirty(span2.id);
+  }
+  _markResourceDirty(id) {
+    for (const subscription of this.subscriptions) {
+      subscription.dirtyResources.add(id);
+    }
+  }
+  _markSpanDirty(id) {
+    for (const subscription of this.subscriptions) {
+      subscription.dirtySpans.add(id);
+    }
+  }
+  _clearResources() {
+    while (this.resourceIdList.length > MAX_RESOURCE_RECORDS) {
+      const id = this.resourceIdList.shift();
+      this.resources.delete(id);
+    }
+  }
+  _clearSpans() {
+    while (this.spanIdList.length > MAX_SPAN_RECORDS) {
+      const id = this.spanIdList.shift();
+      this.spans.delete(id);
+    }
+  }
+};
+var _TracingSpan = class {
+  constructor(_traceProcessor, params) {
+    this._traceProcessor = _traceProcessor;
+    this.parentId = null;
+    this.resourceId = null;
+    this.endTs = null;
+    this.error = null;
+    this._ctx = null;
+    this.id = _TracingSpan.nextId++;
+    this.methodName = params.methodName;
+    this.resourceId = _traceProcessor.getResourceId(params.instance);
+    this.startTs = performance.now();
+    if (params.parentCtx) {
+      this._ctx = params.parentCtx.derive({
+        attributes: {
+          [TRACE_SPAN_ATTRIBUTE]: this.id
+        }
+      });
+      const parentId = params.parentCtx.getAttribute(TRACE_SPAN_ATTRIBUTE);
+      if (typeof parentId === "number") {
+        this.parentId = parentId;
+      }
+    }
+  }
+  get ctx() {
+    return this._ctx;
+  }
+  markSuccess() {
+    this.endTs = performance.now();
+    this._traceProcessor._flushSpan(this);
+  }
+  markError(err) {
+    this.endTs = performance.now();
+    this.error = serializeError(err);
+    this._traceProcessor._flushSpan(this);
+  }
+  serialize() {
+    var _a2, _b, _c, _d, _e;
+    return {
+      id: this.id,
+      resourceId: (_a2 = this.resourceId) != null ? _a2 : void 0,
+      methodName: this.methodName,
+      parentId: (_b = this.parentId) != null ? _b : void 0,
+      startTs: this.startTs.toFixed(3),
+      endTs: (_d = (_c = this.endTs) == null ? void 0 : _c.toFixed(3)) != null ? _d : void 0,
+      error: (_e = this.error) != null ? _e : void 0
+    };
+  }
+};
+var TracingSpan = _TracingSpan;
+TracingSpan.nextId = 0;
+var serializeError = (err) => {
+  if (err instanceof Error) {
+    return {
+      name: err.name,
+      message: err.message
+    };
+  }
+  return {
+    message: String(err)
+  };
+};
+var _a;
+var TRACE_PROCESSOR = (_a = globalThis.TRACE_PROCESSOR) != null ? _a : globalThis.TRACE_PROCESSOR = new TraceProcessor();
+
+// packages/common/tracing/src/api.ts
+var resource = () => (constructor) => {
+  return class extends constructor {
+    constructor(...rest) {
+      super(...rest);
+      TRACE_PROCESSOR.traceResourceConstructor({
+        constructor,
+        instance: this
+      });
+    }
+  };
+};
+var info = () => (target, propertyKey, descriptor) => {
+  getTracingContext(target).infoProperties[propertyKey] = {};
+};
+var span = () => (target, propertyKey, descriptor) => {
+  const method = descriptor.value;
+  descriptor.value = async function(...args) {
+    const parentCtx = args[0] instanceof import_context.Context ? args[0] : null;
+    const span2 = TRACE_PROCESSOR.traceSpan({
+      parentCtx,
+      methodName: propertyKey,
+      instance: this
+    });
+    const callArgs = span2.ctx ? [
+      span2.ctx,
+      ...args.slice(1)
+    ] : args;
+    try {
+      return await method.apply(this, callArgs);
+    } catch (err) {
+      span2.markError(err);
+      throw err;
+    } finally {
+      span2.markSuccess();
+    }
+  };
+};
+var addLink = (parent, child, opts = {}) => {
+  TRACE_PROCESSOR.addLink(parent, child, opts);
+};
+var trace = {
+  resource,
+  info,
+  span,
+  addLink
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TRACE_PROCESSOR,
+  TRACE_SPAN_ATTRIBUTE,
+  TraceProcessor,
+  TraceSender,
+  TracingSpan,
+  getTracingContext,
+  symbolTracingContext,
+  trace
+});
+//# sourceMappingURL=index.cjs.map

package/dist/lib/node/index.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/index.ts", "../../../src/api.ts", "../../../src/symbols.ts", "../../../src/trace-processor.ts", "../../../src/trace-sender.ts"],
+  "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nexport * from './api';\nexport * from './symbols';\nexport * from './trace-processor';\nexport * from './trace-sender';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { Context } from '@dxos/context';\n\nimport { getTracingContext } from './symbols';\nimport { TRACE_PROCESSOR } from './trace-processor';\n\nconst resource =\n  () =>\n  <T extends { new (...args: any[]): {} }>(constructor: T) => {\n    return class extends constructor {\n      constructor(...rest: any[]) {\n        super(...rest);\n        TRACE_PROCESSOR.traceResourceConstructor({ constructor, instance: this });\n      }\n    };\n  };\n\nconst info = () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => {\n  getTracingContext(target).infoProperties[propertyKey] = {};\n};\n\nconst span = () => (target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any) => any>) => {\n  const method = descriptor.value!;\n\n  descriptor.value = async function (this: any, ...args: any) {\n    const parentCtx = args[0] instanceof Context ? args[0] : null;\n    const span = TRACE_PROCESSOR.traceSpan({ parentCtx, methodName: propertyKey, instance: this });\n\n    const callArgs = span.ctx ? [span.ctx, ...args.slice(1)] : args;\n    try {\n      return await method.apply(this, callArgs);\n    } catch (err) {\n      span.markError(err);\n      throw err;\n    } finally {\n      span.markSuccess();\n    }\n  };\n};\n\nexport type AddLinkOptions = {};\n\nconst addLink = (parent: any, child: any, opts: AddLinkOptions = {}) => {\n  TRACE_PROCESSOR.addLink(parent, child, opts);\n};\n\nexport const trace = {\n  resource,\n  info,\n  span,\n\n  addLink,\n};\n", "//\n// Copyright 2023 DXOS.org\n//\n\nexport const symbolTracingContext = Symbol('dxos.tracing-context');\n\nexport type TracingContext = {\n  infoProperties: Record<string, {}>;\n};\n\nexport const getTracingContext = (target: any): TracingContext => {\n  return (target[symbolTracingContext] ??= {\n    infoProperties: {},\n  });\n};\n\nexport const TRACE_SPAN_ATTRIBUTE = 'dxos.trace-span';\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { Context } from '@dxos/context';\nimport { Error as SerializedError } from '@dxos/protocols/proto/dxos/error';\nimport { Resource, Span } from '@dxos/protocols/proto/dxos/tracing';\nimport { getPrototypeSpecificInstanceId } from '@dxos/util';\n\nimport type { AddLinkOptions } from './api';\nimport { TRACE_SPAN_ATTRIBUTE, getTracingContext } from './symbols';\nimport { TraceSender } from './trace-sender';\n\nexport type TraceResourceConstructorParams = {\n  constructor: { new (...args: any[]): {} };\n  instance: any;\n};\n\nexport type TraceSpanParams = {\n  instance: any;\n  methodName: string;\n  parentCtx: Context | null;\n};\n\nexport type ResourceEntry = {\n  data: Resource;\n  instance: WeakRef<any>;\n};\n\nexport type TraceSubscription = {\n  dirtyResources: Set<number>;\n  dirtySpans: Set<number>;\n};\n\nconst MAX_RESOURCE_RECORDS = 500;\nconst MAX_SPAN_RECORDS = 1_000;\n\nexport class TraceProcessor {\n  resources = new Map<number, ResourceEntry>();\n  resourceInstanceIndex = new WeakMap<any, ResourceEntry>();\n  resourceIdList: number[] = [];\n\n  spans = new Map<number, Span>();\n  spanIdList: number[] = [];\n\n  subscriptions: Set<TraceSubscription> = new Set();\n\n  traceResourceConstructor(params: TraceResourceConstructorParams) {\n    const id = this.resources.size;\n    const entry: ResourceEntry = {\n      data: {\n        id,\n        className: params.constructor.name,\n        instanceId: getPrototypeSpecificInstanceId(params.instance),\n        info: this.getResourceInfo(params.instance),\n        links: [],\n      },\n      instance: new WeakRef(params.instance),\n    };\n    this.resources.set(id, entry);\n    this.resourceInstanceIndex.set(params.instance, entry);\n    this.resourceIdList.push(id);\n    if (this.resourceIdList.length > MAX_RESOURCE_RECORDS) {\n      this._clearResources();\n    }\n    this._markResourceDirty(id);\n  }\n\n  getResourceInfo(instance: any): Record<string, any> {\n    const res: Record<string, any> = {};\n    const tracingContext = getTracingContext(Object.getPrototypeOf(instance));\n\n    for (const [key, _opts] of Object.entries(tracingContext.infoProperties)) {\n      try {\n        res[key] = typeof instance[key] === 'function' ? instance[key]() : instance[key];\n      } catch (err: any) {\n        res[key] = err.message;\n      }\n    }\n\n    return res;\n  }\n\n  traceSpan(params: TraceSpanParams): TracingSpan {\n    const span = new TracingSpan(this, params);\n    this._flushSpan(span);\n    return span;\n  }\n\n  addLink(parent: any, child: any, opts: AddLinkOptions) {}\n\n  getResourceId(instance: any): number | null {\n    const entry = this.resourceInstanceIndex.get(instance);\n    return entry ? entry.data.id : null;\n  }\n\n  createTraceSender() {\n    return new TraceSender(this);\n  }\n\n  /**\n   * @internal\n   */\n  _flushSpan(runtimeSpan: TracingSpan) {\n    const span = runtimeSpan.serialize();\n    this.spans.set(span.id, span);\n    this.spanIdList.push(span.id);\n    if (this.spanIdList.length > MAX_SPAN_RECORDS) {\n      this._clearSpans();\n    }\n    this._markSpanDirty(span.id);\n  }\n\n  private _markResourceDirty(id: number) {\n    for (const subscription of this.subscriptions) {\n      subscription.dirtyResources.add(id);\n    }\n  }\n\n  private _markSpanDirty(id: number) {\n    for (const subscription of this.subscriptions) {\n      subscription.dirtySpans.add(id);\n    }\n  }\n\n  private _clearResources() {\n    // TODO(dmaretskyi): Use FinalizationRegistry to delete finalized resources first.\n    while (this.resourceIdList.length > MAX_RESOURCE_RECORDS) {\n      const id = this.resourceIdList.shift()!;\n      this.resources.delete(id);\n    }\n  }\n\n  private _clearSpans() {\n    while (this.spanIdList.length > MAX_SPAN_RECORDS) {\n      const id = this.spanIdList.shift()!;\n      this.spans.delete(id);\n    }\n  }\n}\n\nexport class TracingSpan {\n  static nextId = 0;\n\n  readonly id: number;\n  readonly parentId: number | null = null;\n  readonly methodName: string;\n  readonly resourceId: number | null = null;\n  startTs: number;\n  endTs: number | null = null;\n  error: SerializedError | null = null;\n\n  private readonly _ctx: Context | null = null;\n\n  constructor(private _traceProcessor: TraceProcessor, params: TraceSpanParams) {\n    this.id = TracingSpan.nextId++;\n    this.methodName = params.methodName;\n    this.resourceId = _traceProcessor.getResourceId(params.instance);\n    this.startTs = performance.now();\n\n    if (params.parentCtx) {\n      this._ctx = params.parentCtx.derive({\n        attributes: {\n          [TRACE_SPAN_ATTRIBUTE]: this.id,\n        },\n      });\n      const parentId = params.parentCtx.getAttribute(TRACE_SPAN_ATTRIBUTE);\n      if (typeof parentId === 'number') {\n        this.parentId = parentId;\n      }\n    }\n  }\n\n  get ctx(): Context | null {\n    return this._ctx;\n  }\n\n  markSuccess() {\n    this.endTs = performance.now();\n    this._traceProcessor._flushSpan(this);\n  }\n\n  markError(err: unknown) {\n    this.endTs = performance.now();\n    this.error = serializeError(err);\n    this._traceProcessor._flushSpan(this);\n  }\n\n  serialize(): Span {\n    return {\n      id: this.id,\n      resourceId: this.resourceId ?? undefined,\n      methodName: this.methodName,\n      parentId: this.parentId ?? undefined,\n      startTs: this.startTs.toFixed(3),\n      endTs: this.endTs?.toFixed(3) ?? undefined,\n      error: this.error ?? undefined,\n    };\n  }\n}\n\nconst serializeError = (err: unknown): SerializedError => {\n  if (err instanceof Error) {\n    return {\n      name: err.name,\n      message: err.message,\n    };\n  }\n\n  return {\n    message: String(err),\n  };\n};\n\nexport const TRACE_PROCESSOR: TraceProcessor = ((globalThis as any).TRACE_PROCESSOR ??= new TraceProcessor());\n", "//\n// Copyright 2023 DXOS.org\n//\n\nimport { Stream } from '@dxos/codec-protobuf';\nimport { StreamTraceEvent, TracingService } from '@dxos/protocols/proto/dxos/tracing';\n\nimport { TraceProcessor, TraceSubscription } from './trace-processor';\n\nconst FLUSH_INTERVAL = 1_000;\n\nexport class TraceSender implements TracingService {\n  constructor(private _traceProcessor: TraceProcessor) {}\n\n  streamTrace(request: void): Stream<StreamTraceEvent> {\n    return new Stream(({ ctx, next }) => {\n      const subscription: TraceSubscription = {\n        dirtyResources: new Set(),\n        dirtySpans: new Set(),\n      };\n      this._traceProcessor.subscriptions.add(subscription);\n      ctx.onDispose(() => {\n        this._traceProcessor.subscriptions.delete(subscription);\n      });\n\n      const flushEvents = (resources: Set<number> | null, spans: Set<number> | null) => {\n        const event: StreamTraceEvent = {\n          resourceAdded: [],\n          resourceRemoved: [],\n          spanAdded: [],\n        };\n\n        if (resources) {\n          for (const id of resources) {\n            const entry = this._traceProcessor.resources.get(id);\n            if (entry) {\n              event.resourceAdded!.push({ resource: entry.data });\n            } else {\n              event.resourceRemoved!.push({ id });\n            }\n          }\n        } else {\n          for (const entry of this._traceProcessor.resources.values()) {\n            event.resourceAdded!.push({ resource: entry.data });\n          }\n        }\n\n        if (spans) {\n          for (const id of spans) {\n            const span = this._traceProcessor.spans.get(id);\n            if (span) {\n              event.spanAdded!.push({ span });\n            }\n          }\n        } else {\n          for (const span of this._traceProcessor.spans.values()) {\n            event.spanAdded!.push({ span });\n          }\n        }\n\n        if (event.resourceAdded!.length > 0 || event.resourceRemoved!.length > 0 || event.spanAdded!.length > 0) {\n          next(event);\n        }\n      };\n\n      flushEvents(null, null);\n\n      const timer = setInterval(() => {\n        flushEvents(subscription.dirtyResources, subscription.dirtySpans);\n        subscription.dirtyResources.clear();\n        subscription.dirtySpans.clear();\n      }, FLUSH_INTERVAL);\n      ctx.onDispose(() => {\n        clearInterval(timer);\n      });\n    });\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["symbolTracingContext", "Symbol", "getTracingContext", "target", "_a", "infoProperties", "TRACE_SPAN_ATTRIBUTE", "FLUSH_INTERVAL", "TraceSender", "constructor", "_traceProcessor", "streamTrace", "request", "Stream", "ctx", "next", "subscription", "dirtyResources", "Set", "dirtySpans", "subscriptions", "add", "onDispose", "delete", "flushEvents", "resources", "spans", "event", "resourceAdded", "resourceRemoved", "spanAdded", "id", "entry", "get", "push", "resource", "data", "values", "span", "length", "timer", "setInterval", "clear", "clearInterval", "MAX_RESOURCE_RECORDS", "MAX_SPAN_RECORDS", "TraceProcessor", "resources", "Map", "resourceInstanceIndex", "WeakMap", "resourceIdList", "spans", "spanIdList", "subscriptions", "Set", "traceResourceConstructor", "params", "id", "size", "entry", "data", "className", "constructor", "name", "instanceId", "getPrototypeSpecificInstanceId", "instance", "info", "getResourceInfo", "links", "WeakRef", "set", "push", "length", "_clearResources", "_markResourceDirty", "res", "tracingContext", "getTracingContext", "Object", "getPrototypeOf", "key", "_opts", "entries", "infoProperties", "err", "message", "traceSpan", "span", "TracingSpan", "_flushSpan", "addLink", "parent", "child", "opts", "getResourceId", "get", "createTraceSender", "TraceSender", "runtimeSpan", "serialize", "_clearSpans", "_markSpanDirty", "subscription", "dirtyResources", "add", "dirtySpans", "shift", "delete", "_traceProcessor", "parentId", "resourceId", "endTs", "error", "_ctx", "nextId", "methodName", "startTs", "performance", "now", "parentCtx", "derive", "attributes", "TRACE_SPAN_ATTRIBUTE", "getAttribute", "ctx", "markSuccess", "markError", "serializeError", "_a", "undefined", "toFixed", "Error", "String", "TRACE_PROCESSOR", "globalThis", "resource", "constructor", "rest", "TRACE_PROCESSOR", "traceResourceConstructor", "instance", "info", "target", "propertyKey", "descriptor", "getTracingContext", "infoProperties", "span", "method", "value", "args", "parentCtx", "Context", "traceSpan", "methodName", "callArgs", "ctx", "slice", "apply", "err", "markError", "markSuccess", "addLink", "parent", "child", "opts", "trace"]
+}

package/dist/lib/node/meta.json

@@ -0,0 +1 @@
+{"inputs":{"packages/common/tracing/src/symbols.ts":{"bytes":1464,"imports":[]},"packages/common/tracing/src/trace-sender.ts":{"bytes":9080,"imports":[{"path":"@dxos/codec-protobuf","kind":"import-statement","external":true}]},"packages/common/tracing/src/trace-processor.ts":{"bytes":20068,"imports":[{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"packages/common/tracing/src/symbols.ts","kind":"import-statement","original":"./symbols"},{"path":"packages/common/tracing/src/trace-sender.ts","kind":"import-statement","original":"./trace-sender"}]},"packages/common/tracing/src/api.ts":{"bytes":5722,"imports":[{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"packages/common/tracing/src/symbols.ts","kind":"import-statement","original":"./symbols"},{"path":"packages/common/tracing/src/trace-processor.ts","kind":"import-statement","original":"./trace-processor"}]},"packages/common/tracing/src/index.ts":{"bytes":744,"imports":[{"path":"packages/common/tracing/src/api.ts","kind":"import-statement","original":"./api"},{"path":"packages/common/tracing/src/symbols.ts","kind":"import-statement","original":"./symbols"},{"path":"packages/common/tracing/src/trace-processor.ts","kind":"import-statement","original":"./trace-processor"},{"path":"packages/common/tracing/src/trace-sender.ts","kind":"import-statement","original":"./trace-sender"}]}},"outputs":{"packages/common/tracing/dist/lib/node/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":18611},"packages/common/tracing/dist/lib/node/index.cjs":{"imports":[{"path":"@dxos/context","kind":"require-call","external":true},{"path":"@dxos/util","kind":"require-call","external":true},{"path":"@dxos/codec-protobuf","kind":"require-call","external":true}],"exports":[],"entryPoint":"packages/common/tracing/src/index.ts","inputs":{"packages/common/tracing/src/index.ts":{"bytesInOutput":415},"packages/common/tracing/src/api.ts":{"bytesInOutput":1176},"packages/common/tracing/src/symbols.ts":{"bytesInOutput":280},"packages/common/tracing/src/trace-processor.ts":{"bytesInOutput":4527},"packages/common/tracing/src/trace-sender.ts":{"bytesInOutput":2265}},"bytes":10044}}}

package/dist/types/src/api.d.ts

@@ -0,0 +1,10 @@
+export type AddLinkOptions = {};
+export declare const trace: {
+    resource: () => <T extends new (...args: any[]) => {}>(constructor: T) => {
+        new (...rest: any[]): {};
+    } & T;
+    info: () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => void;
+    span: () => (target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any) => any>) => void;
+    addLink: (parent: any, child: any, opts?: AddLinkOptions) => void;
+};
+//# sourceMappingURL=api.d.ts.map

package/dist/types/src/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api.ts"],"names":[],"mappings":"AA2CA,MAAM,MAAM,cAAc,GAAG,EAAE,CAAC;AAMhC,eAAO,MAAM,KAAK;6CAtCW,GAAG,EAAE,KAAG,EAAE;sBAEZ,GAAG,EAAE;;yBAOJ,GAAG,eAAe,MAAM,eAAe,kBAAkB;yBAIzD,GAAG,eAAe,MAAM,gDAAgD,GAAG,KAAK,GAAG;sBAqBtF,GAAG,SAAS,GAAG,SAAQ,cAAc;CAU7D,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './api';
+export * from './symbols';
+export * from './trace-processor';
+export * from './trace-sender';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,OAAO,CAAC;AACtB,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/types/src/symbols.d.ts

@@ -0,0 +1,7 @@
+export declare const symbolTracingContext: unique symbol;
+export type TracingContext = {
+    infoProperties: Record<string, {}>;
+};
+export declare const getTracingContext: (target: any) => TracingContext;
+export declare const TRACE_SPAN_ATTRIBUTE = "dxos.trace-span";
+//# sourceMappingURL=symbols.d.ts.map

package/dist/types/src/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../../src/symbols.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAEnE,MAAM,MAAM,cAAc,GAAG;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,WAAY,GAAG,KAAG,cAI/C,CAAC;AAEF,eAAO,MAAM,oBAAoB,oBAAoB,CAAC"}

package/dist/types/src/trace-processor.d.ts

@@ -0,0 +1,61 @@
+import { Context } from '@dxos/context';
+import { Error as SerializedError } from '@dxos/protocols/proto/dxos/error';
+import { Resource, Span } from '@dxos/protocols/proto/dxos/tracing';
+import type { AddLinkOptions } from './api';
+import { TraceSender } from './trace-sender';
+export type TraceResourceConstructorParams = {
+    constructor: {
+        new (...args: any[]): {};
+    };
+    instance: any;
+};
+export type TraceSpanParams = {
+    instance: any;
+    methodName: string;
+    parentCtx: Context | null;
+};
+export type ResourceEntry = {
+    data: Resource;
+    instance: WeakRef<any>;
+};
+export type TraceSubscription = {
+    dirtyResources: Set<number>;
+    dirtySpans: Set<number>;
+};
+export declare class TraceProcessor {
+    resources: Map<number, ResourceEntry>;
+    resourceInstanceIndex: WeakMap<any, ResourceEntry>;
+    resourceIdList: number[];
+    spans: Map<number, Span>;
+    spanIdList: number[];
+    subscriptions: Set<TraceSubscription>;
+    traceResourceConstructor(params: TraceResourceConstructorParams): void;
+    getResourceInfo(instance: any): Record<string, any>;
+    traceSpan(params: TraceSpanParams): TracingSpan;
+    addLink(parent: any, child: any, opts: AddLinkOptions): void;
+    getResourceId(instance: any): number | null;
+    createTraceSender(): TraceSender;
+    private _markResourceDirty;
+    private _markSpanDirty;
+    private _clearResources;
+    private _clearSpans;
+}
+export declare class TracingSpan {
+    private _traceProcessor;
+    static nextId: number;
+    readonly id: number;
+    readonly parentId: number | null;
+    readonly methodName: string;
+    readonly resourceId: number | null;
+    startTs: number;
+    endTs: number | null;
+    error: SerializedError | null;
+    private readonly _ctx;
+    constructor(_traceProcessor: TraceProcessor, params: TraceSpanParams);
+    get ctx(): Context | null;
+    markSuccess(): void;
+    markError(err: unknown): void;
+    serialize(): Span;
+}
+export declare const TRACE_PROCESSOR: TraceProcessor;
+//# sourceMappingURL=trace-processor.d.ts.map

package/dist/types/src/trace-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-processor.d.ts","sourceRoot":"","sources":["../../../src/trace-processor.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,IAAI,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAGpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,8BAA8B,GAAG;IAC3C,WAAW,EAAE;QAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAC1C,QAAQ,EAAE,GAAG,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,GAAG,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACzB,CAAC;AAKF,qBAAa,cAAc;IACzB,SAAS,6BAAoC;IAC7C,qBAAqB,8BAAqC;IAC1D,cAAc,EAAE,MAAM,EAAE,CAAM;IAE9B,KAAK,oBAA2B;IAChC,UAAU,EAAE,MAAM,EAAE,CAAM;IAE1B,aAAa,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAa;IAElD,wBAAwB,CAAC,MAAM,EAAE,8BAA8B;IAqB/D,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAenD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,WAAW;IAM/C,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,cAAc;IAErD,aAAa,CAAC,QAAQ,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAK3C,iBAAiB;IAiBjB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,WAAW;CAMpB;AAED,qBAAa,WAAW;IAaV,OAAO,CAAC,eAAe;IAZnC,MAAM,CAAC,MAAM,SAAK;IAElB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAQ;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwB;gBAEzB,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,eAAe;IAmB5E,IAAI,GAAG,IAAI,OAAO,GAAG,IAAI,CAExB;IAED,WAAW;IAKX,SAAS,CAAC,GAAG,EAAE,OAAO;IAMtB,SAAS,IAAI,IAAI;CAWlB;AAeD,eAAO,MAAM,eAAe,EAAE,cAA+E,CAAC"}

package/dist/types/src/trace-sender.d.ts

@@ -0,0 +1,9 @@
+import { Stream } from '@dxos/codec-protobuf';
+import { StreamTraceEvent, TracingService } from '@dxos/protocols/proto/dxos/tracing';
+import { TraceProcessor } from './trace-processor';
+export declare class TraceSender implements TracingService {
+    private _traceProcessor;
+    constructor(_traceProcessor: TraceProcessor);
+    streamTrace(request: void): Stream<StreamTraceEvent>;
+}
+//# sourceMappingURL=trace-sender.d.ts.map

package/dist/types/src/trace-sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-sender.d.ts","sourceRoot":"","sources":["../../../src/trace-sender.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEtF,OAAO,EAAE,cAAc,EAAqB,MAAM,mBAAmB,CAAC;AAItE,qBAAa,WAAY,YAAW,cAAc;IACpC,OAAO,CAAC,eAAe;gBAAf,eAAe,EAAE,cAAc;IAEnD,WAAW,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,gBAAgB,CAAC;CA+DrD"}

package/dist/types/src/tracing.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tracing.test.d.ts.map

package/dist/types/src/tracing.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.test.d.ts","sourceRoot":"","sources":["../../../src/tracing.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@dxos/tracing",
+  "version": "0.1.56-main.d9d1c3e",
+  "description": "Async utilities.",
+  "homepage": "https://dxos.org",
+  "bugs": "https://github.com/dxos/dxos/issues",
+  "license": "MIT",
+  "author": "DXOS.org",
+  "main": "dist/lib/node/index.cjs",
+  "browser": {
+    "./dist/lib/node/index.cjs": "./dist/lib/browser/index.mjs"
+  },
+  "types": "dist/types/src/index.d.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@dxos/codec-protobuf": "0.1.56-main.d9d1c3e",
+    "@dxos/context": "0.1.56-main.d9d1c3e",
+    "@dxos/debug": "0.1.56-main.d9d1c3e",
+    "@dxos/invariant": "0.1.56-main.d9d1c3e",
+    "@dxos/log": "0.1.56-main.d9d1c3e",
+    "@dxos/node-std": "0.1.56-main.d9d1c3e",
+    "@dxos/protocols": "0.1.56-main.d9d1c3e",
+    "@dxos/util": "0.1.56-main.d9d1c3e"
+  },
+  "devDependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/api.ts

@@ -0,0 +1,56 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+import { Context } from '@dxos/context';
+
+import { getTracingContext } from './symbols';
+import { TRACE_PROCESSOR } from './trace-processor';
+
+const resource =
+  () =>
+  <T extends { new (...args: any[]): {} }>(constructor: T) => {
+    return class extends constructor {
+      constructor(...rest: any[]) {
+        super(...rest);
+        TRACE_PROCESSOR.traceResourceConstructor({ constructor, instance: this });
+      }
+    };
+  };
+
+const info = () => (target: any, propertyKey: string, descriptor?: PropertyDescriptor) => {
+  getTracingContext(target).infoProperties[propertyKey] = {};
+};
+
+const span = () => (target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any) => any>) => {
+  const method = descriptor.value!;
+
+  descriptor.value = async function (this: any, ...args: any) {
+    const parentCtx = args[0] instanceof Context ? args[0] : null;
+    const span = TRACE_PROCESSOR.traceSpan({ parentCtx, methodName: propertyKey, instance: this });
+
+    const callArgs = span.ctx ? [span.ctx, ...args.slice(1)] : args;
+    try {
+      return await method.apply(this, callArgs);
+    } catch (err) {
+      span.markError(err);
+      throw err;
+    } finally {
+      span.markSuccess();
+    }
+  };
+};
+
+export type AddLinkOptions = {};
+
+const addLink = (parent: any, child: any, opts: AddLinkOptions = {}) => {
+  TRACE_PROCESSOR.addLink(parent, child, opts);
+};
+
+export const trace = {
+  resource,
+  info,
+  span,
+
+  addLink,
+};

package/src/index.ts

@@ -0,0 +1,8 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export * from './api';
+export * from './symbols';
+export * from './trace-processor';
+export * from './trace-sender';

package/src/symbols.ts

@@ -0,0 +1,17 @@
+//
+// Copyright 2023 DXOS.org
+//
+
+export const symbolTracingContext = Symbol('dxos.tracing-context');
+
+export type TracingContext = {
+  infoProperties: Record<string, {}>;
+};
+
+export const getTracingContext = (target: any): TracingContext => {
+  return (target[symbolTracingContext] ??= {
+    infoProperties: {},
+  });
+};
+
+export const TRACE_SPAN_ATTRIBUTE = 'dxos.trace-span';