@itwin/core-bentley 3.4.0-dev.9 → 3.5.0-dev.4

package/lib/esm/Tracing.d.ts

@@ -1,41 +1,41 @@
-import type { Attributes, SpanContext, SpanOptions, Tracer } from "@opentelemetry/api";
-/**
- * Mirrors the SpanKind enum from [@opentelemetry/api](https://open-telemetry.github.io/opentelemetry-js-api/enums/spankind)
- * @alpha
- */
-export declare enum SpanKind {
-    INTERNAL = 0,
-    SERVER = 1,
-    CLIENT = 2,
-    PRODUCER = 3,
-    CONSUMER = 4
-}
-/**
- * Enables OpenTelemetry tracing in addition to traditional logging.
- * @alpha
- */
-export declare class Tracing {
-    private static _tracer?;
-    private static _openTelemetry?;
-    /**
-     * If OpenTelemetry tracing is enabled, creates a new span and runs the provided function in it.
-     * If OpenTelemetry tracing is _not_ enabled, runs the provided function.
-     * @param name name of the new span
-     * @param fn function to run inside the new span
-     * @param options span options
-     * @param parentContext optional context used to retrieve parent span id
-     */
-    static withSpan<T>(name: string, fn: () => Promise<T>, options?: SpanOptions, parentContext?: SpanContext): Promise<T>;
-    /**
-     * Enable logging to OpenTelemetry. [[Tracing.withSpan]] will be enabled, all log entries will be attached to active span as span events.
-     * [[IModelHost.startup]] will call this automatically if it succeeds in requiring `@opentelemetry/api`.
-     * @note Node.js OpenTelemetry SDK should be initialized by the user.
-     */
-    static enableOpenTelemetry(tracer: Tracer, api: typeof Tracing._openTelemetry): void;
-    private static withOpenTelemetry;
-    /** Set attributes on currently active openTelemetry span. Doesn't do anything if openTelemetry logging is not initialized.
-     * @param attributes  The attributes to set
-     */
-    static setAttributes(attributes: Attributes): void;
-}
+import type { SpanAttributes, SpanContext, SpanOptions, Tracer } from "@opentelemetry/api";
+/**
+ * Mirrors the SpanKind enum from [@opentelemetry/api](https://open-telemetry.github.io/opentelemetry-js-api/enums/spankind)
+ * @alpha
+ */
+export declare enum SpanKind {
+    INTERNAL = 0,
+    SERVER = 1,
+    CLIENT = 2,
+    PRODUCER = 3,
+    CONSUMER = 4
+}
+/**
+ * Enables OpenTelemetry tracing in addition to traditional logging.
+ * @alpha
+ */
+export declare class Tracing {
+    private static _tracer?;
+    private static _openTelemetry?;
+    /**
+     * If OpenTelemetry tracing is enabled, creates a new span and runs the provided function in it.
+     * If OpenTelemetry tracing is _not_ enabled, runs the provided function.
+     * @param name name of the new span
+     * @param fn function to run inside the new span
+     * @param options span options
+     * @param parentContext optional context used to retrieve parent span id
+     */
+    static withSpan<T>(name: string, fn: () => Promise<T>, options?: SpanOptions, parentContext?: SpanContext): Promise<T>;
+    /**
+     * Enable logging to OpenTelemetry. [[Tracing.withSpan]] will be enabled, all log entries will be attached to active span as span events.
+     * [[IModelHost.startup]] will call this automatically if it succeeds in requiring `@opentelemetry/api`.
+     * @note Node.js OpenTelemetry SDK should be initialized by the user.
+     */
+    static enableOpenTelemetry(tracer: Tracer, api: typeof Tracing._openTelemetry): void;
+    private static withOpenTelemetry;
+    /** Set attributes on currently active openTelemetry span. Doesn't do anything if openTelemetry logging is not initialized.
+     * @param attributes  The attributes to set
+     */
+    static setAttributes(attributes: SpanAttributes): void;
+}
 //# sourceMappingURL=Tracing.d.ts.map

package/lib/esm/Tracing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Tracing.d.ts","sourceRoot":"","sources":["../../src/Tracing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAA8B,WAAW,EAAE,WAAW,EAAY,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI7H;;;GAGG;AACH,oBAAY,QAAQ;IAClB,QAAQ,IAAI;IACZ,MAAM,IAAI;IACV,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,QAAQ,IAAI;CACb;AA2DD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAoH;IAElJ;;;;;;;OAOG;WACiB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA4BnI;;;;OAIG;WACW,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,OAAO,CAAC,cAAc;IASpF,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAOhC;;OAEG;WACW,aAAa,CAAC,UAAU,EAAE,UAAU;CAGnD"}
+{"version":3,"file":"Tracing.d.ts","sourceRoot":"","sources":["../../src/Tracing.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,cAAc,EAAsB,WAAW,EAAE,WAAW,EAAY,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIrI;;;GAGG;AACH,oBAAY,QAAQ;IAClB,QAAQ,IAAI;IACZ,MAAM,IAAI;IACV,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,QAAQ,IAAI;CACb;AA2DD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,CAAoH;IAElJ;;;;;;;OAOG;WACiB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA4BnI;;;;OAIG;WACW,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,OAAO,CAAC,cAAc;IASpF,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAShC;;OAEG;WACW,aAAa,CAAC,UAAU,EAAE,cAAc;CAGvD"}

package/lib/esm/Tracing.js

@@ -1,124 +1,127 @@
-import { Logger } from "./Logger";
-// re-export so that consumers can construct full SpanOptions object without external dependencies
-/**
- * Mirrors the SpanKind enum from [@opentelemetry/api](https://open-telemetry.github.io/opentelemetry-js-api/enums/spankind)
- * @alpha
- */
-export var SpanKind;
-(function (SpanKind) {
-    SpanKind[SpanKind["INTERNAL"] = 0] = "INTERNAL";
-    SpanKind[SpanKind["SERVER"] = 1] = "SERVER";
-    SpanKind[SpanKind["CLIENT"] = 2] = "CLIENT";
-    SpanKind[SpanKind["PRODUCER"] = 3] = "PRODUCER";
-    SpanKind[SpanKind["CONSUMER"] = 4] = "CONSUMER";
-})(SpanKind || (SpanKind = {}));
-function isValidPrimitive(val) {
-    return typeof val === "string" || typeof val === "number" || typeof val === "boolean";
-}
-// Only _homogenous_ arrays of strings, numbers, or booleans are supported as OpenTelemetry Attribute values.
-// Per the spec (https://opentelemetry.io/docs/reference/specification/common/common/#attribute), empty arrays and null values are supported too.
-function isValidPrimitiveArray(val) {
-    if (!Array.isArray(val))
-        return false;
-    let itemType;
-    for (const x of val) {
-        if (x === undefined || x === null)
-            continue;
-        if (!itemType) {
-            itemType = typeof x;
-            if (!isValidPrimitive(x))
-                return false;
-        }
-        if (typeof x !== itemType)
-            return false;
-    }
-    return true;
-}
-function isPlainObject(obj) {
-    return typeof obj === "object" && obj !== null && Object.getPrototypeOf(obj) === Object.prototype;
-}
-function* getFlatEntries(obj, path = "") {
-    if (isValidPrimitiveArray(obj)) {
-        yield [path, obj];
-        return;
-    }
-    // Prefer JSON serialization over flattening for any non-POJO types.
-    // There's just too many ways trying to flatten those can go wrong (Dates, Buffers, TypedArrays, etc.)
-    if (!isPlainObject(obj) && !Array.isArray(obj)) {
-        yield [path, isValidPrimitive(obj) ? obj : JSON.stringify(obj)];
-        return;
-    }
-    // Always serialize empty objects/arrays as empty array values
-    const entries = Object.entries(obj);
-    if (entries.length === 0)
-        yield [path, []];
-    for (const [key, val] of entries)
-        yield* getFlatEntries(val, (path === "") ? key : `${path}.${key}`);
-}
-function flattenObject(obj) {
-    return Object.fromEntries(getFlatEntries(obj));
-}
-/**
- * Enables OpenTelemetry tracing in addition to traditional logging.
- * @alpha
- */
-export class Tracing {
-    /**
-     * If OpenTelemetry tracing is enabled, creates a new span and runs the provided function in it.
-     * If OpenTelemetry tracing is _not_ enabled, runs the provided function.
-     * @param name name of the new span
-     * @param fn function to run inside the new span
-     * @param options span options
-     * @param parentContext optional context used to retrieve parent span id
-     */
-    static async withSpan(name, fn, options, parentContext) {
-        if (Tracing._tracer === undefined || Tracing._openTelemetry === undefined)
-            return fn();
-        // this case is for context propagation - parentContext is typically constructed from HTTP headers
-        const parent = parentContext === undefined
-            ? Tracing._openTelemetry.context.active()
-            : Tracing._openTelemetry.trace.setSpanContext(Tracing._openTelemetry.context.active(), parentContext);
-        return Tracing._openTelemetry.context.with(Tracing._openTelemetry.trace.setSpan(parent, Tracing._tracer.startSpan(name, options, Tracing._openTelemetry.context.active())), async () => {
-            var _a, _b, _c, _d;
-            try {
-                return await fn();
-            }
-            catch (err) {
-                if (err instanceof Error) // ignore non-Error throws, such as RpcControlResponse
-                    (_b = (_a = Tracing._openTelemetry) === null || _a === void 0 ? void 0 : _a.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _b === void 0 ? void 0 : _b.setAttribute("error", true);
-                throw err;
-            }
-            finally {
-                (_d = (_c = Tracing._openTelemetry) === null || _c === void 0 ? void 0 : _c.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _d === void 0 ? void 0 : _d.end();
-            }
-        });
-    }
-    /**
-     * Enable logging to OpenTelemetry. [[Tracing.withSpan]] will be enabled, all log entries will be attached to active span as span events.
-     * [[IModelHost.startup]] will call this automatically if it succeeds in requiring `@opentelemetry/api`.
-     * @note Node.js OpenTelemetry SDK should be initialized by the user.
-     */
-    static enableOpenTelemetry(tracer, api) {
-        Tracing._tracer = tracer;
-        Tracing._openTelemetry = api;
-        Logger.logTrace = Tracing.withOpenTelemetry(Logger.logTrace);
-        Logger.logInfo = Tracing.withOpenTelemetry(Logger.logInfo);
-        Logger.logWarning = Tracing.withOpenTelemetry(Logger.logWarning);
-        Logger.logError = Tracing.withOpenTelemetry(Logger.logError);
-    }
-    static withOpenTelemetry(base, isError = false) {
-        return (category, message, metaData) => {
-            var _a, _b;
-            (_b = (_a = Tracing._openTelemetry) === null || _a === void 0 ? void 0 : _a.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _b === void 0 ? void 0 : _b.addEvent(message, { ...flattenObject(Logger.getMetaData(metaData)), error: isError });
-            base(category, message, metaData);
-        };
-    }
-    /** Set attributes on currently active openTelemetry span. Doesn't do anything if openTelemetry logging is not initialized.
-     * @param attributes  The attributes to set
-     */
-    static setAttributes(attributes) {
-        var _a, _b;
-        (_b = (_a = Tracing._openTelemetry) === null || _a === void 0 ? void 0 : _a.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _b === void 0 ? void 0 : _b.setAttributes(attributes);
-    }
-}
+import { Logger } from "./Logger";
+// re-export so that consumers can construct full SpanOptions object without external dependencies
+/**
+ * Mirrors the SpanKind enum from [@opentelemetry/api](https://open-telemetry.github.io/opentelemetry-js-api/enums/spankind)
+ * @alpha
+ */
+export var SpanKind;
+(function (SpanKind) {
+    SpanKind[SpanKind["INTERNAL"] = 0] = "INTERNAL";
+    SpanKind[SpanKind["SERVER"] = 1] = "SERVER";
+    SpanKind[SpanKind["CLIENT"] = 2] = "CLIENT";
+    SpanKind[SpanKind["PRODUCER"] = 3] = "PRODUCER";
+    SpanKind[SpanKind["CONSUMER"] = 4] = "CONSUMER";
+})(SpanKind || (SpanKind = {}));
+function isValidPrimitive(val) {
+    return typeof val === "string" || typeof val === "number" || typeof val === "boolean";
+}
+// Only _homogenous_ arrays of strings, numbers, or booleans are supported as OpenTelemetry Attribute values.
+// Per the spec (https://opentelemetry.io/docs/reference/specification/common/common/#attribute), empty arrays and null values are supported too.
+function isValidPrimitiveArray(val) {
+    if (!Array.isArray(val))
+        return false;
+    let itemType;
+    for (const x of val) {
+        if (x === undefined || x === null)
+            continue;
+        if (!itemType) {
+            itemType = typeof x;
+            if (!isValidPrimitive(x))
+                return false;
+        }
+        if (typeof x !== itemType)
+            return false;
+    }
+    return true;
+}
+function isPlainObject(obj) {
+    return typeof obj === "object" && obj !== null && Object.getPrototypeOf(obj) === Object.prototype;
+}
+function* getFlatEntries(obj, path = "") {
+    if (isValidPrimitiveArray(obj)) {
+        yield [path, obj];
+        return;
+    }
+    // Prefer JSON serialization over flattening for any non-POJO types.
+    // There's just too many ways trying to flatten those can go wrong (Dates, Buffers, TypedArrays, etc.)
+    if (!isPlainObject(obj) && !Array.isArray(obj)) {
+        yield [path, isValidPrimitive(obj) ? obj : JSON.stringify(obj)];
+        return;
+    }
+    // Always serialize empty objects/arrays as empty array values
+    const entries = Object.entries(obj);
+    if (entries.length === 0)
+        yield [path, []];
+    for (const [key, val] of entries)
+        yield* getFlatEntries(val, (path === "") ? key : `${path}.${key}`);
+}
+function flattenObject(obj) {
+    return Object.fromEntries(getFlatEntries(obj));
+}
+/**
+ * Enables OpenTelemetry tracing in addition to traditional logging.
+ * @alpha
+ */
+export class Tracing {
+    /**
+     * If OpenTelemetry tracing is enabled, creates a new span and runs the provided function in it.
+     * If OpenTelemetry tracing is _not_ enabled, runs the provided function.
+     * @param name name of the new span
+     * @param fn function to run inside the new span
+     * @param options span options
+     * @param parentContext optional context used to retrieve parent span id
+     */
+    static async withSpan(name, fn, options, parentContext) {
+        if (Tracing._tracer === undefined || Tracing._openTelemetry === undefined)
+            return fn();
+        // this case is for context propagation - parentContext is typically constructed from HTTP headers
+        const parent = parentContext === undefined
+            ? Tracing._openTelemetry.context.active()
+            : Tracing._openTelemetry.trace.setSpanContext(Tracing._openTelemetry.context.active(), parentContext);
+        return Tracing._openTelemetry.context.with(Tracing._openTelemetry.trace.setSpan(parent, Tracing._tracer.startSpan(name, options, Tracing._openTelemetry.context.active())), async () => {
+            var _a, _b, _c, _d;
+            try {
+                return await fn();
+            }
+            catch (err) {
+                if (err instanceof Error) // ignore non-Error throws, such as RpcControlResponse
+                    (_b = (_a = Tracing._openTelemetry) === null || _a === void 0 ? void 0 : _a.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _b === void 0 ? void 0 : _b.setAttribute("error", true);
+                throw err;
+            }
+            finally {
+                (_d = (_c = Tracing._openTelemetry) === null || _c === void 0 ? void 0 : _c.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _d === void 0 ? void 0 : _d.end();
+            }
+        });
+    }
+    /**
+     * Enable logging to OpenTelemetry. [[Tracing.withSpan]] will be enabled, all log entries will be attached to active span as span events.
+     * [[IModelHost.startup]] will call this automatically if it succeeds in requiring `@opentelemetry/api`.
+     * @note Node.js OpenTelemetry SDK should be initialized by the user.
+     */
+    static enableOpenTelemetry(tracer, api) {
+        Tracing._tracer = tracer;
+        Tracing._openTelemetry = api;
+        Logger.logTrace = Tracing.withOpenTelemetry(Logger.logTrace);
+        Logger.logInfo = Tracing.withOpenTelemetry(Logger.logInfo);
+        Logger.logWarning = Tracing.withOpenTelemetry(Logger.logWarning);
+        Logger.logError = Tracing.withOpenTelemetry(Logger.logError);
+    }
+    static withOpenTelemetry(base, isError = false) {
+        return (category, message, metaData) => {
+            var _a, _b;
+            try {
+                (_b = (_a = Tracing._openTelemetry) === null || _a === void 0 ? void 0 : _a.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _b === void 0 ? void 0 : _b.addEvent(message, { ...flattenObject(Logger.getMetaData(metaData)), error: isError });
+            }
+            catch (_e) { } // avoid throwing random errors (with stack trace mangled by async hooks) when openTelemetry collector doesn't work
+            base(category, message, metaData);
+        };
+    }
+    /** Set attributes on currently active openTelemetry span. Doesn't do anything if openTelemetry logging is not initialized.
+     * @param attributes  The attributes to set
+     */
+    static setAttributes(attributes) {
+        var _a, _b;
+        (_b = (_a = Tracing._openTelemetry) === null || _a === void 0 ? void 0 : _a.trace.getSpan(Tracing._openTelemetry.context.active())) === null || _b === void 0 ? void 0 : _b.setAttributes(attributes);
+    }
+}
 //# sourceMappingURL=Tracing.js.map

package/lib/esm/Tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tracing.js","sourceRoot":"","sources":["../../src/Tracing.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\nimport type { Attributes, AttributeValue, ContextAPI, SpanContext, SpanOptions, TraceAPI, Tracer } from \"@opentelemetry/api\";\r\nimport { LogFunction, Logger } from \"./Logger\";\r\n\r\n// re-export so that consumers can construct full SpanOptions object without external dependencies\r\n/**\r\n * Mirrors the SpanKind enum from [@opentelemetry/api](https://open-telemetry.github.io/opentelemetry-js-api/enums/spankind)\r\n * @alpha\r\n */\r\nexport enum SpanKind {\r\n  INTERNAL = 0,\r\n  SERVER = 1,\r\n  CLIENT = 2,\r\n  PRODUCER = 3,\r\n  CONSUMER = 4\r\n}\r\n\r\nfunction isValidPrimitive(val: unknown): val is AttributeValue {\r\n  return typeof val === \"string\" || typeof val === \"number\" || typeof val === \"boolean\";\r\n}\r\n\r\n// Only _homogenous_ arrays of strings, numbers, or booleans are supported as OpenTelemetry Attribute values.\r\n// Per the spec (https://opentelemetry.io/docs/reference/specification/common/common/#attribute), empty arrays and null values are supported too.\r\nfunction isValidPrimitiveArray(val: unknown): val is AttributeValue {\r\n  if (!Array.isArray(val))\r\n    return false;\r\n\r\n  let itemType;\r\n  for (const x of val) {\r\n    if (x === undefined || x === null)\r\n      continue;\r\n\r\n    if (!itemType) {\r\n      itemType = typeof x;\r\n      if (!isValidPrimitive(x))\r\n        return false;\r\n    }\r\n\r\n    if (typeof x !== itemType)\r\n      return false;\r\n  }\r\n  return true;\r\n}\r\n\r\nfunction isPlainObject(obj: unknown): obj is object {\r\n  return typeof obj === \"object\" && obj !== null && Object.getPrototypeOf(obj) === Object.prototype;\r\n}\r\n\r\nfunction* getFlatEntries(obj: unknown, path = \"\"): Iterable<[string, AttributeValue]> {\r\n  if (isValidPrimitiveArray(obj)) {\r\n    yield [path, obj];\r\n    return;\r\n  }\r\n\r\n  // Prefer JSON serialization over flattening for any non-POJO types.\r\n  // There's just too many ways trying to flatten those can go wrong (Dates, Buffers, TypedArrays, etc.)\r\n  if (!isPlainObject(obj) && !Array.isArray(obj)) {\r\n    yield [path, isValidPrimitive(obj) ? obj : JSON.stringify(obj)];\r\n    return;\r\n  }\r\n\r\n  // Always serialize empty objects/arrays as empty array values\r\n  const entries = Object.entries(obj);\r\n  if (entries.length === 0)\r\n    yield [path, []];\r\n\r\n  for (const [key, val] of entries)\r\n    yield* getFlatEntries(val, (path === \"\") ? key : `${path}.${key}`);\r\n}\r\n\r\nfunction flattenObject(obj: object): Attributes {\r\n  return Object.fromEntries(getFlatEntries(obj));\r\n}\r\n\r\n/**\r\n * Enables OpenTelemetry tracing in addition to traditional logging.\r\n * @alpha\r\n */\r\nexport class Tracing {\r\n  private static _tracer?: Tracer;\r\n  private static _openTelemetry?: { trace: Pick<TraceAPI, \"setSpan\" | \"setSpanContext\" | \"getSpan\">, context: Pick<ContextAPI, \"active\" | \"with\"> };\r\n\r\n  /**\r\n   * If OpenTelemetry tracing is enabled, creates a new span and runs the provided function in it.\r\n   * If OpenTelemetry tracing is _not_ enabled, runs the provided function.\r\n   * @param name name of the new span\r\n   * @param fn function to run inside the new span\r\n   * @param options span options\r\n   * @param parentContext optional context used to retrieve parent span id\r\n   */\r\n  public static async withSpan<T>(name: string, fn: () => Promise<T>, options?: SpanOptions, parentContext?: SpanContext): Promise<T> {\r\n    if (Tracing._tracer === undefined || Tracing._openTelemetry === undefined)\r\n      return fn();\r\n\r\n    // this case is for context propagation - parentContext is typically constructed from HTTP headers\r\n    const parent = parentContext === undefined\r\n      ? Tracing._openTelemetry.context.active()\r\n      : Tracing._openTelemetry.trace.setSpanContext(Tracing._openTelemetry.context.active(), parentContext);\r\n\r\n    return Tracing._openTelemetry.context.with(\r\n      Tracing._openTelemetry.trace.setSpan(\r\n        parent,\r\n        Tracing._tracer.startSpan(name, options, Tracing._openTelemetry.context.active())\r\n      ),\r\n      async () => {\r\n        try {\r\n          return await fn();\r\n        } catch (err) {\r\n          if (err instanceof Error) // ignore non-Error throws, such as RpcControlResponse\r\n            Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.setAttribute(\"error\", true);\r\n          throw err;\r\n        } finally {\r\n          Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.end();\r\n        }\r\n      },\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Enable logging to OpenTelemetry. [[Tracing.withSpan]] will be enabled, all log entries will be attached to active span as span events.\r\n   * [[IModelHost.startup]] will call this automatically if it succeeds in requiring `@opentelemetry/api`.\r\n   * @note Node.js OpenTelemetry SDK should be initialized by the user.\r\n   */\r\n  public static enableOpenTelemetry(tracer: Tracer, api: typeof Tracing._openTelemetry) {\r\n    Tracing._tracer = tracer;\r\n    Tracing._openTelemetry = api;\r\n    Logger.logTrace = Tracing.withOpenTelemetry(Logger.logTrace);\r\n    Logger.logInfo = Tracing.withOpenTelemetry(Logger.logInfo);\r\n    Logger.logWarning = Tracing.withOpenTelemetry(Logger.logWarning);\r\n    Logger.logError = Tracing.withOpenTelemetry(Logger.logError);\r\n  }\r\n\r\n  private static withOpenTelemetry(base: LogFunction, isError: boolean = false): LogFunction {\r\n    return (category, message, metaData) => {\r\n      Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.addEvent(message, { ...flattenObject(Logger.getMetaData(metaData)), error: isError });\r\n      base(category, message, metaData);\r\n    };\r\n  }\r\n\r\n  /** Set attributes on currently active openTelemetry span. Doesn't do anything if openTelemetry logging is not initialized.\r\n   * @param attributes  The attributes to set\r\n   */\r\n  public static setAttributes(attributes: Attributes) {\r\n    Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.setAttributes(attributes);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"Tracing.js","sourceRoot":"","sources":["../../src/Tracing.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\nimport type { ContextAPI, SpanAttributes, SpanAttributeValue, SpanContext, SpanOptions, TraceAPI, Tracer } from \"@opentelemetry/api\";\nimport { LogFunction, Logger } from \"./Logger\";\n\n// re-export so that consumers can construct full SpanOptions object without external dependencies\n/**\n * Mirrors the SpanKind enum from [@opentelemetry/api](https://open-telemetry.github.io/opentelemetry-js-api/enums/spankind)\n * @alpha\n */\nexport enum SpanKind {\n  INTERNAL = 0,\n  SERVER = 1,\n  CLIENT = 2,\n  PRODUCER = 3,\n  CONSUMER = 4\n}\n\nfunction isValidPrimitive(val: unknown): val is SpanAttributeValue {\n  return typeof val === \"string\" || typeof val === \"number\" || typeof val === \"boolean\";\n}\n\n// Only _homogenous_ arrays of strings, numbers, or booleans are supported as OpenTelemetry Attribute values.\n// Per the spec (https://opentelemetry.io/docs/reference/specification/common/common/#attribute), empty arrays and null values are supported too.\nfunction isValidPrimitiveArray(val: unknown): val is SpanAttributeValue {\n  if (!Array.isArray(val))\n    return false;\n\n  let itemType;\n  for (const x of val) {\n    if (x === undefined || x === null)\n      continue;\n\n    if (!itemType) {\n      itemType = typeof x;\n      if (!isValidPrimitive(x))\n        return false;\n    }\n\n    if (typeof x !== itemType)\n      return false;\n  }\n  return true;\n}\n\nfunction isPlainObject(obj: unknown): obj is object {\n  return typeof obj === \"object\" && obj !== null && Object.getPrototypeOf(obj) === Object.prototype;\n}\n\nfunction* getFlatEntries(obj: unknown, path = \"\"): Iterable<[string, SpanAttributeValue]> {\n  if (isValidPrimitiveArray(obj)) {\n    yield [path, obj];\n    return;\n  }\n\n  // Prefer JSON serialization over flattening for any non-POJO types.\n  // There's just too many ways trying to flatten those can go wrong (Dates, Buffers, TypedArrays, etc.)\n  if (!isPlainObject(obj) && !Array.isArray(obj)) {\n    yield [path, isValidPrimitive(obj) ? obj : JSON.stringify(obj)];\n    return;\n  }\n\n  // Always serialize empty objects/arrays as empty array values\n  const entries = Object.entries(obj);\n  if (entries.length === 0)\n    yield [path, []];\n\n  for (const [key, val] of entries)\n    yield* getFlatEntries(val, (path === \"\") ? key : `${path}.${key}`);\n}\n\nfunction flattenObject(obj: object): SpanAttributes {\n  return Object.fromEntries(getFlatEntries(obj));\n}\n\n/**\n * Enables OpenTelemetry tracing in addition to traditional logging.\n * @alpha\n */\nexport class Tracing {\n  private static _tracer?: Tracer;\n  private static _openTelemetry?: { trace: Pick<TraceAPI, \"setSpan\" | \"setSpanContext\" | \"getSpan\">, context: Pick<ContextAPI, \"active\" | \"with\"> };\n\n  /**\n   * If OpenTelemetry tracing is enabled, creates a new span and runs the provided function in it.\n   * If OpenTelemetry tracing is _not_ enabled, runs the provided function.\n   * @param name name of the new span\n   * @param fn function to run inside the new span\n   * @param options span options\n   * @param parentContext optional context used to retrieve parent span id\n   */\n  public static async withSpan<T>(name: string, fn: () => Promise<T>, options?: SpanOptions, parentContext?: SpanContext): Promise<T> {\n    if (Tracing._tracer === undefined || Tracing._openTelemetry === undefined)\n      return fn();\n\n    // this case is for context propagation - parentContext is typically constructed from HTTP headers\n    const parent = parentContext === undefined\n      ? Tracing._openTelemetry.context.active()\n      : Tracing._openTelemetry.trace.setSpanContext(Tracing._openTelemetry.context.active(), parentContext);\n\n    return Tracing._openTelemetry.context.with(\n      Tracing._openTelemetry.trace.setSpan(\n        parent,\n        Tracing._tracer.startSpan(name, options, Tracing._openTelemetry.context.active())\n      ),\n      async () => {\n        try {\n          return await fn();\n        } catch (err) {\n          if (err instanceof Error) // ignore non-Error throws, such as RpcControlResponse\n            Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.setAttribute(\"error\", true);\n          throw err;\n        } finally {\n          Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.end();\n        }\n      },\n    );\n  }\n\n  /**\n   * Enable logging to OpenTelemetry. [[Tracing.withSpan]] will be enabled, all log entries will be attached to active span as span events.\n   * [[IModelHost.startup]] will call this automatically if it succeeds in requiring `@opentelemetry/api`.\n   * @note Node.js OpenTelemetry SDK should be initialized by the user.\n   */\n  public static enableOpenTelemetry(tracer: Tracer, api: typeof Tracing._openTelemetry) {\n    Tracing._tracer = tracer;\n    Tracing._openTelemetry = api;\n    Logger.logTrace = Tracing.withOpenTelemetry(Logger.logTrace);\n    Logger.logInfo = Tracing.withOpenTelemetry(Logger.logInfo);\n    Logger.logWarning = Tracing.withOpenTelemetry(Logger.logWarning);\n    Logger.logError = Tracing.withOpenTelemetry(Logger.logError);\n  }\n\n  private static withOpenTelemetry(base: LogFunction, isError: boolean = false): LogFunction {\n    return (category, message, metaData) => {\n      try {\n        Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.addEvent(message, { ...flattenObject(Logger.getMetaData(metaData)), error: isError });\n      } catch (_e) { } // avoid throwing random errors (with stack trace mangled by async hooks) when openTelemetry collector doesn't work\n      base(category, message, metaData);\n    };\n  }\n\n  /** Set attributes on currently active openTelemetry span. Doesn't do anything if openTelemetry logging is not initialized.\n   * @param attributes  The attributes to set\n   */\n  public static setAttributes(attributes: SpanAttributes) {\n    Tracing._openTelemetry?.trace.getSpan(Tracing._openTelemetry.context.active())?.setAttributes(attributes);\n  }\n}\n"]}

package/lib/esm/TypedArrayBuilder.d.ts

@@ -0,0 +1,98 @@
+/** @packageDocumentation
+ * @module Collections
+ */
+import { Constructor } from "./UtilityTypes";
+/** Options used to construct a [[TypedArrayBuilder]].
+ * @public
+ */
+export interface TypedArrayBuilderOptions {
+    /** Controls how much additional memory is allocated when the TypedArray needs to be resized to accomodate more elements.
+     * [[TypedArrayBuilder.ensureCapacity]] multiplies the required capacity by this factor to determine the new capacity.
+     * Default: 1.5
+     * Minimum: 1.0, which causes the TypedArray to allocate exactly the space it needs each time it is resized.
+     */
+    growthFactor?: number;
+    /** The number of elements to allocate memory for in the TypedArray when creating the builder.
+     * If you know the minimum number of elements you intend to add to the builder, you should specify that as the
+     * initial capacity to avoid reallocations when populating the array.
+     * Default: 0.
+     * Minimum: 0.
+     */
+    initialCapacity?: number;
+}
+/** Incrementally builds a [TypedArray] of unsigned 8-, 16-, or 32-bit integers.
+ * Sometimes you wish to populate a `TypedArray`, but you don't know how many elements you will need.
+ * `TypedArray` requires you to specify the size upon construction, and does not permit you to change the size later.
+ *
+ * `TypedArrayBuilder` manages a `TypedArray`, permitting you to [[push]] and [[append]] elements to it. It exposes two "size" properties":
+ *  - [[capacity]], the number of elements it has currently allocated space for - i.e., the length of the underlying TypedArray; and
+ *  - [[length]], the number of elements that have so far been added to it, which is never bigger than [[capacity]].
+ * When [[capacity]] is exceeded, a new, bigger TypedArray is allocated and the contents of the previous array are copied over to it.
+ *
+ * Once you've finished adding elements, you can obtain the finished `TypedArray` via [[toTypedArray]].
+ * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], and [[Uint32ArrayBuilder]] to build specific types of arrays.
+ * @public
+ */
+export declare class TypedArrayBuilder<T extends Uint8Array | Uint16Array | Uint32Array> {
+    /** The constructor for the specific type of array being populated. */
+    protected readonly _constructor: Constructor<T>;
+    /** The underlying typed array, to be reallocated and copied when its capacity is exceeded. */
+    protected _data: T;
+    /** The number of elements added to the array so far. */
+    protected _length: number;
+    /** Multiplier applied to required capacity by [[ensureCapacity]]. */
+    readonly growthFactor: number;
+    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
+    protected constructor(constructor: Constructor<T>, options?: TypedArrayBuilderOptions);
+    /** The number of elements currently in the array. */
+    get length(): number;
+    /** The number of elements that can fit into the memory currently allocated for the array. */
+    get capacity(): number;
+    /** Like [TypedArray.at](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/at),
+     * returns the element at the specified index, with negative integers counting back from the end of the array.
+     * @note It is your responsibility to ensure the index falls within the bounds of the array.
+     */
+    at(index: number): number;
+    /** Ensure that [[capacity]] is at least equal to `newCapacity`.
+     * This is used internally by methods like [[push]] and [[append]] to ensure the array has room for the element(s) to be added.
+     * It can also be useful when you know you intend to add some number of additional elements, to minimize reallocations.
+     *
+     * If `newCapacity` is not greater than the current [[capacity]], this function does nothing.
+     * Otherwise, it allocates a new `TypedArray` with room for `newCapacity * growthFactor` elements, and copies the contents of the previous `TypedArray` into it.
+     * [[length]] remains unchanged; [[capacity]] reflects the size of the new TypeArray.
+     */
+    ensureCapacity(newCapacity: number): number;
+    /** Append the specified value, resizing if necessary. */
+    push(value: number): void;
+    /** Append an array of values, resizing (at most once) if necessary. */
+    append(values: T): void;
+    /** Obtain the finished array.
+     * @param includeUnusedCapacity If true, the length of the returned array will be equal to [[capacity]], with extra bytes initialized to zero; otherwise, the
+     * returned array's length will be equal to [[length]].
+     */
+    toTypedArray(includeUnusedCapacity?: boolean): T;
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).
+ * @public
+ */
+export declare class Uint8ArrayBuilder extends TypedArrayBuilder<Uint8Array> {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options?: TypedArrayBuilderOptions);
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).
+ * @public
+ */
+export declare class Uint16ArrayBuilder extends TypedArrayBuilder<Uint16Array> {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options?: TypedArrayBuilderOptions);
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).
+ * @public
+ */
+export declare class Uint32ArrayBuilder extends TypedArrayBuilder<Uint32Array> {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options?: TypedArrayBuilderOptions);
+    /** Obtain a view of the finished array as an array of bytes. */
+    toUint8Array(includeUnusedCapacity?: boolean): Uint8Array;
+}
+//# sourceMappingURL=TypedArrayBuilder.d.ts.map

package/lib/esm/TypedArrayBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypedArrayBuilder.d.ts","sourceRoot":"","sources":["../../src/TypedArrayBuilder.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,UAAU,GAAG,WAAW,GAAG,WAAW;IAC7E,sEAAsE;IACtE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChD,8FAA8F;IAC9F,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,SAAgB,YAAY,EAAE,MAAM,CAAC;IAErC,sFAAsF;IACtF,SAAS,aAAa,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,wBAAwB;IAOrF,qDAAqD;IACrD,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,6FAA6F;IAC7F,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;;OAGG;IACI,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAShC;;;;;;;OAOG;IACI,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAclD,yDAAyD;IAClD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMhC,uEAAuE;IAChE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI;IAO9B;;;OAGG;IACI,YAAY,CAAC,qBAAqB,UAAQ,GAAG,CAAC;CAStD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,iBAAiB,CAAC,UAAU,CAAC;IAClE,8CAA8C;gBAC3B,OAAO,CAAC,EAAE,wBAAwB;CAGtD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB,CAAC,WAAW,CAAC;IACpE,8CAA8C;gBAC3B,OAAO,CAAC,EAAE,wBAAwB;CAGtD;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,iBAAiB,CAAC,WAAW,CAAC;IACpE,8CAA8C;gBAC3B,OAAO,CAAC,EAAE,wBAAwB;IAIrD,gEAAgE;IACzD,YAAY,CAAC,qBAAqB,UAAQ,GAAG,UAAU;CAM/D"}

package/lib/esm/TypedArrayBuilder.js

@@ -0,0 +1,128 @@
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Collections
+ */
+import { assert } from "./Assert";
+/** Incrementally builds a [TypedArray] of unsigned 8-, 16-, or 32-bit integers.
+ * Sometimes you wish to populate a `TypedArray`, but you don't know how many elements you will need.
+ * `TypedArray` requires you to specify the size upon construction, and does not permit you to change the size later.
+ *
+ * `TypedArrayBuilder` manages a `TypedArray`, permitting you to [[push]] and [[append]] elements to it. It exposes two "size" properties":
+ *  - [[capacity]], the number of elements it has currently allocated space for - i.e., the length of the underlying TypedArray; and
+ *  - [[length]], the number of elements that have so far been added to it, which is never bigger than [[capacity]].
+ * When [[capacity]] is exceeded, a new, bigger TypedArray is allocated and the contents of the previous array are copied over to it.
+ *
+ * Once you've finished adding elements, you can obtain the finished `TypedArray` via [[toTypedArray]].
+ * @see [[Uint8ArrayBuilder]], [[Uint16ArrayBuilder]], and [[Uint32ArrayBuilder]] to build specific types of arrays.
+ * @public
+ */
+export class TypedArrayBuilder {
+    /** Constructs a new builder from the specified options, with a [[length]] of zero. */
+    constructor(constructor, options) {
+        var _a, _b;
+        this._constructor = constructor;
+        this._data = new constructor((_a = options === null || options === void 0 ? void 0 : options.initialCapacity) !== null && _a !== void 0 ? _a : 0);
+        this.growthFactor = Math.max(1.0, (_b = options === null || options === void 0 ? void 0 : options.growthFactor) !== null && _b !== void 0 ? _b : 1.5);
+        this._length = 0;
+    }
+    /** The number of elements currently in the array. */
+    get length() {
+        return this._length;
+    }
+    /** The number of elements that can fit into the memory currently allocated for the array. */
+    get capacity() {
+        return this._data.length;
+    }
+    /** Like [TypedArray.at](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/at),
+     * returns the element at the specified index, with negative integers counting back from the end of the array.
+     * @note It is your responsibility to ensure the index falls within the bounds of the array.
+     */
+    at(index) {
+        if (index < 0)
+            index = this.length - index;
+        const value = this._data[index];
+        assert(value !== undefined, "index out of bounds");
+        return value;
+    }
+    /** Ensure that [[capacity]] is at least equal to `newCapacity`.
+     * This is used internally by methods like [[push]] and [[append]] to ensure the array has room for the element(s) to be added.
+     * It can also be useful when you know you intend to add some number of additional elements, to minimize reallocations.
+     *
+     * If `newCapacity` is not greater than the current [[capacity]], this function does nothing.
+     * Otherwise, it allocates a new `TypedArray` with room for `newCapacity * growthFactor` elements, and copies the contents of the previous `TypedArray` into it.
+     * [[length]] remains unchanged; [[capacity]] reflects the size of the new TypeArray.
+     */
+    ensureCapacity(newCapacity) {
+        if (this.capacity >= newCapacity)
+            return this.capacity;
+        assert(this.growthFactor >= 1.0);
+        newCapacity = Math.ceil(newCapacity * this.growthFactor);
+        const prevData = this._data;
+        this._data = new this._constructor(newCapacity);
+        this._data.set(prevData, 0);
+        assert(this.capacity === newCapacity);
+        return this.capacity;
+    }
+    /** Append the specified value, resizing if necessary. */
+    push(value) {
+        this.ensureCapacity(this.length + 1);
+        this._data[this.length] = value;
+        ++this._length;
+    }
+    /** Append an array of values, resizing (at most once) if necessary. */
+    append(values) {
+        const newLength = this.length + values.length;
+        this.ensureCapacity(newLength);
+        this._data.set(values, this.length);
+        this._length = newLength;
+    }
+    /** Obtain the finished array.
+     * @param includeUnusedCapacity If true, the length of the returned array will be equal to [[capacity]], with extra bytes initialized to zero; otherwise, the
+     * returned array's length will be equal to [[length]].
+     */
+    toTypedArray(includeUnusedCapacity = false) {
+        if (includeUnusedCapacity)
+            return this._data;
+        const subarray = this._data.subarray(0, this.length);
+        assert(subarray instanceof this._constructor);
+        assert(subarray.buffer === this._data.buffer);
+        return subarray;
+    }
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint8Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array).
+ * @public
+ */
+export class Uint8ArrayBuilder extends TypedArrayBuilder {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options) {
+        super(Uint8Array, options);
+    }
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint16Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint16Array).
+ * @public
+ */
+export class Uint16ArrayBuilder extends TypedArrayBuilder {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options) {
+        super(Uint16Array, options);
+    }
+}
+/** A [[TypedArrayBuilder]] for producing a [Uint32Array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint32Array).
+ * @public
+ */
+export class Uint32ArrayBuilder extends TypedArrayBuilder {
+    /** @see [[TypedArrayBuilder]] constructor. */
+    constructor(options) {
+        super(Uint32Array, options);
+    }
+    /** Obtain a view of the finished array as an array of bytes. */
+    toUint8Array(includeUnusedCapacity = false) {
+        if (includeUnusedCapacity)
+            return new Uint8Array(this._data.buffer);
+        return new Uint8Array(this._data.buffer, 0, this.length * 4);
+    }
+}
+//# sourceMappingURL=TypedArrayBuilder.js.map